示例插件 · 问候卡片 精选 v1.0.1
插件开发入门示例:钩子、过滤器、短代码、API 接口、后台页与前台页一次看全。
作者 辉夜 · 286 次下载
· 13 次浏览
· 更新于 2026-10-06
示例入门短代码
插件说明
这是什么
一个教学用示例插件,把插件平台的能力全部演示了一遍,适合照着改成自己的功能。
包含
- 过滤器:给帖子卡片加一枚问候徽章
- 渲染注入:页面底部注入一行提示(可在设置里关掉)
- 导航注入:前台导航多一个「问候」入口
- 短代码:
[hello name="同学"] - API 接口:
api?action=hello_ping - 后台页面:插件管理 → 插件页
- 前台页面:
plugin.php?p=hello_world&view=index
适合谁
刚接触万能墙插件体系的开发者。看完它的源码就知道一个插件要写什么。
能力与权限
插件能做什么由 plugin.json 里的 capabilities 声明决定:只有声明过的能力才被放行,
越权调用会被核心拒绝。整体风险:低风险
后台页面 低风险
admin_uiregisterAdminPage() 在后台「插件」分组下加一个管理页;不声明会被平台拒绝注册。
前台页面与钩子注入 低风险
front_uiregisterFrontView() 提供前台页面,addShortcode() 提供短代码,或用 plugin_render_* 过滤器往页面注入 HTML(含个人中心/设置页槽位)。
数据收集范围
开发者未声明数据收集范围。
安装前必读
- 备份数据库与
backend/:先备份站点数据库,以及整个backend/目录(含已有插件与配置),确认可以回滚再动手。 - 先在测试站验证:在测试环境安装并启用,走一遍前后台主要页面与插件功能,确认没有报错、没有异常外发请求,再上生产站。
- 核对 SHA-256:一键安装会自动校验,不一致会直接拒绝;手动安装请比对
122409104b6bf30c8617cc32fd168382c13bcab47342eb2886aee29008fec80c(见下方版本历史)。 - 观察期:启用后留意后台日志与站点速度;插件回调出错只记日志并计入熔断,不会拖垮整站,但异常频繁时会被自动停用。
安装方式
方式一:后台一键安装(推荐)
万能墙后台 →「插件管理」→「插件市场」→ 搜索 hello_world → 点「一键安装」。
后台会从本站下载 zip、核对 SHA-256、解压到 backend/plugins/,最后点「启用」即可。
方式二:手动安装
- 下载 zip 并解压,得到
hello_world/目录(内含plugin.json与plugin.php); - 把整个目录放到站点
backend/plugins/下; - 后台「插件管理」里点「启用」,再按需配置设置项。
方式三:核对哈希后安装
curl -sO https://liuwall.lhuiye.cn/download.php?slug=hello_world&version=1.0.1
shasum -a 256 hello_world-1.0.1.zip
一键安装会自动校验 SHA-256,不一致会直接拒绝安装,不需要你手动核对。