> 后台用户管理页打开后，顶部子菜单区域除了系统自带的"新建用户"和"查看权限"，还想再加个自己的快捷入口？比如直接跳到某个自定义的用户导入页面，或者批量操作入口。Z-Blog 给每个管理页都留了子菜单接口，往里塞东西比你想的简单。

## 一、接口在哪触发

用户管理页由系统函数 `Admin_MemberMng()` 渲染，位于 `zb_system/function/c_system_admin.php`：

```php
/**
 * 后台用户管理.
 */
function Admin_MemberMng()
{
    global $zbp;

    echo '<div class="divHeader">' . $zbp->lang['msg']['member_manage'] . '</div>';
    echo '<div class="SubMenu">';
    foreach ($GLOBALS['hooks']['Filter_Plugin_Admin_MemberMng_SubMenu'] as $fpname => &$fpsignal) {
        $fpname();
    }
    echo '</div>';
    echo '<div id="divMain2">';
    // ... 用户列表表格 ...
}
```

关键就在 `<div class="SubMenu">` 和 `</div>` 之间——系统遍历 `Filter_Plugin_Admin_MemberMng_SubMenu` 注册的所有回调函数，依次执行。你的回调函数里 `echo` 什么，什么就出现在子菜单区域。

接口定义在 `zb_system/function/c_system_plugin.php`：

```php
'名称:Filter_Plugin_Admin_MemberMng_SubMenu
'参数:
'说明:用户管理
DefinePluginFilter('Filter_Plugin_Admin_MemberMng_SubMenu');
```

参数为空，不需要接收任何数据。输出方式是回调内直接 `echo`。

值得注意的一点：**系统自己也用了这个接口**。在 `zb_system/function/lib/zblogphp.php` 的 `LoadManage()` 方法里：

```php
public function LoadManage()
{
    Add_Filter_Plugin('Filter_Plugin_Admin_MemberMng_SubMenu', 'Include_Admin_Addmemsubmenu');
    // ... 其他管理页的内置子菜单注册 ...
}
```

系统的内置子菜单函数 `Include_Admin_Addmemsubmenu()` 位于 `zb_system/function/c_system_admin_function.php`：

```php
function Include_Admin_Addmemsubmenu()
{
    global $zbp;
    if ($zbp->CheckRights('MemberNew')) {
        echo MakeSubMenu($GLOBALS['lang']['msg']['new_member'], $zbp->cmdurl . '?act=MemberNew', 'm-left', null, null, null, 'icon-person-plus-fill');
    }
    echo MakeSubMenu($GLOBALS['lang']['msg']['view_rights'], $zbp->cmdurl . '?act=misc&amp;type=vrs', 'm-left', null, null, null, 'icon-person-check-fill');
}
```

系统自带了"新建用户"和"查看权限"两个子菜单项。你的插件注册的回调会和这个内置函数一起被调用，子菜单项会按注册顺序排列。这意味着你不需要替换系统功能，只需要追加自己的入口。

## 二、插件做了什么

zb_MemberMngMenu 的实现非常直接——注册一个回调，在子菜单区域 `echo` 一个"新建用户"链接：

```php
RegisterPlugin("zb_MemberMngMenu", "ActivePlugin_zb_MemberMngMenu");

function ActivePlugin_zb_MemberMngMenu()
{
    Add_Filter_Plugin('Filter_Plugin_Admin_MemberMng_SubMenu', 'zb_MemberMngMenu_SubMenu');
}

function zb_MemberMngMenu_SubMenu()
{
    global $zbp;
    echo MakeSubMenu('新建用户', $zbp->host . 'zb_system/cmd.php?act=MemberEdt', 'm-left', '');
}
```

核心就一个 `MakeSubMenu()` 调用。这个函数是 Z-Blog 的通用子菜单构造器，定义在 `zb_system/function/c_system_admin_function.php`：

