emlog-app-devlisted

# Emlog 应用开发助手 (插件与主题) 此 Skill 旨在协助您开发 Emlog 应用，包括插件 (Plugin) 和主题 (Theme/Template)。它包含最新的开发规范、目录结构、接口文档及最佳实践。 ## 目录与文件查找指南 根据用户的开发目标，可以快速查阅以下更详细的参考文档： - **系统调用与通用函数**：[develop_func.md](./references/develop_func.md) (包含 Input/Output 类、数据存储、支付/AI 对接、用户/积分操作、全局函数等) - **插件开发完整规范**：[plugin.md](./references/plugin.md) (包含后台配置、钩子机制、数据库操作、回调等) - **主题开发完整规范**：[template.md](./references/template.md) (包含模板结构、变量列表、常用常量、公共页面调用等) --- ## 核心开发规范（通用） ### 1. 防止直接访问 所有 PHP 文件头部必须包含以下安全检查，防止被直接���行： - **插件代码** 头部： ```php defined('EMLOG_ROOT') || exit('access denied!'); ``` - **主题代码** 头部： ```php if(!defined('EMLOG_ROOT')) {exit('error!');} ``` ### 2. 环境兼容性 - 所有的 PHP 代码开发必须适配 PHP 7.4+ 版本，避免使用高版本专有且在 7.4 不支持的语法。 ### 3. 注意事项 - 避免过多的使用emoji表情，保持内容简洁明了 - 避免直接引用外部网络css、js、字体文件资源，需要时可以下载到应用内使用 - 避免使用过多字体文件导致安装包超过5MB，尽量控制在1MB左右 - 在UI配色上禁止使用紫色渐变、高饱和度的纯色艳丽配色。 - 尽量使用emlog自身支持的核心数据库表（如，点赞、评论、订单、用户等数据表），避免创建过多额外的数据库表。 --- ## Emlog 插件开发指南 ### 1. 目录结构 插件位于 `content/plugins/<plugin_alias>/` 目录下： - `<plugin_alias>.php`：核心主文件。包含插件元数据（Header）和钩子注册。 - `<plugin_alias>_callback.php`：生命周期回调。定义激活(`callback_init`)、更新(`callback_up`)、删除(`callback_rm`)时的逻辑。 - `<plugin_alias>_setting.php`：后台设置页。包含 `plugin_setting_view` 函数。 - `<plugin_alias>_show.php`：前台独立页面构建。 - `preview.jpg`：预览图（75x75 像素，JPG格式）。 ### 2. 命名规范与数据清理 - **插件别名**：只能包含小写字母、数字、下划线、横杠，且以字母开头。 - **函数命名**：必须使用插件别名作为前缀（如 `my_tool_func`），防止冲突。 - **绿色卸载**：严禁随意修改系统核心表；卸载时（`callback_rm`）务必清理所有自建数据（如使用 `Storage::getInstance('plugin_alias')->deleteAll