Z-Blog Wiki Z-Blog Wiki

Z-Blog官方文档

用户工具

站点工具


zblogphp:development:theme:std

Z-BlogPHP 主题包格式说明

1.主题发布的必备条件

  1. 主题名称的英文ID, 与其它现有主题不重名.
  2. 主题信息文件, theme.xml, 内含主题发布信息.
  3. 主题截图文件, screenshot.png, 300*240像素, 横向.

2.主题目录文件结构

主题目录, 名称为主题的英文ID, 位于zb_users/theme/目录下. 此目录中有如下文件或文件夹

  • 必需:
    1. 文件: theme.xml, 主题信息.
    2. 文件: screenshot.png, 主题截图.
    3. 目录: style, 样式目录, 内存样式表及所需图片.
  • 可选:
    1. 目录: template, 模板目录, 存放模板文件.
    2. 文件:include.php,主题插件引用
    3. 文件:main.php,主题插件管理页面

:!:注:主题目录下的compile文件夹为主题激活后编译的模板文件目录,在制作主题时不必建立,在生成后若非基于测试目的也请不要修改。

3.theme.xml格式规范说明

应用中心插件提供了theme.xml文档的编辑器, 不太了解XML的用户可以通过此编辑器生成标准的主题信息文档。该插件同时还提供了与在线安装包版本匹配的打包器, 以备需求。

样例文档

theme.xml

<?xml version="1.0" encoding="utf-8"?>
<theme version="php">
<id>default</id>
<name>默认主题</name>
<url>http://www.rainbowsoft.org/</url>
<note>Z-Blog的默认主题</note>
<description>Z-Blog的默认主题.模板由zx制作,娇娇设计.新增了Table日历的支持.</description>
<path></path>
<include></include>
<level>1</level>
<author>
  <name>zx.asd</name>
  <email>rainbowsoft@gmail.com</email>
  <url>http://www.zdevo.com/</url>
</author>
<source>
  <name>jiaojiao</name>
  <email>luheou@126.com</email>
  <url>http://imjiao.com/</url>
</source>
<adapted>130707</adapted>
<version>1.2</version>
<pubdate>2013-07-07</pubdate>
<modified>2013-09-02</modified>
<price>0</price>
<advanced>
  <dependency></dependency>
  <rewritefunctions></rewritefunctions>
  <conflict></conflict>
</advanced>
<sidebars>
  <sidebar1></sidebar1>
  <sidebar2></sidebar2>
  <sidebar3></sidebar3>
  <sidebar4></sidebar4>
  <sidebar5></sidebar5>
</sidebars>
</theme>

节点说明

  1. theme, 表示此文档为主题信息, 其属性version表示此文档格式的版本号.
  2. id, 主题ID, 即存放该主题的目录名.
  3. name, 主题名称, 中英文均可.
  4. url, 发布主题的网页地址.
  5. note, 主题简介.
  6. description, 主题详细说明, 可用HTML, 但不必用换行标签.
  7. path, 自带插件首页文件 (如 main.php,文件应直接放置在主题目录下).
  8. include, 自带插件包含文件 (如 include.php,文件应直接放置在主题目录下).
  9. level, 插件访问权限 ( “1” 为管理员, “2” 为高级用户, 以此类推…).
  10. author, 主题作者.
    1. name, 作者名称.
    2. url, 作者网址.
    3. email, 作者电邮.
  11. source, 主题原作者
    1. name, 原作者名称.
    2. url, 原作者网址.
    3. email, 原作者电邮.
  12. version, 主题自身的版本号.
  13. adapted, 适用该主题的博客版本.
  14. pubdate, 主题的发布目期.
  15. modified, 主题的最后修改日期.
  16. price,为0表示免费。收费插件定价,可在应用中心直接购买
  17. advanced,高级选项
    1. dependency,依赖插件列表,该插件如果需要其它插件配合使用,应在这里填写准确的依赖插件ID列表,以“|”符号分隔,如“demo1|demo2|demo3”。
    2. rewritefunctions,系统函数重写列表,主题插件如果要重写系统函数,应在这里填写准确的原函数名列表,以“|”符号分隔。
    3. conflict,冲突插件列表,该主题如果跟某些插件存在冲突,应在这里填写准确的存在冲突插件ID列表,以“|”符号分隔。
  18. sidebars,主题内置侧栏配置
    1. sidebar1,侧栏1,该主题如果需要确定侧栏配置,应在这里填写准确的模块ID列表,以“|”符号分隔,如“searchpanel|comments|archives|link”。
    2. sidebar2,侧栏2,配置方法同上
    3. sidebar3,侧栏3,配置方法同上
    4. sidebar4,侧栏4,配置方法同上
    5. sidebar5,侧栏5,配置方法同上

4.官方对主题的认证

若要在应用中心提交主题,须先在论坛中申请开发者账号,通过开发者账号可在自己的Z-BlogPHP网站主题管理页面上传主题。上传主题需要符合一定条件才可通过审核:

  1. 认证的原则是:用户无需修改代码即可正常应用该主题.
  2. 认证的一般要求如下:
    1. 主题所用全部文件位于同一主题目录下.
    2. 主题目录规范. 信息齐全(必须有ScreenShot.png和Theme.xml).
    3. 主题中需显示用户的博客名称等, 此类名称不应以图片替代.
    4. 应用的图片不能带有过强的个人色彩, 如专为个人设计的Banner等.
    5. 模板中不含有和主题作者相关的第三方代码, 如广告, 统计等.

更多细节请参考Z-Blog应用中心 应用审核规范

zblogphp/development/theme/std.txt · 最后更改: 2017/03/03 09:43 由 yszm