```php
function MakeSubMenu($strName, $strUrl, $strClass = 'm-left', $strTarget = '', $strId = '', $strTitle = '', $strIconClass = '')
{
    $s = '<a href="' . $strUrl . '" ';
    if ($strTarget) {
        $s .= 'target="' . $strTarget . '"';
    }
    if ($strId) {
        $s .= 'id="' . $strId . '"';
    }
    if ($strTitle) {
        $s .= 'title="' . $strTitle . '" ' . 'alt="' . $strTitle . '" ';
    }
    $s .= '>';
    $strIconElem = $strIconClass !== "" ? "<i class=\"" . $strIconClass . "\" style=\"line-height: 1em;\"></i> " : "";
    $s .= '<span class="' . $strClass . '">' . $strIconElem . $strName . '</span></a>';

    return $s;
}
```

7 个参数，只有前两个必填：

| 参数 | 说明 | 本插件的值 |
|---|---|---|
| `$strName` | 菜单文字 | `'新建用户'` |
| `$strUrl` | 链接地址 | `cmd.php?act=MemberEdt` |
| `$strClass` | CSS 类名，控制左/右浮动 | `'m-left'` |
| `$strTarget` | 打开方式，`_blank` 新窗口 | `''`（当前窗口） |
| `$strId` | DOM id | `''` |
| `$strTitle` | 鼠标悬停提示 | `''` |
| `$strIconClass` | 图标 CSS 类 | `''` |

生成的 HTML 大致是：

```html
<a href="https://example.com/zb_system/cmd.php?act=MemberEdt"><span class="m-left">新建用户</span></a>
```

插件链接指向 `cmd.php?act=MemberEdt`，这是系统新建/编辑用户的入口。与系统内置的 `act=MemberNew` 的区别：`MemberNew` 会先检查 `MemberNew` 权限再显示表单，`MemberEdt` 不带 `id` 参数时直接显示空白编辑表单。两者最终展示的页面类似，但 `MemberEdt` 不做额外的权限检查。

## 三、实际怎么用

### 场景 1：带权限检查的子菜单入口

