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

后台管理页

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

注册一个后台页

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() 读。只有需要复杂交互(上传、列表、批量操作)时才自己写页面。