Z-BlogPHP 开发文档:从零开始
应用概念
插件
-
以功能性为主要目的;
-
按照既定规范组织文件和内容;
-
以统一的方式「安装/删除」「启用/关闭」;
-
可按照功能目的使用接口,也可以不用;「接口列表」
-
「自述文件」为
plugin.xml
; -
插件放置目录为
zb_users/plugin
;
主题
-
用于定制 Z-Blog 前台界面,提供布局效果及样式;
-
按照既定规范组织文件和内容;
-
以统一的方式「安装/删除」「更换],一般情况下只能使用一款主题;
-
可按需「内置」功能性效果;
-
「自述文件」为
theme.xml
; -
主题放置目录为
zb_users/theme
;
通用规范
-
「应用目录名」应与「应用 ID」相同,系统也以此作为识别;(注 1)
-
对于 ID 命名的主体,全小写,首字母大写,驼峰式均可;
-
为避免重复及便于识别,可以增加标识前缀,使用
_
与主体分隔; -
对于「应用目录」下的全部子目录及文件,原则上建议全部小写;
注 1:「应用目录」及「自述文件」可按下方操作自动生成;
创建应用
可进入「后台管理」界面,在 应用中心
插件中,通过点击 新建主题
或 新建插件
按钮创建应用;
会自动创建相应的文件夹及「自述文件」,并根据应用类型放入「初始文件」。
开发模式
开发主题或插件需要分别开启「应用中心插件」和「Z-Blog」的「开发模式」:
-
网站设置
→全局设置
→开发模式
-
开启后会在程序出错时显示更详细的信息用于排查;
-
对于线上环境,请勿长期开启此模式;
-
应用中心
→设置
→开发模式
-
用以修改应用信息(「自述文件」)、导出应用或提交应用到「应用中心」;