> Z-Blog 每个管理页的子菜单区域都是一块空白地：系统只放一个默认项，剩下全靠插件自己填。页面管理页系统只给了"新增页面"，想看按 ID 排序、按作者排序，还得自己改 URL。zb_PageMngMenu 往页面管理子菜单塞多个入口，点一下列表就按指定字段重排——本质就是 SubMenu 接口最基础的"注入链接"用法。

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

`Filter_Plugin_Admin_PageMng_SubMenu` 是 Z-Blog 后台 SubMenu 接口家族的页面管理版本。SubMenu 接口家族的特点：每个管理页各开一个，只服务自己的页面，互不越界。

接口规格：

- **参数**：无
- **触发位置**：页面管理页（`cmd.php?act=PageMng`）子菜单区域组装时，系统默认项"新增页面"之后
- **输出方式**：回调内直接 `echo MakeSubMenu()`，返回值不被使用

`MakeSubMenu` 构造函数沿用：`MakeSubMenu($strName, $strUrl, $strClass = 'm-left', $strTarget = '', $strId = '', $strTitle = '', $strIconClass = '')`，返回拼好的 `<li>` HTML 字符串，echo 即可上屏。`m-left` 靠左排列、target 留空当前窗口。

本系列前两篇 SubMenu 文章（zb_DashboardShortcuts、zb_ArticleDraftMenu）已经把这套接口的触发时机、参数规格、`MakeSubMenu` 用法讲透了，这里不重复。本讲只聚焦一个问题：**SubMenu 回调里的数据组织方式**——怎么用最少的代码塞多个入口。

## 二、插件做了什么

核心函数就是"数组 + foreach + MakeSubMenu"，和前两篇同构：

```php
function zb_PageMngMenu_SubMenu()
{
    global $zbp;
    $base = $zbp->host . 'zb_system/cmd.php?act=PageMng';
    $array = array();
    $array[] = array('按ID排序', $base . '&order=id_asc', 'm-left', '');
    $array[] = array('按作者排序', $base . '&order=authorid_desc', 'm-left', '');
    foreach ($array as list($name, $url, $class, $target)) {
        echo MakeSubMenu($name, $url, $class, $target);
    }
}
```

逐段看：

**`$base` 提取公共前缀。** 两个入口共享 `cmd.php?act=PageMng` 这个基础地址，提取成变量避免重复。也让"这两个入口属于同一个基础页面"的关系在代码里显式可见。

**数组每项四元组。** 顺序和 `MakeSubMenu` 的前四个参数一一对应：名称、URL、CSS 类名、target。四元组是本系列 SubMenu 插件约定的数据结构，后续场景扩展也围绕它转。

**`list()` 解构 + `MakeSubMenu` 渲染。** foreach 里 `list($name, $url, $class, $target)` 把四元组拆成变量，直接传给 `MakeSubMenu`。三个动作一行完成，没有中间变量。

**排序 URL 用系统原生支持的 `order` 参数。** PageMng 原生支持 `order=id_desc`、`order=id_asc`、`order=authorid_desc`、`order=authorid_asc`、`posttime_desc`、`posttime_asc`、`cateid_desc`、`cateid_asc` 这几个值，直接拼进 URL 就行，不需要额外接口介入。这也是本插件和 zb_ArticleDraftMenu 的一个小区别：后者的筛选参数（`status`、`istop`）也是系统原生 GET 参数，插件只是把它们拼成链接。

安装卸载函数是空壳，纯菜单注入，无配置无数据。

## 三、实际怎么用

### 场景 1：直接用，两个排序入口

启用插件后，页面管理页子菜单变成一行：新增页面 | 按ID排序 | 按作者排序。点"按ID排序"列表按 ID 倒序（最新创建的页面在前），点"按作者排序"按作者升序排列。两个入口都是系统原生功能的快捷方式，不需要插件实现排序逻辑。

### 场景 2：补更多排序入口

数组是加一行多一个入口，照着模式补：

