> 每次改导航栏、改友情链接、新建页面，都要从仪表盘绕到左侧栏翻半天插件列表才找到入口。就为了改几个链接或加一篇新页，四次点击外加一次鼠标长途奔袭。仪表盘明明是进后台的第一屏，却只有统计信息没有常用操作入口。zb_DashboardShortcuts 解决的就是这个别扭：在仪表盘顶部子菜单区加上"导航栏""友情链接""新建页面"三个直达入口，进后台第一眼就能点。

![image.png](https://developer.qcloudimg.com/http-save/yehe-12010127/8ae0fdafea7b566e5169528b4b060013.png)
## 一、接口在哪触发

zb_DashboardShortcuts 挂的是 `Filter_Plugin_Admin_SiteInfo_SubMenu` 接口。先解释名字：`SiteInfo` 是仪表盘页面对应的系统模块名（后台首页显示站点信息统计的那个页面），`SubMenu` 是 zblogphp 后台管理页的通用结构——每个管理页面在正文上方都有一条子菜单栏，用来放当前页面相关的快捷操作。

接口签名：

- **参数**：无
- **触发位置**：后台首页（仪表盘，`act=SiteInfo`）子菜单区域组装时
- **输出方式**：回调内直接 `echo`

和前面讲过的 `Admin_Header`、`Admin_Footer` 一样，这也是一个"输出时机型"接口：不给你数组去修改，不给你对象去处理，就在页面渲染到子菜单区域的那一刻让你往页面里 echo 内容。

子菜单项的构造同样有官方函数：

```php
MakeSubMenu($strName, $strUrl, $strClass, $strTarget)
```

四个参数：

| 参数 | 说明 |
|---|---|
| `$strName` | 菜单显示名称 |
| `$strUrl` | 链接地址 |
| `$strClass` | CSS 类名，`m-left` 靠左、`m-right` 靠右 |
| `$strTarget` | target，留空当前窗口、`_blank` 新窗口 |

函数返回一段拼好的 `<li>` HTML 字符串，`echo` 它的返回值即可。`m-left` 和 `m-right` 两个类控制菜单项在子菜单栏中的对齐：日常操作入口用 `m-left` 和系统默认项排在一起，辅助信息（帮助链接、外部文档）可以用 `m-right` 推到栏的最右侧。系统自带页面（文章管理页的"新增文章"、评论管理页的筛选下拉）都是这个体系的一部分，所以插件加出来的菜单项和系统原生项外观完全一致。

还有一个隐含特性值得注意：Z-Blog 后台每个管理页对应一个独立的 SubMenu 接口——`Admin_ArticleMng_SubMenu`、`Admin_PageMng_SubMenu`、`Admin_CommentMng_SubMenu` 等等，后面几讲会逐个用到。`Admin_SiteInfo_SubMenu` 是其中的仪表盘版本，本讲先拿它开刀，顺便把 `MakeSubMenu` 这个通用工具讲透。

## 二、插件做了什么

核心函数用数组组织三个入口，循环输出：

```php
function zb_DashboardShortcuts_SubMenu()
{
    global $zbp;
    $array = array();
    $array[] = array('导航栏', $zbp->host . 'zb_users/plugin/LinksManage/main.php?edit=navbar', 'm-left', '');
    $array[] = array('友情链接', $zbp->host . 'zb_users/plugin/LinksManage/main.php?edit=link', 'm-left', '');
    $array[] = array('新建页面', $zbp->host . 'zb_system/cmd.php?act=PageEdt', 'm-left', '');
    foreach ($array as list($name, $url, $class, $target)) {
        echo MakeSubMenu($name, $url, $class, $target);
    }
}
```

实现思路可以拆成三句话：

**第一句：链接全部指向真实页面。** "导航栏"和"友情链接"都指向 LinksManage 插件的编辑页，分别用 `?edit=navbar` 和 `?edit=link` 区分；"新建页面"是系统 `cmd.php?act=PageEdt` 格式。用 `$zbp->host` 拼接而不是写死域名，插件在任何站点部署（换域名、上 HTTPS、子目录安装）都能正确工作。这是 Z-Blog 插件拼站内 URL 的标准姿势。

**第二句：用数组组织数据，foreach 分离数据与渲染。** 三个入口每项四元组（名称、链接、类名、target），`foreach ($array as list($name, $url, $class, $target))` 里用了 PHP 的 `list()` 解构赋值，每循环一项把四元组拆进四个变量再传给 `MakeSubMenu`。这种写法的好处是扩展零成本：想加第四个入口"分类管理"，加一行 `$array[] = array(...)` 就完事，渲染逻辑一个字不用动。

**第三句：echo MakeSubMenu 的返回值。** `MakeSubMenu` 返回字符串不直接输出（和 `MakeTopMenu`、`MakeLeftMenu` 一致的 API 设计），所以需要显式 echo。子菜单接口是输出时机型接口，你的回调 echo 了什么、页面子菜单栏就多出什么。

安装卸载函数都是空的，因为这个插件纯注入不落任何配置。启用即在仪表盘生效，禁用即消失，卸载不留垃圾。

## 三、实际怎么用

### 场景 1：改导航和友情链接少跑三步路

启用插件后登录后台，仪表盘顶部子菜单出现"导航栏""友情链接""新建页面"三项。日常最高频的动线变成：登录，落仪表盘，直接点"导航栏"或"友情链接"，两步变一步。对需要频繁调整导航结构和友情链接的站长来说，每天省下的那几下鼠标移动看着不起眼，一年积累下来就是实打实的操作摩擦减少。而且三个入口都用 `m-left` 与系统项并列，视觉上和后台原生菜单浑然一体，不会像"外挂控件"那样突兀。

### 场景 2：把入口换成你自己的高频动线

三个默认入口不一定适合所有人。数据站博主的高频操作可能是"模块管理"和"标签管理"，摄影博主可能是"上传管理"。改造只需替换数组内容：

```php
$array = array();
$array[] = array('导航栏', $zbp->host . 'zb_users/plugin/LinksManage/main.php?edit=navbar', 'm-left', '');
$array[] = array('模块管理', $zbp->host . 'zb_system/cmd.php?act=ModuleMng', 'm-left', '');
$array[] = array('标签管理', $zbp->host . 'zb_system/cmd.php?act=TagMng', 'm-left', '');
$array[] = array('官方维基', 'https://wiki.zblogcn.com/', 'm-right', '_blank');
foreach ($array as list($name, $url, $class, $target)) {
    echo MakeSubMenu($name, $url, $class, $target);
}
```

注意第四项的用法差异：外部链接用 `m-right` 推到子菜单栏最右、`_blank` 新窗口打开——站内功能靠左、外部资源靠右开新窗，这是一套可以直接沿用的子菜单布局语义。系统支持的 act 列表可以查阅官方文档或翻 `cmd.php`，常用的还有 `CategoryMng`（分类）、`MemberMng`（用户）、`UploadMng`（附件）、`PluginMng`（插件）、`SettingMng`（系统设置）。插件页链接格式一般是 `zb_users/plugin/插件名/main.php`，带编辑参数时在后面追加 `?edit=xxx`。

### 场景 3：结合配置做成可定制快捷栏

照搬 zb_SidebarBookmarks 的配置思路，把入口列表存进插件配置，管理页用 textarea 编辑，格式`名称|act动作、插件页路径或完整链接`：

```php
function myplugin_SubMenu()
{
    global $zbp;
    $items = explode("\n", (string) $zbp->Config('myplugin')->items);
    foreach ($items as $line) {
        $line = trim($line);
        if ($line === '' || strpos($line, '|') === false) continue;
        list($name, $url) = array_map('trim', explode('|', $line, 2));
        if ($name === '' || $url === '') continue;
        // 以 http 开头视为外链，以 zb_users/plugin 开头视为插件页，其余视为 act 动作名
        if (stripos($url, 'http') === 0) {
            // 外链原样使用
        } elseif (stripos($url, 'zb_users/plugin') === 0) {
            $url = $zbp->host . $url;
        } else {
            $url = $zbp->host . 'zb_system/cmd.php?act=' . rawurlencode($url);
        }
        echo MakeSubMenu($name, $url, 'm-left', '');
    }
}
```

配置写起来非常轻：

```
导航栏|zb_users/plugin/LinksManage/main.php?edit=navbar
友情链接|zb_users/plugin/LinksManage/main.php?edit=link
官方论坛|https://bbs.zblogcn.com/
```

站内 act、插件页路径和站外 URL 三种写法混用，站内简写一个单词即可。这样一个插件就能服务所有角色的高频动线差异，而不是把入口清单写死在代码里等用户提需求。

## 四、注意点

**1. act 名拼错时点击报"无权限"而不是"页面不存在"**

`cmd.php?act=拼错的Act` 的行为有点反直觉：Z-Blog 的命令分发机制会做权限映射校验，不认识的 act 通常落在权限校验失败分支，用户看到的是"无权限访问"的提示而不是 404。这会让你在调试时误判方向——菜单点不动，你以为是权限配置问题，实际是 act 拼错了字母。开发时对不确定的 act 名，先手动在浏览器地址栏访问一次 `cmd.php?act=xxx` 验证跳转正常，再写进菜单。

**2. SubMenu 接口是页面级的，别在这里放全站逻辑**

`Filter_Plugin_Admin_SiteInfo_SubMenu` 只在仪表盘页面渲染时触发。这意味着两件事：一是你 echo 的内容只出现在仪表盘，想加全站后台通栏（比如顶部公告条）应该选 `Admin_Header` 或 `Admin_Footer`，放 SubMenu 里会出现"有的页面有、有的页面没有"的闪烁感；二是每次进仪表盘回调都执行一次，回调里不要放任何开销大的操作（数据库聚合查询、远程接口调用），仪表盘是登录后第一个页面，这里是性能第一印象。本插件三个入口的 URL 全是静态字符串拼接，开销趋近于零，是这类接口回调应有的样子。

**3. MakeSubMenu 不做权限过滤，链接权限要自己把关**

注意对比：顶栏的 `MakeTopMenu` 和侧栏的 `MakeLeftMenu` 都内置 `CheckRights` 权限过滤（第一个参数就是权限动作），但 `MakeSubMenu` 的四个参数里没有任何权限位——它是纯 HTML 构造函数，你给它什么它渲染什么。后果：如果仪表盘子菜单里放了"用户管理"入口，那么能登录后台的所有用户（包括没有用户管理权限的编辑作者）都能看到这个菜单项，点进去才会被系统拦截。展示给无权限用户的菜单是负体验。规避办法：渲染前自己判断权限，用 `$zbp->CheckRights('MemberMng')` 包住对应入口的 echo：

```php
if ($zbp->CheckRights('MemberMng')) {
    echo MakeSubMenu('用户管理', $zbp->host . 'zb_system/cmd.php?act=MemberMng', 'm-left', '');
}
```

让不该看到的用户根本看不到，而不是看到了点进去吃闭门羹。

## 五、代码仓库

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

---

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

每次改导航栏、改友情链接、新建页面，都要从仪表盘绕到左侧栏翻半天插件列表才找到入口。就为了改几个链接或加一篇新页，四次点击外加一次鼠标长途奔袭。仪表盘明明是进后台的第一屏，却只有统计信息没有常用操作入口。zb_DashboardShortcuts 解决的就是这个别扭：在仪表盘顶部子菜单区加上"导航栏""友情链接""新建页面"三个直达入口，进后台第一眼就能点。

进后台第一屏就差一个按钮，把常用入口放在 Z-Blog PHP仪表盘子菜单上

开发工具

后端

客户端

zb_DashboardShortcuts插件在Z-Blog后台仪表盘顶部子菜单添加"导航栏""友情链接""新建页面"三个快捷入口，基于Filter_Plugin_Admin_SiteInfo_SubMenu接口实现。通过MakeSubMenu函数输出菜单项，支持自定义链接和权限控制，减少日常操作步骤，提升后台管理效率，兼容多种部署环境。

代码解释

数据库

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

zb_DashboardShortcuts插件在Z-Blog后台仪表盘顶部子菜单添加"导航栏""友情链接""新建页面"三个快捷入口，基于Filter_Plugin_Admin_SiteInfo_SubMenu接口实现。通过MakeSubMenu函数输出菜单项，支持自定义链接和权限控制，减少日常操作步骤，提升后台管理效率...

进后台第一屏就差一个按钮，把常用入口放在 Z-Blog PHP仪表盘子菜单上-腾讯云开发者社区-腾讯云

进后台第一屏就差一个按钮，把常用入口放在 Z-Blog PHP仪表盘子菜单上

进后台第一屏就差一个按钮，把常用入口放在 Z-Blog PHP仪表盘子菜单上

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