> 刚上手?先看开始开发页(start.php):把三步走、示例插件与常见坑放在一页里。
> 想要离线资料:下载 插件开发资料包(kit.php)—— 全部教程 + 开发手册 + 机器可读契约 + 骨架 + 示例插件(也可交给你自己的 AI 助手)。
一、先生成一份能跑的骨架
不用从空文件开始,也不用看万能墙源码。三种方式任选:
① 浏览器里下载起始包(最省事)
打开万能墙的 起始包生成器,填插件标识、名字、需要的能力,
点一下就下载 你的插件标识.zip(里面已经是一个可运行插件)。
② 命令行生成(有服务器权限时)
bash
php backend/plugin_new_cli.php my_plugin --name="我的插件" --author="你的名字" --caps=db,admin_ui,front_ui --api --shortcode --cron生成完会自动跑一遍自检,输出「通过」即可直接启用。
③ 抄官方示例插件
backend/plugins/demo_toolkit/ 是官方示例:设置项、自建表、自定义接口、短代码、页脚注入(含静态资源)、
后台页、前台页、定时任务、核心事件全都用了一遍,每处都有中文注释。整目录复制、改 slug 就是你的插件。
二、骨架里有什么
| 文件 | 作用 |
| --- | --- |
| plugin.json | 清单:标识/版本/能力/设置项/钩子/生命周期声明 |
| plugin.php | 入口:注册钩子、接口、页面、短代码、定时任务(只有注册逻辑) |
| lifecycle.php | 安装/卸载钩子:建表、初始化数据、清理 |
| views/admin.inc.php | 后台管理页模板 |
| views/front.inc.php | 前台页面模板 |
| assets/app.css / app.js | 插件静态资源(由平台的 plugin_asset.php 输出) |
| README.md | 说明文档(审核会看) |
三、改之前先知道有哪些钩子和函数
两种查法,内容完全一样(都来自平台契约,插件 API 1.2.0):
1. 本站的「扩展点全表(由核心契约生成)」章节;
2. 公开接口:GET https://wall.lhuiye.cn/api?action=plugin_contract(§ion=hooks / §ion=sdk 可只取一节)。
四、上传前一定先自检
bash
php backend/plugin_lint_cli.php backend/plugins/my_plugin # 目录
php backend/plugin_lint_cli.php ~/my_plugin.zip # 压缩包
php backend/plugin_lint_cli.php backend/plugins/my_plugin --strict # 警告也算失败自检会告诉你:
- 清单字段缺什么、能力有没有拼错、版本号格式对不对(
MANIFEST_FIELD/CAP_UNKNOWN/VERSION_FORMAT); - 钩子名是不是写错了(
HOOK_UNKNOWN,还会提示「是不是想写 xxx」); - 用了哪项能力却没声明(
CAP_MISSING)、读了没声明的设置项(SETTING_UNDECLARED); - 引用的
assets/文件是否存在、扩展名是否放行(ASSET_MISSING/ASSET_EXT); - 有没有用被禁止的函数、有没有碰核心表或配置文件(
FORBIDDEN_CALL/TOUCH_CORE/READ_ENV)。
装到站点以后,后台「插件」列表里每个插件右侧也有「自检」,看的是同一套规则。
五、遇到问题
先看「常见问题」章节;实在解决不了,把自检输出粘到插件说明里提交,审核会直接告诉你缺什么。