跳到主要内容
万能墙开放平台
开发者上手

不看网站源码,也能做出插件

插件 API 1.2.0:36 个扩展点、32 个平台函数、 21 条自检规则全部写进了「插件契约」,可以直接查询、生成与自检。 你只需要会一点 PHP。

开始开发

三步走:从零到一个能提交的插件

平台把「有哪些钩子、怎么写才对」做成了可查询的契约与工具,你不需要读万能墙源码。

1

生成起始包

一份能直接跑的骨架:清单、入口、生命周期、后台页、前台页、静态资源、README,全部带中文注释。

有服务器权限也可以用命令行:
php backend/plugin_new_cli.php my_plugin --name="我的插件" --caps=db,admin_ui
想省点事?下载 插件开发资料包(全部教程 + 手册 + 契约 + 骨架 + 示例,离线可查,也可交给你自己的 AI 助手)。
2

查扩展点

全部钩子(含参数、返回值、可复制示例)、能力清单、plugin.json 字段规范、SDK 函数与自检规则。

机器可读:GET https://wall.lhuiye.cn/api?action=plugin_contract&section=hooks
3

上传前自检

包结构、清单字段、能力声明、钩子名、禁用函数、资源扩展名一次过一遍;有问题当场指出规则编号。

本地也能跑:php backend/plugin_lint_cli.php backend/plugins/my_plugin
现成例子:官方示例插件 demo_toolkit 把设置项 / 自建表 / 接口 / 短代码 / 注入 / 后台页 / 前台页 / 定时任务都用了一遍, 可整目录复制当模板 —— 查看示例插件 · 下载 zip。

第 1 步 · 生成起始包

生成的是一个**可以直接跑**的插件目录:plugin.json(清单)、plugin.php(入口)、 lifecycle.php(安装/卸载)、views/(后台页与前台页)、assets/(静态资源)、 README.md,每一处都有中文注释和 TODO 标记。

方式 A:浏览器里生成(不需要服务器权限)

填插件标识、名字、需要的能力,点一下就下载 zip;解压后放到站点的 backend/plugins/ 目录,或在万能墙后台「插件管理 → 上传安装」。

方式 B:命令行生成

php backend/plugin_new_cli.php my_plugin \
  --name="我的插件" --author="你的名字" \
  --caps=db,admin_ui,front_ui --api --shortcode
生成完会**自动跑一次自检**,看到「错误 0」就说明骨架是干净的。
能力(capabilities)决定骨架里生成哪些示例:db 自建数据表 · files 文件与静态资源 · http 外部请求 · mail 发邮件 · admin_ui 后台页面 · front_ui 前台页面与注入。 详见扩展点全表。

第 2 步 · 查扩展点(契约)

钩子名、参数顺序、返回值、起始版本、示例代码,全部来自**平台自己生成的契约**, 所以不会出现「文档写了、平台没有」的情况。两种查法内容完全一样:

最长用的几个钩子

plugin_render_footer
页面注入区(</body> 之前):注入 JS、悬浮组件(灵动岛、客服按钮)
filter
$html, $payload
post_created
帖子发布成功(已过审核、已入库)。
action
$postId, $userId, $content
post_card_html
信息流里「单张帖子卡片」的 HTML(渲染完成后)。可以加徽章、加按钮、改样式。
filter
$html, $post, $comments
feed_posts
信息流接口返回的帖子数组(分页之后、编码之前)。可以加字段、按自定义规则重排。
filter
$posts, $ctx
post_publish_guard
发帖前的最后一道守卫:可以否决本次发布(例如自己实现更严格的规则、限制特定用户群)。
filter
$allow, $payload
api_response
所有 API 响应在 JSON 编码前触发。用来给响应统一加字段(如客户端要求的标记)、改写
filter
$data, $action

第 3 步 · 上传前自检

自检用的就是**提交审核的同一套规则**:过了自检,提交就不会再因为包本身的问题被拒。

方式 A:把 zip 传上来查(不需要服务器权限)

不保存你的包、不入库,按 IP 限流。

方式 B:在站点上自检(更全)

php backend/plugin_lint_cli.php backend/plugins/my_plugin   # 目录
php backend/plugin_lint_cli.php ~/my_plugin.zip              # 压缩包
装了插件以后,万能墙后台「插件管理」里每个插件右侧还有「自检」,跑的是同一套规则 (额外检查 PHP 语法、设置项声明、生命周期函数与资源文件是否存在)。

插件开发资料包(离线可查,也可以交给你自己的工具)

下载 插件开发资料包:里面是开放平台的**全部教程、注意事项、开发手册、机器可读契约、起始包与官方示例插件**。 你可以自己离线查阅照着手写;也可以把整个文件夹交给**你自己习惯的 AI 助手**当上下文,让它按规范产出可安装的插件。

说明:万能墙开放平台**不提供任何 AI 服务**,也不绑定任何 AI 厂商;资料包只负责把规范整理好,用不用工具、用哪个,由你决定。

参考这个资料包,帮我做一个万能墙插件:
标识 study_checkin,名字「自习打卡」,
功能:每天可打卡一次、显示本月打卡日历;
需要:自建表、后台统计页、前台页面、一个查询接口。
资料包里 ASSISTANT-BRIEF.md 是可选的一份"规则书"(可用钩子名单、必须遵守的约束、文件清单与交付要求), 要交给自己的 AI 助手时附上它即可;不用 AI 的话,看 plugin-dev-manual.md 与 example/demo_toolkit/ 也完全够。
包内教程19 章(另有合集)
开发手册钩子全表 + SDK 速查
机器可读契约plugin-contract.json
骨架与示例starter/ + example/demo_toolkit/

现成例子:照着抄最快

官方示例插件 demo_toolkit 是一个真实可用的小工具(条目录入 + 展示), 它把设置项、自建表、两个自定义接口、短代码、页脚注入(含静态资源)、后台页、前台页、 定时任务、核心事件全用了一遍,每一处都有注释。

用法:整目录复制 → 改 plugin.json 的 slug/name/capabilities → 改 plugin.php 里的逻辑 → 自检。

新手最容易踩的坑

钩子回调的附加参数必须给默认值
function ($html, $payload = [])
回调里不要 echo要输出就 return
echo 会污染 JSON 或页面结构
过滤器返回值必须 return
只 echo 不 return 会清空页面
入口文件的顶层变量用函数现算更稳
平台会提升为全局,但别依赖它
生命周期文件要自包含
安装时插件入口还没加载
数据表只用 pluginTableName()
不要直接写核心表
资源文件放 assets/ 并用 pluginAssetUrl()
其它目录不会被放行

准备好了就提交

注册开发者账号(需图形验证码 + 邮箱验证)→ 控制台提交 zip 与说明 → 站长审核 → 上架,全网的万能墙站点都能一键安装。 提交时平台会再跑一遍同样的检查,有提示会直接显示出来。

插件 API 版本1.2.0
扩展点36 个(含 6 个页面注入区)
平台函数32 个
自检规则21 条
契约版本1.0.0