🛠 准备工作
emlog支持模板主题 和扩展插件,开发者可以开发个性化的模板主题以及功能插件,来丰富emlog站点的功能和样式。
开发环境
配置开发环境
- Windows 系统:本地开发集成环境推荐:phpEnv
- Mac 系统:推荐使用 docker-compose 方式启动开发环境
其他工具
代码编辑器
AI问答工具
开发规范
开启开发者模式
在根目录 config.php 文件末尾追加一行配置,如下:
const ENVIRONMENT = 'develop';
配置后程序将输出更详细的报错信息,包括 warning 和 notice 级别的错误,方便调试完善代码。 请消灭所有 warning 和 notice 报错(大部分是未初始化的变量,或者未判断变量的异常情况引起的)。
开发文档
上架规范
通用规范
- 应用必须适配 PHP7.4 及 8.1 两个版本。
- 移植作品请注明原作者,未特别注明的均视为开发者原创,如有侵权行为开发者需要负相关责任。
- 应用不得修改核心数据库表及字段,包括向核心表增加字段,更不能添加没有默认值的字段。
- 应用关闭或者删除后不得影响站点正常功能。
- 开启开发者模式,解决所有 warning 及 notice 报错。
- 应用商店模板封面图:尺寸 500x300,禁止包含任何宣传广告文字、边框装饰等,仅内容填充完整的模板预览图即可。
- 应用商店插件封面图:尺寸 500x300,禁止直接大字体插件名称、纯色背景、等简单粗暴的封面设计,插件没有合适的封面可以留空、系统会使用默认封面。
模板审核规范
- 模板需要包含模板开发文档中提到的核心插件挂载点,详见:模板开发文档
- 安装包内主题封面(preview.jpg)尺寸: 500x300
插件审核规范
- 插件设置界要和emlog界面风格保持基本一致,无明显页面错乱,进入插件设置界面时左侧插件菜单保持高亮状态。
- 插件避免直接操作$_GET和$_POST 数组,采用核心的 Input 类来获取参数,详见:系统调用和通用函数
- 插件避免使用文件来存储插件设置,使用系统提供的 Storage 类来存储插件设置,详见:插件开发文档
- 安装包内插件图标(preview.jpg)尺寸: 75x75