![image.png](https://developer.qcloudimg.com/http-save/yehe-12010127/3bbca89dea9b25732aa9bd08229abbe2.png)

系统内置的 `Include_Admin_Addmemsubmenu` 会检查 `MemberNew` 权限。如果你要加的入口涉及更高权限的操作（比如批量导入用户），应该自己做权限检查：

```php
function zb_MemberMngMenu_SubMenu()
{
    global $zbp;
    // 只有管理员能看到这个入口
    if ($zbp->CheckRights('MemberAll')) {
        echo MakeSubMenu('批量导入用户', 
            $zbp->host . 'zb_users/plugin/zb_MemberMngMenu/import.php', 
            'm-left', ''
        );
    }
    // 新建用户入口（所有有权限的用户可见）
    echo MakeSubMenu('新建用户', 
        $zbp->host . 'zb_system/cmd.php?act=MemberEdt', 
        'm-left', ''
    );
}
```

`CheckRights('MemberAll')` 检查的是"管理所有用户"的权限，只有管理员级别才有。这样普通编辑者看不到批量导入入口，但能看到新建用户。

### 场景 2：加图标和悬停提示

MakeSubMenu 支持图标和提示文字。Z-Blog 后台用的是内置图标字体，可以通过 `$strIconClass` 参数指定：

```php
function zb_MemberMngMenu_SubMenu()
{
    global $zbp;
    
    // 带图标的"新建用户"
    echo MakeSubMenu(
        '新建用户',
        $zbp->host . 'zb_system/cmd.php?act=MemberEdt',
        'm-left',
        '',
        '',
        '点击创建新用户',
        'icon-person-plus-fill'
    );
    
    // 带图标的"用户统计"
    echo MakeSubMenu(
        '用户统计',
        $zbp->host . 'zb_users/plugin/zb_MemberMngMenu/stats.php',
        'm-left',
        '',
        '',
        '查看用户活跃度统计',
        'icon-bar-chart-fill'
    );
}
```

生成的 HTML 会包含 `<i class="icon-person-plus-fill">` 图标元素。Z-Blog 常用的图标类名包括 `icon-person-plus-fill`（加人）、`icon-person-check-fill`（权限）、`icon-gear-fill`（设置）、`icon-trash-fill`（删除）等，定义在后台的 CSS 图标字体里。

### 场景 3：把子菜单项放到右侧

默认 `m-left` 让菜单项靠左排列。如果你想让某些入口靠右（比如"危险操作"类的），用 `m-right`：

```php
function zb_MemberMngMenu_SubMenu()
{
    global $zbp;
    
    // 左侧：常规入口
    echo MakeSubMenu('新建用户', 
        $zbp->host . 'zb_system/cmd.php?act=MemberEdt', 
        'm-left', ''
    );
    
    // 右侧：清空操作（带确认）
    $confirmUrl = 'javascript:window.confirm("确定清空所有非管理员用户的登录失败记录？") && (window.location.href="' 
        . BuildSafeCmdURL('act=misc&type=clearloginfail') . '");';
    echo MakeSubMenu(
        '清空失败记录',
        $confirmUrl,
        'm-right',
        '',
        '',
        '清空所有用户的登录失败计数',
        'icon-trash-fill'
    );
}
```

`m-right` 类让菜单项浮动到右侧，和左侧的入口视觉上分开。`BuildSafeCmdURL` 会自动加上 `csrfToken` 参数，防止 CSRF 攻击。JavaScript 的 `window.confirm` 在点击时弹出确认框，用户确认后才跳转执行。

## 四、注意点

**1. 你的子菜单和系统内置的会同时出现**

系统在 `LoadManage()` 里注册了 `Include_Admin_Addmemsubmenu`，它已经添加了"新建用户"和"查看权限"两个入口。你的插件注册的回调会在系统内置函数之后执行（插件在 `LoadManage` 之后才注册），所以你的入口会排在系统入口后面。如果你不想出现重复的"新建用户"，要么改个名字（比如"快速创建用户"），要么用不同的 `act` 参数。

**2. 链接地址要加 csrfToken 的场景**

直接跳转到展示页面（如 `act=MemberEdt`）不需要 csrfToken。但如果链接涉及写操作（保存、删除等），用 `BuildSafeCmdURL()` 构造 URL，否则 Z-Blog 会拒绝请求。例如：

```php
// 正确：展示页面，不需要 token
$url = $zbp->host . 'zb_system/cmd.php?act=MemberEdt';

// 正确：执行操作，需要 token
$url = BuildSafeCmdURL('act=MemberDel&id=5');

// 错误：执行操作但没加 token，会被系统拦截
$url = $zbp->host . 'zb_system/cmd.php?act=MemberDel&id=5';
```

**3. `$zbp->host` 和 `$zbp->cmdurl` 的区别**

`$zbp->host` 是网站根地址（如 `https://example.com/`），`$zbp->cmdurl` 是 `cmd.php` 的基础地址（如 `https://example.com/zb_system/cmd.php`）。本插件用 `$zbp->host . 'zb_system/cmd.php?act=MemberEdt'` 拼接，和系统内置的 `$zbp->cmdurl . '?act=MemberNew'` 效果一样，但写法不同。建议统一用 `$zbp->cmdurl` 更简洁。如果链接到插件自己的页面，用 `$zbp->host . 'zb_users/plugin/插件名/文件.php'`。

## 五、代码仓库

**仓库地址**：https://cnb.cool/ytecn/zblog-interfaces
**插件目录**：`zb_MemberMngMenu/`

---

「Z-Blog 接口插件集」系列第 11 个插件。

后台用户管理页打开后，顶部子菜单区域除了系统自带的"新建用户"和"查看权限"，还想再加个自己的快捷入口？比如直接跳到某个自定义的用户导入页面，或者批量操作入口。Z-Blog 给每个管理页都留了子菜单接口，往里塞东西比你想的简单。

用户管理页子菜单的打开方式，挂载新建用户快捷入口

前端

本文详解Z-Blog后台用户管理页子菜单扩展方法，通过Filter_Plugin_Admin_MemberMng_SubMenu接口自定义快捷入口。提供完整PHP代码示例，包含权限检查、图标添加、菜单左右布局等实用技巧，并给出URL构建与csrfToken安全注意事项。

代码解释

JavaScript

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

用户管理页子菜单的打开方式，挂载新建用户快捷入口-腾讯云开发者社区-腾讯云

用户管理页子菜单的打开方式，挂载新建用户快捷入口

用户管理页子菜单的打开方式，挂载新建用户快捷入口

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