为什么有这一页
下面全部内容由万能墙核心的插件契约数据直接生成(契约版本 1.0.0,插件 API 1.2.0)。
任何时候想核对最新清单,请求 GET https://wall.lhuiye.cn/api?action=plugin_contract 即可(公开只读,不用账号、不用源码)。
> 插件 API 保证向后兼容:已发布的扩展点不会改名、不会删除;新增能力只会加新函数/新钩子。
能力(plugin.json 的 capabilities)
| 能力 | 说明 | 风险 |
| --- | --- | --- |
| db | 用 pluginCreateTable() / pluginTableName() 建表读写。表名固定带 plugin_<slug>_ 前缀,不会碰核心表。 | low |
| files | 用 pluginUploadDir() 存上传文件、用 pluginAssetUrl() 暴露自己的 assets/ 目录(只读白名单)。 | medium |
| http | 用 pluginHttp() 请求站外接口(有超时与体积上限)。自己写 curl 也能跑,但自检会提示且不受平台超时/体积保护。 | medium |
| mail | 调用 sendEmailTracked() 走站点已配置的发件通道(会记入发件台账、失败自动入队重试)。 | high |
| admin_ui | registerAdminPage() 在后台「插件」分组下加一个管理页;不声明会被平台拒绝注册。 | low |
| front_ui | registerFrontView() 提供前台页面,addShortcode() 提供短代码,或用 plugin_render_* 过滤器往页面注入 HTML(含个人中心/设置页槽位)。 | low |
清单里必须声明才会放行;用了却没声明,自检会给出 CAP_MISSING 警告,平台也可能直接拒绝注册。
动作 action(addAction —— 做副作用)
| 钩子 | 参数 | 起始版本 | 说明 |
| --- | --- | --- | --- |
| admin_action | $keys, $page, $adminId, $post | 1.0.0 | 后台任意 POST 提交后触发(参数是本次提交里被平台识别的动作键)。插件自己的后台表单可以只靠这个钩子处理,不必改核心。 |
| admin_identity_linked | $userId, $adminId | 2.3.2 | 前台账号在个人中心完成「管理员身份」验证并与管理员账号绑定(一次验证,长期免重复验证)。 |
| admin_identity_unlinked | $userId | 2.3.2 | 前台账号解除了「管理员身份」绑定。 |
| agreements_renewed | $userId | 1.2.0 | 用户完成「协议版本更新后的重新确认」时触发(站长改了协议/隐私政策版本,用户点确认后)。适合做留档、发通知、给已完成补签的用户发放奖励等。 |
| api_action_done | $action | 1.0.0 | 接口处理完成、响应即将输出时触发。 |
| api_before_action | $action | 1.0.0 | 通过安全中间件(方法/CSRF/鉴权/限流)之后、真正分发到接口实现之前触发。 |
| api_request | $action, $method | 1.0.0 | 任意 API 请求进入时最先触发(早于方法/CSRF/鉴权/限流)。适合做统计、审计、黑名单前置拦截。 |
| comment_created | $commentId, $postId, $userId | 1.0.0 | 评论发布成功。 |
| content_published | $info | 2.3.1 | 任意「用户产出内容」发布成功后统一广播(发帖 / 评论 / 趣事 / 必吃 / 豪王 / 集市 / 校草校花 / 反馈 / 聊天消息)。适合做积分、通知、埋点与审核后置标记;与 post_created / comment_created 等旧钩子并存,旧钩子保持兼容。 |
| feedback_replied | $info | 2.3.1 | 管理员回复一条用户反馈之后触发(回复已写库、已标记处理)。适合给提交者补发站内通知或做客服统计。 |
| plugin_loaded | $slug | 1.0.0 | 某个已启用的插件被加载完成。适合做「我的插件依赖别人」时的握手。 |
| plugin_settings_saved | $slug, $settings | 1.0.0 | 插件设置保存成功后触发(后台表单或 pluginSaveSettings() 都会触发)。 |
| post_created | $postId, $userId, $content | 1.0.0 | 帖子发布成功(已过审核、已入库)。 |
| post_deleted | $postId, $byId, $byType | 1.0.0 | 帖子被删除(进入回收站,可恢复)。 |
| post_purged | $postId | 1.0.0 | 帖子被彻底删除(含关联数据清理)。插件若要清理自己的关联数据,在这里做。 |
| post_restored | $postId | 1.0.0 | 帖子从回收站恢复。 |
| user_registered | $userId, $username | 1.0.0 | 新用户注册成功(此时邮箱可能还没验证)。适合发欢迎通知、初始化积分。 |
过滤器 filter(addFilter —— 改数据,必须 return)
| 钩子 | 参数 | 起始版本 | 说明 |
| --- | --- | --- | --- |
| api_response | $data, $action | 1.0.0 | 所有 API 响应在 JSON 编码前触发。用来给响应统一加字段(如客户端要求的标记)、改写文案。 |
| api_unknown_action | $result, $action | 1.0.0 | 接口名不存在、即将返回「未知接口」时触发。返回非 null 即可自行接管该请求(插件自定义路由的兜底入口)。 |
| comment_publish_guard | $allow, $payload | 1.0.0 | 评论发布前的守卫,语义与 post_publish_guard 一致。 |
| contact_email | $email | 1.2.1 | 全站公示的站长联系邮箱(关于页 / 反馈页 / 隐私政策 / 用户协议 / 帮助页等)。插件可替换成客服邮箱或按模块返回不同邮箱。 |
| content_pipeline | $payload, $ctx | 2.3.1 | 所有「用户产出内容」发布前的统一管线:发帖、帖子评论、趣事与趣事评论、必吃与店铺评价、豪王投稿、校园集市、校草校花投稿、用户反馈、聊天室消息都先经过这里。插件可改写正文/媒体、追加 meta,或直接拦截发布。管线在核心的敏感词、AI 审核与写库之前执行,被拦截的内容不写库、也不消耗 AI 审核次数。 |
| feed_posts | $posts, $ctx | 1.0.0 | 信息流接口返回的帖子数组(分页之后、编码之前)。可以加字段、按自定义规则重排。 |
| moderation_verdict | $verdict, $content, $scene, $userId | 1.0.0 | 内容审核结论(本地规则 + AI 之后)。可以覆盖放行/拦截。 |
| moderation_words | $words | 1.0.0 | AI/本地审核使用的关键词线索表。可以追加自己维护的词。 |
| music_page_html | $html | 1.0.0 | 音乐库页面的主体 HTML 注入点。 |
| music_player_html | $html | 1.0.0 | 全站音乐播放器的 HTML 注入点(无音乐模块时也有,返回空串即不显示)。 |
| nav_extra | $html, $page | 1.0.0 | 前台导航栏右侧的注入区(返回一段 HTML)。 |
| plugin_render_body_top | $html, $payload | 1.0.0 | 页面注入区(<body> 之后立刻):注入横幅、全局提示条 |
| plugin_render_footer | $html, $payload | 1.0.0 | 页面注入区(</body> 之前):注入 JS、悬浮组件(灵动岛、客服按钮) |
| plugin_render_head | $html, $payload | 1.0.0 | 页面注入区(</head> 之前):注入 CSS、meta、统计脚本 |
| plugin_render_nav_extra | $html, $payload | 1.0.0 | 页面注入区(导航栏右侧):加入口按钮 |
| plugin_render_profile_cards | $html, $payload | 1.0.0 | 页面注入区(个人中心「个人信息 / 统计数据」之后、其它卡片之间(仅本人可见;is_self=false 时不渲染)):插入插件自己的资料卡 / 字段;回调里用 pluginUserMetaGet/Set 读写当前用户的值 |
| plugin_render_settings_cards | $html, $payload | 1.0.0 | 页面注入区(设置页 .card 列表中间(仅登录用户渲染)):插入插件设置卡片;回调里用 pluginUserMetaGet/Set 读写当前用户的值 |
| post_card_html | $html, $post, $comments | 1.0.0 | 信息流里「单张帖子卡片」的 HTML(渲染完成后)。可以加徽章、加按钮、改样式。 |
| post_publish_guard | $allow, $payload | 1.0.0 | 发帖前的最后一道守卫:可以否决本次发布(例如自己实现更严格的规则、限制特定用户群)。 |
每个钩子的完整说明与示例
admin_action
- 类型:动作(无返回值)
- 参数:
$keys, $page, $adminId, $post - 起始版本:1.0.0
- 说明:后台任意 POST 提交后触发(参数是本次提交里被平台识别的动作键)。插件自己的后台表单可以只靠这个钩子处理,不必改核心。
- 注意:务必自己校验管理员身份:if (!adminLoggedIn()) return;
php
addAction('admin_action', function ($keys, $page, $adminId, $post) {
if (($post['my_plugin_action'] ?? '') === 'reset') {
pluginResetSettings('my_plugin');
}
});admin_identity_linked
- 类型:动作(无返回值)
- 参数:
$userId, $adminId - 起始版本:2.3.2
- 说明:前台账号在个人中心完成「管理员身份」验证并与管理员账号绑定(一次验证,长期免重复验证)。
php
addAction('admin_identity_linked', function ($userId, $adminId) {
pluginLog('my_plugin', 'info', '账号 #' . (int)$userId . ' 绑定了管理员 #' . (int)$adminId);
});admin_identity_unlinked
- 类型:动作(无返回值)
- 参数:
$userId - 起始版本:2.3.2
- 说明:前台账号解除了「管理员身份」绑定。
php
addAction('admin_identity_unlinked', function ($userId) {
pluginLog('my_plugin', 'info', '账号 #' . (int)$userId . ' 解除了管理员身份绑定');
});agreements_renewed
- 类型:动作(无返回值)
- 参数:
$userId - 起始版本:1.2.0
- 说明:用户完成「协议版本更新后的重新确认」时触发(站长改了协议/隐私政策版本,用户点确认后)。适合做留档、发通知、给已完成补签的用户发放奖励等。
- 注意:此时签名已写库,不要在这里再写一次;本钩子在用户请求内触发,别做耗时操作。
php
addAction('agreements_renewed', function ($userId) {
pluginLog('my_plugin', 'info', "用户 {$userId} 已完成协议重新确认");
});api_action_done
- 类型:动作(无返回值)
- 参数:
$action - 起始版本:1.0.0
- 说明:接口处理完成、响应即将输出时触发。
php
addAction('api_action_done', function ($action) { /* 埋点 */ });api_before_action
- 类型:动作(无返回值)
- 参数:
$action - 起始版本:1.0.0
- 说明:通过安全中间件(方法/CSRF/鉴权/限流)之后、真正分发到接口实现之前触发。
php
addAction('api_before_action', function ($action) {
if ($action === 'create_post') { /* 例如记账 */ }
});api_request
- 类型:动作(无返回值)
- 参数:
$action, $method - 起始版本:1.0.0
- 说明:任意 API 请求进入时最先触发(早于方法/CSRF/鉴权/限流)。适合做统计、审计、黑名单前置拦截。
- 注意:此时不要输出任何内容(会污染 JSON 响应),也不要在这里做重活。
php
addAction('api_request', function ($action, $method) {
pluginLog('my_plugin', 'info', "收到 {$method} {$action}");
});api_response
- 类型:过滤器(必须 return 值)
- 参数:
$data, $action - 传入值:响应数组(含 success / code / data 等)
- 返回值:array:必须返回数组;返回非数组会被平台忽略(当作没有插件介入)。
- 起始版本:1.0.0
- 说明:所有 API 响应在 JSON 编码前触发。用来给响应统一加字段(如客户端要求的标记)、改写文案。
php
addFilter('api_response', function ($data, $action) {
if ($action === 'get_posts') $data['plugin_by'] = 'my_plugin';
return $data;
}, 20);api_unknown_action
- 类型:过滤器(必须 return 值)
- 参数:
$result, $action - 传入值:当前结果,初始为 null
- 返回值:array|null:返回数组即作为响应(会被包成统一响应体);返回 null 表示继续走「未知接口」错误。
- 起始版本:1.0.0
- 说明:接口名不存在、即将返回「未知接口」时触发。返回非 null 即可自行接管该请求(插件自定义路由的兜底入口)。
- 注意:推荐还是用 registerApiRoute() 注册接口,平台会自动处理鉴权、方法校验与接口文档。
php
addFilter('api_unknown_action', function ($result, $action) {
return $result; // 一般不用手写,registerApiRoute() 更省事
}, 10);comment_created
- 类型:动作(无返回值)
- 参数:
$commentId, $postId, $userId - 起始版本:1.0.0
- 说明:评论发布成功。
php
addAction('comment_created', function ($commentId, $postId, $userId) { /* ... */ });comment_publish_guard
- 类型:过滤器(必须 return 值)
- 参数:
$allow, $payload - 传入值:初始为 true
- 返回值:false 或 [allow=>false, error=>原因] 拒绝;其余放行。
- 起始版本:1.0.0
- 说明:评论发布前的守卫,语义与 post_publish_guard 一致。
php
addFilter('comment_publish_guard', function ($allow, $payload) { return $allow; });contact_email
- 类型:过滤器(必须 return 值)
- 参数:
$email - 传入值:当前配置的邮箱(CONTACT_EMAIL)
- 返回值:string:合法邮箱地址;返回空字符串表示不公示联系方式。
- 起始版本:1.2.1
- 说明:全站公示的站长联系邮箱(关于页 / 反馈页 / 隐私政策 / 用户协议 / 帮助页等)。插件可替换成客服邮箱或按模块返回不同邮箱。
php
addFilter('contact_email', function ($email) {
return 'support@example.com';
});content_pipeline
- 类型:过滤器(必须 return 值)
- 参数:
$payload, $ctx - 传入值:统一内容载荷:type(post / post_comment / event / event_comment / food / food_comment / hero / listing / contest_entry / feedback / chat_message)、content(正文)、media(媒体数组)、meta(自定义数据)、action(create / update)
- 返回值:array:返回改写后的 payload(结构保持不变)。特殊键:payload['__block'] 为非空字符串即中止发布,该字符串作为错误文案返回(HTTP 层 success=false、code=CONTENT_BLOCKED);payload['__force_review']=true 即标记待人工审核(响应带 review_required:true,能落的入口同时置隐藏状态)。
- 起始版本:2.3.1
- 说明:所有「用户产出内容」发布前的统一管线:发帖、帖子评论、趣事与趣事评论、必吃与店铺评价、豪王投稿、校园集市、校草校花投稿、用户反馈、聊天室消息都先经过这里。插件可改写正文/媒体、追加 meta,或直接拦截发布。管线在核心的敏感词、AI 审核与写库之前执行,被拦截的内容不写库、也不消耗 AI 审核次数。
- 注意:请在敏感词/AI 审核前完成判断(核心已把管线放在最前面)。多个插件串联时尊重上游结论:已是 __block 就直接返回,不要再放行;改写 content 后核心会用改写结果继续审核与入库,长度上限仍由各入口自己兜底。
php
addFilter('content_pipeline', function ($payload, $ctx) {
// 敏感词改写 + 拦截 + 标记人工审核
$payload['content'] = str_replace('敏感词', '**', (string)$payload['content']);
if (mb_strpos((string)$payload['content'], '广告') !== false) {
$payload['__block'] = '内容包含广告,已拦截';
}
$payload['meta']['pipeline_by'] = 'my_plugin';
if ($payload['type'] === 'post' && (int)$ctx['user_id'] > 0 && (int)$ctx['user_id'] % 10 === 1) {
$payload['__force_review'] = true; // 例如:抽样送人工审核
}
return $payload;
}, 10);content_published
- 类型:动作(无返回值)
- 参数:
$info - 起始版本:2.3.1
- 说明:任意「用户产出内容」发布成功后统一广播(发帖 / 评论 / 趣事 / 必吃 / 豪王 / 集市 / 校草校花 / 反馈 / 聊天消息)。适合做积分、通知、埋点与审核后置标记;与 post_created / comment_created 等旧钩子并存,旧钩子保持兼容。
- 注意:此时内容已入库;发布前的改写与拦截请用 content_pipeline 过滤器。
php
addAction('content_published', function ($info) {
if ($info['type'] === 'post') {
pluginSaveSettings('my_plugin', ['last_post_id' => (int)$info['id']]);
}
if (!empty($info['meta']['review_required'])) {
pluginLog('my_plugin', 'info', '待人工审核内容 #' . (int)$info['id']);
}
});feed_posts
- 类型:过滤器(必须 return 值)
- 参数:
$posts, $ctx - 传入值:帖子数组
- 返回值:array:返回帖子数组。
- 起始版本:1.0.0
- 说明:信息流接口返回的帖子数组(分页之后、编码之前)。可以加字段、按自定义规则重排。
php
addFilter('feed_posts', function ($posts, $ctx) {
foreach ($posts as &$p) { $p['my_mark'] = '1'; }
return $posts;
});feedback_replied
- 类型:动作(无返回值)
- 参数:
$info - 起始版本:2.3.1
- 说明:管理员回复一条用户反馈之后触发(回复已写库、已标记处理)。适合给提交者补发站内通知或做客服统计。
- 注意:邮件通知由核心按用户开关处理;插件在这里只做补充动作,避免重复发信。
php
addAction('feedback_replied', function ($info) {
if ((int)$info['feedback_id'] > 0) {
pluginLog('my_plugin', 'info', '反馈 #' . (int)$info['feedback_id'] . ' 已回复');
}
});moderation_verdict
- 类型:过滤器(必须 return 值)
- 参数:
$verdict, $content, $scene, $userId - 传入值:结论数组,常见键:allowed(bool) / reason(string) / source
- 返回值:array:审核结论(保持结构)。
- 起始版本:1.0.0
- 说明:内容审核结论(本地规则 + AI 之后)。可以覆盖放行/拦截。
php
addFilter('moderation_verdict', function ($verdict, $content, $scene, $userId) {
if (mb_strpos($content, '白名单词') !== false) { $verdict['allowed'] = true; $verdict['reason'] = ''; }
return $verdict;
});moderation_words
- 类型:过滤器(必须 return 值)
- 参数:
$words - 传入值:关键词数组
- 返回值:array:关键词数组。
- 起始版本:1.0.0
- 说明:AI/本地审核使用的关键词线索表。可以追加自己维护的词。
php
addFilter('moderation_words', function ($words) {
$words[] = '自定义违禁词';
return $words;
});music_page_html
- 类型:过滤器(必须 return 值)
- 参数:
$html - 传入值:页面 HTML
- 返回值:string。
- 起始版本:1.0.0
- 说明:音乐库页面的主体 HTML 注入点。
php
addFilter('music_page_html', function ($html) { return $html; });music_player_html
- 类型:过滤器(必须 return 值)
- 参数:
$html - 传入值:播放器 HTML
- 返回值:string。
- 起始版本:1.0.0
- 说明:全站音乐播放器的 HTML 注入点(无音乐模块时也有,返回空串即不显示)。
php
addFilter('music_player_html', function ($html) { return $html; });nav_extra
- 类型:过滤器(必须 return 值)
- 参数:
$html, $page - 传入值:当前注入内容(初始为空串)
- 返回值:string:追加的 HTML。
- 起始版本:1.0.0
- 说明:前台导航栏右侧的注入区(返回一段 HTML)。
php
addFilter('nav_extra', function ($html, $page) {
return $html . '<a class="nav-link" href="plugin.php?p=my_plugin">我的功能</a>';
});plugin_loaded
- 类型:动作(无返回值)
- 参数:
$slug - 起始版本:1.0.0
- 说明:某个已启用的插件被加载完成。适合做「我的插件依赖别人」时的握手。
php
addAction('plugin_loaded', function ($slug) {
if ($slug === 'daily_signin') { /* 对方已就绪 */ }
});plugin_render_body_top
- 类型:过滤器(必须 return 值)
- 参数:
$html, $payload - 传入值:当前注入内容(初始为空串)
- 返回值:string:追加的 HTML。
- 起始版本:1.0.0
- 说明:页面注入区(<body> 之后立刻):注入横幅、全局提示条
- 注意:附加参数($payload)一定要给默认值:不同调用点传参个数可能不同。
php
addFilter('plugin_render_body_top', function ($html, $payload = []) {
return $html . '<!-- 我的注入 -->';
}, 20);plugin_render_footer
- 类型:过滤器(必须 return 值)
- 参数:
$html, $payload - 传入值:当前注入内容(初始为空串)
- 返回值:string:追加的 HTML。
- 起始版本:1.0.0
- 说明:页面注入区(</body> 之前):注入 JS、悬浮组件(灵动岛、客服按钮)
- 注意:附加参数($payload)一定要给默认值:不同调用点传参个数可能不同。
php
addFilter('plugin_render_footer', function ($html, $payload = []) {
return $html . '<!-- 我的注入 -->';
}, 20);plugin_render_head
- 类型:过滤器(必须 return 值)
- 参数:
$html, $payload - 传入值:当前注入内容(初始为空串)
- 返回值:string:追加的 HTML。
- 起始版本:1.0.0
- 说明:页面注入区(</head> 之前):注入 CSS、meta、统计脚本
- 注意:附加参数($payload)一定要给默认值:不同调用点传参个数可能不同。
php
addFilter('plugin_render_head', function ($html, $payload = []) {
return $html . '<!-- 我的注入 -->';
}, 20);plugin_render_nav_extra
- 类型:过滤器(必须 return 值)
- 参数:
$html, $payload - 传入值:当前注入内容(初始为空串)
- 返回值:string:追加的 HTML。
- 起始版本:1.0.0
- 说明:页面注入区(导航栏右侧):加入口按钮
- 注意:附加参数($payload)一定要给默认值:不同调用点传参个数可能不同。
php
addFilter('plugin_render_nav_extra', function ($html, $payload = []) {
return $html . '<!-- 我的注入 -->';
}, 20);plugin_render_profile_cards
- 类型:过滤器(必须 return 值)
- 参数:
$html, $payload - 传入值:当前注入内容(初始为空串)
- 返回值:string:追加的 HTML。
- 起始版本:1.0.0
- 说明:页面注入区(个人中心「个人信息 / 统计数据」之后、其它卡片之间(仅本人可见;is_self=false 时不渲染)):插入插件自己的资料卡 / 字段;回调里用 pluginUserMetaGet/Set 读写当前用户的值
- 注意:附加参数($payload)一定要给默认值:不同调用点传参个数可能不同。
php
addFilter('plugin_render_profile_cards', function ($html, $payload = []) {
return $html . '<!-- 我的注入 -->';
}, 20);plugin_render_settings_cards
- 类型:过滤器(必须 return 值)
- 参数:
$html, $payload - 传入值:当前注入内容(初始为空串)
- 返回值:string:追加的 HTML。
- 起始版本:1.0.0
- 说明:页面注入区(设置页 .card 列表中间(仅登录用户渲染)):插入插件设置卡片;回调里用 pluginUserMetaGet/Set 读写当前用户的值
- 注意:附加参数($payload)一定要给默认值:不同调用点传参个数可能不同。
php
addFilter('plugin_render_settings_cards', function ($html, $payload = []) {
return $html . '<!-- 我的注入 -->';
}, 20);plugin_settings_saved
- 类型:动作(无返回值)
- 参数:
$slug, $settings - 起始版本:1.0.0
- 说明:插件设置保存成功后触发(后台表单或 pluginSaveSettings() 都会触发)。
php
addAction('plugin_settings_saved', function ($slug, $settings) { /* 清理缓存 */ });post_card_html
- 类型:过滤器(必须 return 值)
- 参数:
$html, $post, $comments - 传入值:卡片 HTML
- 返回值:string:必须返回字符串。
- 起始版本:1.0.0
- 说明:信息流里「单张帖子卡片」的 HTML(渲染完成后)。可以加徽章、加按钮、改样式。
- 注意:找注入点时用宽松匹配(class 属性里可能还有别的类名),别用 str_replace 替换整段结构。
php
addFilter('post_card_html', function ($html, $post, $comments) {
return $html . '<span class="my-badge">已看</span>';
}, 20);post_created
- 类型:动作(无返回值)
- 参数:
$postId, $userId, $content - 起始版本:1.0.0
- 说明:帖子发布成功(已过审核、已入库)。
php
addAction('post_created', function ($postId, $userId, $content) {
// 例如:命中关键词就给作者加分
});post_deleted
- 类型:动作(无返回值)
- 参数:
$postId, $byId, $byType - 起始版本:1.0.0
- 说明:帖子被删除(进入回收站,可恢复)。
php
addAction('post_deleted', function ($postId, $byId, $byType) { /* ... */ });post_publish_guard
- 类型:过滤器(必须 return 值)
- 参数:
$allow, $payload - 传入值:初始为 true(放行)
- 返回值:返回 false,或 ['allow' => false, 'error' => '给用户看的原因'] 即拒绝发布;返回 true / 原值表示放行。
- 起始版本:1.0.0
- 说明:发帖前的最后一道守卫:可以否决本次发布(例如自己实现更严格的规则、限制特定用户群)。
- 注意:多个插件串联时请尊重上游结论:已经是 false/拒绝 就直接返回它,别改回放行。
php
addFilter('post_publish_guard', function ($allow, $payload) {
if (pluginSetting('my_plugin', 'block_links') === '1'
&& preg_match('#https?://#i', (string)$payload['content'])) {
return ['allow' => false, 'error' => '本站暂不允许发布外链'];
}
return $allow;
});post_purged
- 类型:动作(无返回值)
- 参数:
$postId - 起始版本:1.0.0
- 说明:帖子被彻底删除(含关联数据清理)。插件若要清理自己的关联数据,在这里做。
php
addAction('post_purged', function ($postId) {
$db = getDB();
$db->prepare('DELETE FROM ' . pluginTableName('my_plugin', 'marks') . ' WHERE post_id = ?')->execute([$postId]);
});post_restored
- 类型:动作(无返回值)
- 参数:
$postId - 起始版本:1.0.0
- 说明:帖子从回收站恢复。
php
addAction('post_restored', function ($postId) { /* ... */ });user_registered
- 类型:动作(无返回值)
- 参数:
$userId, $username - 起始版本:1.0.0
- 说明:新用户注册成功(此时邮箱可能还没验证)。适合发欢迎通知、初始化积分。
php
addAction('user_registered', function ($userId, $username) {
pluginSaveSettings('my_plugin', ['last_user' => $userId]);
});