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格式规范说明
应用中心插件提供了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>
节点说明
- 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表示免费。收费插件定价,可在应用中心直接购买
- 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等.
- 模板中不含有和主题作者相关的第三方代码, 如广告, 统计等.