```php
$array[] = array('按时间排序', $base . '&order=posttime_desc', 'm-left', '');
$array[] = array('按分类排序', $base . '&order=cateid_asc', 'm-left', '');
```

注意系统 `order` 参数有白名单，只能用上面列的那 8 个值，自创值会被静默忽略退回默认排序（时间倒序）。

### 场景 3：混入外链入口

数组里可以混不同 URL 类型——站内 `cmd.php`、插件页、外链都能放，只要四元组对就行：

```php
$array[] = array('前台预览', $zbp->host, 'm-right', '_blank');
$array[] = array('模块管理', $zbp->host . 'zb_system/cmd.php?act=ModuleMng', 'm-left', '');
```

`m-right` 推到子菜单右边，`_blank` 新窗口打开。SubMenu 接口不限制 URL 类型，你给什么它渲染什么。

## 四、注意点

**1. SubMenu 接口只管注入，不管 URL 能不能生效**

SubMenu 回调的职责就是往子菜单区域输出菜单项 HTML，URL 能不能跳转、跳转后系统会不会处理、处理成什么结果——这些全不在它的控制范围内。所以写插件时要先确认目标 URL 是系统原生支持的，或者有其他插件/接口配合处理。本插件用的 `order` 参数是系统原生的，zb_ArticleDraftMenu 用的 `status`、`istop` 也是系统原生的。如果你想加一个系统不支持的 URL（比如"按浏览量排序"），就得额外挂 Core 接口去覆盖排序逻辑，那篇就归 Core 系列讲了。

**2. 页面和文章的 SubMenu 接口是分开的**

`Filter_Plugin_Admin_PageMng_SubMenu` 只管页面管理页，`Filter_Plugin_Admin_ArticleMng_SubMenu` 只管文章管理页，两个接口互不越界。好处是回调职责单一：页面管理的回调里不需要判断"现在是不是页面页"，接口触发本身就保证了上下文。如果你想做"一个插件给所有管理页加菜单"，就得把同一个回调注册到 N 个接口上逐个挂。

**3. 入口数量要克制**

子菜单栏宽度有限，系统默认项加插件项超过五六个就会在窄屏换行。入口的本意是"高频操作一击即达"，低频操作别往里塞——放系统原生下拉框、侧边栏或设置页里更合适。

## 五、代码仓库

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

***

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

Z-Blog 每个管理页的子菜单区域都是一块空白地：系统只放一个默认项，剩下全靠插件自己填。页面管理页系统只给了"新增页面"，想看按 ID 排序、按作者排序，还得自己改 URL。zb_PageMngMenu 往页面管理子菜单塞多个入口，点一下列表就按指定字段重排——本质就是 SubMenu 接口最基础的"注入链接"用法。

给Z-Blog PHP页面管理子菜单加多个入口，SubMenu 接口的"数组 + foreach"三板斧

编程语言

Z-Blog页面管理子菜单通过Filter_Plugin_Admin_PageMng_SubMenu接口实现多入口注入，核心采用数组+foreach+MakeSubMenu模式，仅需四元组数据即可快速添加排序快捷方式。插件利用系统原生order参数，支持按ID、作者、时间、分类等排序，无需额外接口逻辑。此方法代码量小、扩展性强，可混入外链或新窗口入口，实现高频操作一键直达，提升后台管理效率。

数据结构

代码解释

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

Z-Blog页面管理子菜单通过Filter_Plugin_Admin_PageMng_SubMenu接口实现多入口注入，核心采用数组+foreach+MakeSubMenu模式，仅需四元组数据即可快速添加排序快捷方式。插件利用系统原生order参数，支持按ID、作者、时间、分类等排序，无需额外接口逻辑。此方法代码量小、...

给Z-Blog PHP页面管理子菜单加多个入口，SubMenu 接口的"数组 + foreach"三板斧-腾讯云开发者社区-腾讯云

给Z-Blog PHP页面管理子菜单加多个入口，SubMenu 接口的"数组 + foreach"三板斧

给Z-Blog PHP页面管理子菜单加多个入口，SubMenu 接口的"数组 + foreach"三板斧

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