当前位置:首页 > php学习 > 正文

Z-BlogPHP主题教程(二)ZBlogPHP主题包格式说明

1.Z-BlogPHP主题发布的必备条件

主题名称的英文ID, 与其它现有主题不重名.

主题信息文件, theme.xml, 内含主题发布信息.

主题截图文件, screenshot.png, 300*240像素, 横向.


2.主题目录文件结构

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

必需:

文件: theme.xml, 主题信息.

文件: screenshot.png, 主题截图.

目录: style, 样式目录, 内存样式表及所需图片.

可选:

目录: template, 模板目录, 存放模板文件.

文件:include.php,主题插件引用

文件:main.php,主题插件管理页面


3.theme.xml格式规范说明

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

样例文档

theme.xml

<?xml version="1.0" encoding="utf-8"?>
<theme version="php">
<id>default</id>
<name>默认主题</name>
<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等.

模板中不含有和主题作者相关的第三方代码, 如广告, 统计等.

更新时间 2021-07-31