插件管理

安装插件

两种方式安装插件：

1. 应用市场在线安装：后台「外观扩展 - 应用市场」搜索并一键安装；
2. 手动安装：把插件目录上传到 plugins/ 下，后台「插件管理」点击扫描即可发现新插件。

启用与禁用

插件列表中可随时启用 / 禁用。禁用不会删除文件与配置，重新启用后设置保留。只有已启用的插件会在系统引导时被加载（读取 plugin 表中 status = 1 的记录）。

插件设置

插件可在 plugin.json 的 default_settings 中声明自己的配置项，启用后可在后台直接修改，插件代码通过配置接口读取。

钩子管理

「外观扩展 - 钩子管理」是排查插件问题的利器：

• 查看钩子日志：记录每个钩子的触发时机与执行耗时；
• 测试钩子：手动触发指定钩子，验证插件监听是否生效；
• 清除钩子日志：清理历史日志。

卸载

先禁用插件，再在列表中删除（可选择是否保留插件数据表）。手动卸载可直接删除 plugins/ 目录后重新扫描。

常见问题

• 插件上传后扫描不到：确认目录名与 plugin.json 中的 slug 完全一致（小写字母/数字/下划线）；
• 启用后网站报错：插件 PHP 语法错误或依赖缺失，可先禁用恢复站点，再到钩子日志定位原因；
• 插件开发：参见插件开发指南。