开始

本篇介绍 Z-BlogPHP 应用开发的基本概念，包括插件与主题的区别、应用 ID 命名规范、创建应用的方法及开发模式的开启方式。

应用概念

插件

• 以功能性为主要目的；
• 按照既定规范组织文件和内容；
• 以统一的方式「安装/删除」「启用/关闭」；
• 可按照功能目的使用接口，也可以不用；「接口列表」
• 「自述文件」为 plugin.xml ；
• 插件放置目录为 zb_users/plugin ；

主题

• 用于定制 Z-Blog 前台界面，提供布局效果及样式；
• 按照既定规范组织文件和内容；
• 以统一的方式「安装/删除」「更换]，一般情况下只能使用一款主题；
• 可按需「内置」功能性效果；
• 「自述文件」为 theme.xml ；
• 主题放置目录为 zb_users/theme ；

通用规范

• 「应用目录名」应与「应用 ID」相同，系统也以此作为识别；（注 1）
• 对于 ID 命名的主体，全小写，首字母大写，驼峰式均可；
• 为避免重复及便于识别，可以增加标识前缀，使用 _ 与主体分隔；（注2）
• 对于「应用目录」下的全部子目录及文件，原则上建议全部小写；

注 1：「应用目录」及「自述文件」可按下方操作自动生成；

注 2： 应用 ID 在应用中心全局唯一，直接用功能名（如 botblock）容易撞车，撞车后无法上架。建议用「品牌/作者标识 + _ + 功能名」，如 qing_botblock、wdssmq_links。

创建应用

可进入「后台管理」界面，在 应用中心 插件中，通过点击 新建主题 或 新建插件 按钮创建应用；

会自动创建相应的文件夹及「自述文件」，并根据应用类型放入「初始文件」。

开发模式

开发主题或插件需要分别开启「应用中心插件」和「Z-Blog」的「开发模式」：

• 网站设置 → 全局设置 → 开发模式
  • 开启后会在程序出错时显示更详细的信息用于排查；
  • 对于线上环境，请勿长期开启此模式；
• 应用中心 → 设置 → 开发模式
  • 用以修改应用信息（「自述文件」）、导出应用或提交应用到「应用中心」；