跳到主要内容

🛠 开发准备工作

emlog 支持模板主题和扩展插件,开发者可以开发个性化的模板主题以及功能插件,来丰富站点的功能和样式。

开发环境​

  • PHP 8.2 及以上
  • MySQL 5.6 及以上版本
  • 浏览器需适配:Chrome

配置开发环境​

  • Windows 系统:本地开发集成环境推荐:phpEnv
  • Mac 系统:推荐使用 docker-compose 方式启动开发环境

打包工具​

避免将隐藏文件打包,如:.git 等,推荐使用:

开启开发者模式​

后台 - 系统设置 - 开发/API 设置页面开启开发者模式

开发文档​

Agent Skill​

emlog 应用开发 Skill

上架规范​

通用规范​

  1. 应用必须适配 PHP 8.2,建议最低兼容 7.4
  2. 移植作品需遵守开源协议,严禁发布抄袭、仿制具有商业版权的主题模板或插件。
  3. 应用不得修改核心数据库表及字段,包括向核心表增加字段,更不能添加没有默认值的字段。
  4. 应用关闭或者删除后不得影响站点正常功能。
  5. 开启开发者模式,解决所有 warning 及 notice 报错。

模板审核规范​

  • 模板需要包含模板开发文档中提到的核心插件挂载点,详见:模板开发文档
  • 安装包内主题封面(preview.jpg)尺寸: 500 x 300px,且和发布在商店的封面图保持一致
  • 不审核板式重复的仿某某资源网主题

插件审核规范​

  • 插件设置界面输入框、按钮等样式要和后台界面风格保持风格一致、无明显页面错乱。
  • 插件不得影响后台的样式,不在左侧边栏等额外增加插件设置界面的菜单入口。
  • 避免简单模仿或聚合商店已有插件的功能
  • 不再审核新的后台美化插件
  • 避免直接操作 $_GET 和 $_POST 数组,采用核心的 Input 类来获取参数,详见:系统调用和通用函数
  • 避免使用文件来存储插件设置,使用系统提供的 Storage 类来存储插件设置,详见:插件开发文档
  • 安装包内插件图标(preview.jpg)尺寸: 75 x 75px

应用商店 - 封面图规范​

  • 模板封面图:尺寸 500x300,禁止包含任何宣传广告文字、边框装饰等,必须是内容填充完整的模板真实预览图。
  • 插件封面图:尺寸 500x300,禁止在封面上出现中文,包括直接大字体插件名称、高饱和度纯色背景、等简单粗暴的封面设计。

AI 生成插件封面图提示词推荐:

为插件:xxxxxxx 设计一款封面,要求: 1、扁平化设计风格,封面清爽干净,尽可能少的元素,避免元素过多, 2、不使用任何文字元素 3、不使用装饰图案和杂乱背景,用合适的图标作为主元素 4、尺寸: 500 x 300px

应用商店 - 应用介绍规范​

  • 使用 Markdown 格式,避免黏贴 HTML 代码
  • 图片上传最大 900KB,请事先压缩处理,推荐 webp 格式,演示截图不超过10张
  • 禁止在演示图上标注箭头、红字等额外信息提示,会让页面看起来脏乱。
  • 介绍内容简洁明了,拒绝AI生成的大段说明,避免使用emoji表情。
  • 不在应用介绍中出现:演示站、更新记录、兼容PHP版本、安装说明 (这些字段已经有对应展示,安装方式仅支持商店安装无需额外说明)

应用发布​

应用下架​

我们鼓励活跃的开发者,不断改进维护自己的应用,也会定期清理已经疏于维护的应用。

  • 超过2年未更新的收费应用可能会被下架
  • 用户反馈得不到及时回复 (24小时内) 的收费应用可能会被下架
  • 免费应用不对活跃情况做具体要求,但是如果问题很多不及时解决也会被下架。