跳到主要内容
万能墙开放平台
插件市场 / 社区互动 / 示例插件 · 问候卡片
👋

示例插件 · 问候卡片 精选 v1.0.1

插件开发入门示例:钩子、过滤器、短代码、API 接口、后台页与前台页一次看全。

作者 辉夜 · 286 次下载 · 13 次浏览 · 更新于 2026-10-06
示例入门短代码

环境与能力

核心版本要求>=1.0.0
PHP 要求>=7.4
依赖其它插件无
设置项2 项
监听钩子3 个
admin_ui · 后台页面 front_ui · 前台页面与钩子注入
用到:post_card_html plugin_render_footer plugin_render_nav_extra

安装前你该知道

插件只在自己的目录里运行,通过平台提供的钩子与接口扩展功能: 回调出错不会拖垮站点(只记日志并计入熔断),停用即失效、卸载即清理它自己的数据。

插件说明

这是什么

一个教学用示例插件,把插件平台的能力全部演示了一遍,适合照着改成自己的功能。

包含

  • 过滤器:给帖子卡片加一枚问候徽章
  • 渲染注入:页面底部注入一行提示(可在设置里关掉)
  • 导航注入:前台导航多一个「问候」入口
  • 短代码:[hello name="同学"]
  • API 接口:api?action=hello_ping
  • 后台页面:插件管理 → 插件页
  • 前台页面:plugin.php?p=hello_world&view=index

适合谁

刚接触万能墙插件体系的开发者。看完它的源码就知道一个插件要写什么。

能力与权限

插件能做什么由 plugin.json 里的 capabilities 声明决定:只有声明过的能力才被放行, 越权调用会被核心拒绝。整体风险:低风险

后台页面 低风险 admin_ui
registerAdminPage() 在后台「插件」分组下加一个管理页;不声明会被平台拒绝注册。
前台页面与钩子注入 低风险 front_ui
registerFrontView() 提供前台页面,addShortcode() 提供短代码,或用 plugin_render_* 过滤器往页面注入 HTML(含个人中心/设置页槽位)。

数据收集范围

开发者未声明数据收集范围。

安装前必读

  1. 备份数据库与 backend/:先备份站点数据库,以及整个 backend/ 目录(含已有插件与配置),确认可以回滚再动手。
  2. 先在测试站验证:在测试环境安装并启用,走一遍前后台主要页面与插件功能,确认没有报错、没有异常外发请求,再上生产站。
  3. 核对 SHA-256:一键安装会自动校验,不一致会直接拒绝;手动安装请比对 122409104b6bf30c8617cc32fd168382c13bcab47342eb2886aee29008fec80c(见下方版本历史)。
  4. 观察期:启用后留意后台日志与站点速度;插件回调出错只记日志并计入熔断,不会拖垮整站,但异常频繁时会被自动停用。

安装方式

方式一:后台一键安装(推荐)

万能墙后台 →「插件管理」→「插件市场」→ 搜索 hello_world → 点「一键安装」。 后台会从本站下载 zip、核对 SHA-256、解压到 backend/plugins/,最后点「启用」即可。

方式二:手动安装

  1. 下载 zip 并解压,得到 hello_world/ 目录(内含 plugin.json 与 plugin.php);
  2. 把整个目录放到站点 backend/plugins/ 下;
  3. 后台「插件管理」里点「启用」,再按需配置设置项。

方式三:核对哈希后安装

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,不一致会直接拒绝安装,不需要你手动核对。

版本历史(2)

v1.0.1 · 2026-09-21 · 3.2 KB · 260 次下载
下载

首个公开版本。

SHA-256:122409104b6bf30c8617cc32fd168382c13bcab47342eb2886aee29008fec80c
v1.0.0 · 2026-09-21 · 3.1 KB · 26 次下载
下载

首个公开版本。

SHA-256:11a11d5425ef651329c88a59335879592ce89a75175555e0e45199bc7e842bf9