注册一个后台页
php
registerAdminPage('my_plugin', [
'title' => '我的插件设置',
'icon' => 'fa-puzzle-piece',
'perm' => 'config', // config | posts | users | bans | chat | court | coins | contest | announcements | api_log
'desc' => '管理插件的数据与开关',
], function ($ctx) {
$rows = $ctx['db']->query('SELECT * FROM ' . pluginTableName('my_plugin', 'logs') . ' ORDER BY id DESC LIMIT 20')->fetchAll();
echo '<div class="card" style="padding:18px">';
echo '<h3>最近记录</h3><ul>';
foreach ($rows as $r) {
echo '<li>' . htmlspecialchars((string)$r['content'], ENT_QUOTES, 'UTF-8') . '</li>';
}
echo '</ul></div>';
});注册后页面出现在 后台 → 插件管理 → 你的插件(admin.php?page=plugins&plugin=<slug>),
权限不足的管理员看不到入口。
处理后台表单
后台的 POST 会先广播 admin_action 钩子,插件在这里处理自己的动作并自行校验权限:
php
addAction('admin_action', function ($keys, $page, $adminId, $post) {
if (!isset($post['my_plugin_save'])) return;
// 1) 权限:与注册后台页时声明的 perm 保持一致
if (!function_exists('adminMeetsRequirement')) return;
// 2) 只读模式 / 简单校验后写库
pluginSaveSettings('my_plugin', ['text' => trim((string)($post['text'] ?? ''))]);
pluginLog('my_plugin', 'info', "管理员 #{$adminId} 更新了设置");
header('Location: admin.php?page=plugins&plugin=my_plugin&saved=1');
exit;
});表单里记得带核心的 CSRF 令牌(后台页面用 csrfField(),或让表单经过后台统一的 POST 中间件)。
设置项:不用自己写表单
plugin.json 里声明了 settings,插件管理页会自动渲染表单并保存到 plugin_settings,
你只需要用 pluginSetting() 读。只有需要复杂交互(上传、列表、批量操作)时才自己写页面。