======Z-BlogPHP 主题包格式说明======


=====1.主题发布的必备条件=====

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



=====2.主题目录文件结构=====
主题目录, 名称为主题的英文ID, 位于zb_users/theme/目录下. 此目录中有如下文件或文件夹 
  * **必需：**
     - 文件: theme.xml, 主题信息. 
     - 文件: screenshot.png, 主题截图.
     - 目录: style, 样式目录, 内存样式表及所需图片. 
  * **可选：**
     - 目录: template, 模板目录, 存放模板文件. 
     - 文件：include.php，主题插件引用
     - 文件：main.php，主题插件管理页面

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


=====3.theme.xml格式规范说明=====
<note>**[[http://app.zblogcn.com/?id=231|应用中心]]**插件提供了theme.xml文档的编辑器, 不太了解XML的用户可以通过此编辑器生成标准的主题信息文档。该插件同时还提供了与在线安装包版本匹配的打包器, 以备需求。</note>

==== 样例文档 ====
<code 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>
</code>



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






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

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

更多细节请参考[[appcenter:auditstandard]]