跳到主要内容
万能墙开放平台
插件开发教程

脚手架与自检:不写样板、上传前先自查

全部内容基于万能墙真实的插件平台(清单 + 钩子 + 接口 + 后台页 + 数据 + 定时任务),示例可直接复制运行。

> 刚上手?先看开始开发页(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(&section=hooks / &section=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)。

装到站点以后,后台「插件」列表里每个插件右侧也有「自检」,看的是同一套规则。

五、遇到问题

先看「常见问题」章节;实在解决不了,把自检输出粘到插件说明里提交,审核会直接告诉你缺什么。