> zblogphp 文章管理页自带的筛选是"下拉框式"的：想看草稿，先点开状态下拉框，选"草稿"，再点搜索按钮，两步外加一次页面刷新前的等待。找已发布的、找置顶的，同样流程再走一遍。这些明明是每个编辑天天用的操作，却埋在下拉框深处。zb_ArticleDraftMenu 把"草稿""已发布""置顶"三个高频筛选直接做成子菜单按钮，文章管理页一进去，一键直达。

## 一、接口在哪触发

zb_ArticleDraftMenu 挂的是 `Filter_Plugin_Admin_ArticleMng_SubMenu` 接口。本接口只在文章管理页（`cmd.php?act=ArticleMng`）的子菜单区域组装时触发。

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

接口规格：

- **参数**：无
- **触发位置**：文章管理页子菜单区域组装时
- **输出方式**：回调内直接 `echo`，用 `MakeSubMenu()` 构造菜单项

Z-Blog 后台每个管理页都有一条子菜单栏。文章管理页的系统默认子菜单只有一项——"新增文章"。`Filter_Plugin_Admin_ArticleMng_SubMenu` 的触发点就在这一项之后，插件 echo 出来的菜单项会追加在"新增文章"右边，形成一整条：新增文章 | 草稿 | 已发布 | 置顶。

`MakeSubMenu` 的七个参数（名称、链接、类名、target、id、title、图标类）。本讲的真正主角是**链接本身**——这个插件的全部价值藏在三个 URL 参数里，这就要说到 Z-Blog 文章管理页的原生筛选能力。

文章管理页（`act=ArticleMng`）本身就支持一组 GET 参数做列表筛选，这是系统底层功能，平时藏在那个下拉框表单背后：

- `status=0`：已发布文章
- `status=1`：审核中文章
- `status=2`：草稿文章
- `istop=1`：置顶文章

下拉框表单提交时干的事情，本质就是把这几个参数拼到 `cmd.php?act=ArticleMng` 后面。插件做的事情，就是把这套参数拼 URL 的过程写死成三个子菜单链接。系统已有的筛选能力 + 一个注入菜单的接口，两个现成积木一拼，功能就成立了——这正是 Z-Blog 接口设计的优雅之处：不需要 hook 查询逻辑、不需要改核心代码，给个输出位置你就能把高频操作提到表面。

## 二、插件做了什么

核心函数按照"数组组织 + foreach 渲染"模式，变量全换成了文章筛选语义：

```php
function zb_ArticleDraftMenu_SubMenu()
{
    global $zbp;
    $base = $zbp->host . 'zb_system/cmd.php?act=ArticleMng';
    $array = array();
    $array[] = array('草稿', $base . '&status=2', 'm-left', '');
    $array[] = array('已发布', $base . '&status=0', 'm-left', '');
    $array[] = array('置顶', $base . '&istop=1', 'm-left', '');
    foreach ($array as list($name, $url, $class, $target)) {
        echo MakeSubMenu($name, $url, $class, $target);
    }
}
```

逐段看：

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

**三个链接对应三种筛选语义。**

- `&status=2`：草稿。写稿党的刚需入口——打开就能看到所有躺在草稿箱里的半成品，是"今天该续写哪篇"的起点；
- `&status=0`：已发布。和"草稿"是一对互补视图，快速确认哪些内容已经出去了、最近发布的排最前面；
- `&istop=1`：置顶。运营向入口——检查当前置顶着哪几篇文章、该不该换。

**`m-left` 保持布局统一。** 三个入口都是站内筛选功能，全部靠左和"新增文章"排排坐。没有外链，全部 `''` 当前窗口打开（站内列表切换用当前窗口理所应当）。

本讲的三个入口是"同一个页面的三种过滤视图"——点"草稿"还是文章管理页，只是列表内容被 status 参数过滤了。用户心智上前者是导航，本讲是筛选器，但实现上是同一种技术：拼一个带参数的 URL 让系统自己去渲染。

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

## 三、实际怎么用

### 场景 1：写作流里的草稿箱
启用插件后，写稿的动线变成：文章管理页直接点"草稿"——所有未完成稿子按时间倒序铺开，点标题进编辑器续写，写完保存（仍为草稿）或发布。当天想接着昨天的坑写，两步到位。配合"已发布"入口做发布前核对，"置顶"入口做首页内容检查，整个内容运营的三个视角在子菜单一行全部可达。

### 场景 2：补充更多筛选维度

系统的 GET 筛选参数不止 status 和 istop 两个，常见可用的还有分类、作者、搜索词、每页数量等。照着模式补就行：

```php
function myplugin_SubMenu()
{
    global $zbp;
    $base = $zbp->host . 'zb_system/cmd.php?act=ArticleMng';
    $array = array();
    $array[] = array('草稿', $base . '&status=2', 'm-left', '');
    $array[] = array('审核中', $base . '&status=1', 'm-left', '');
    $array[] = array('已发布', $base . '&status=0', 'm-left', '');
    $array[] = array('置顶', $base . '&istop=1', 'm-left', '');
    $array[] = array('每页100条', $base . '&pagelimit=100', 'm-right', '');
    $array[] = array('站长文章', $base . '&authid=1', 'm-right', '');
    foreach ($array as list($name, $url, $class, $target)) {
        echo MakeSubMenu($name, $url, $class, $target);
    }
}
```

补了"审核中"（多作者站点的审稿入口）、"每页100条"（批量管理时的翻页杀手，用 `m-right` 推右侧区分它不是状态筛选）、"站长文章"（`authid=1` 过滤 1 号用户即站长本人的文章，多人博客找自己内容利器）。每个入口就是一行配置，参数名对了就生效。想确认系统当前版本支持哪些筛选参数，最快的办法是在文章管理页用一次下拉框筛选，然后看浏览器地址栏——URL 里会明明白白告诉你所有可用参数。

### 场景 3：给筛选入口加当前态提示

子菜单入口是静态链接，用户点"草稿"进入筛选视图后，菜单本身不会高亮"你正在草稿视图"。给 `MakeSubMenu` 的 class 参数追加一个高亮类就行，渲染主线不动：

```php
function myplugin_SubMenu()
{
    global $zbp;
    $base = $zbp->host . 'zb_system/cmd.php?act=ArticleMng';
    $status = GetVars('status', 'GET');
    $istop = GetVars('istop', 'GET');

    $array = array();
    $array[] = array('草稿',   $base . '&status=2', 'status:2', 'm-left', '');
    $array[] = array('已发布', $base . '&status=0', 'status:0', 'm-left', '');
    $array[] = array('置顶',   $base . '&istop=1',  'istop:1',  'm-left', '');
    foreach ($array as list($name, $url, $match, $class, $target)) {
        // 判断当前请求是否命中这个筛选条件，命中则追加高亮类
        list($key, $val) = explode(':', $match);
        if (GetVars($key, 'GET') === $val) {
            $class .= ' m-now';
        }
        echo MakeSubMenu($name, $url, $class, $target);
    }
}
```

做法：数据行加了一个 `match` 字段（`status:2` 这种冒号分隔的键值对），foreach 里用 `GetVars` 取当前请求的对应参数，命中时给 `$class` 追加 `m-now`（以后台 CSS 实测的高亮类名为准），然后照常传给 `MakeSubMenu`。渲染主线还是 `MakeSubMenu`，高亮只是 class 参数上多了一个类名。比手拼 HTML 干净得多——你不需要知道 `MakeSubMenu` 内部拼了什么结构，只管往它的参数里塞正确的 class 就行。

## 四、注意点

**1. status 参数值和系统常量的对应关系要查准**

`status=2` 对应草稿、`0` 对应发布、`1` 对应审核，这些数字是 Z-Blog `Post` 状态字段的实际存储值。插件写死的映射（`2` 草稿、`0` 已发布）在 Z-BlogPHP 1.5 及 1.7 的主线版本上是稳定语义，但请以你手上版本的源码为准：翻 `zb_system/function/c_system_admin.php` 里文章管理的筛选表单段，或者直接 `var_dump` 一篇草稿的 `Status` 属性验证。数字对不上时表现为"点了草稿列出的是审核中的文章"，没有任何报错，纯靠人眼发现。做这类"参数硬编码"插件，发布前务必在自己站点把每个入口点一遍做冒烟测试。

**2. 筛选参数组合的优先级问题**

`cmd.php?act=ArticleMng&status=2&istop=1` 这样的组合 URL，系统会按自己的查询构造规则处理参数组合——有的版本里 `istop` 优先、有的场景里两条件同时生效。本插件三个入口都是单参数链接不存在组合问题，但你自己扩展组合筛选（比如"置顶的草稿"）时要实测：期望的列表到底是交集还是被其中某个参数覆盖。多参数筛选的行为属于"未在文档中承诺"的边缘地带，升级大版本时这里是最可能悄悄变化的地方，插件里尽量只依赖单参数筛选可以最大限度规避风险。

**3. 子菜单空间有限，入口数量要克制**

文章管理页子菜单栏宽度有限，系统项"新增文章"加插件三项再加你扩展的项，超过六七个就会在窄屏换行。而且筛选入口多了反而降低效率——入口的本意是"高频操作一击即达"，列十来个入口等于把下拉框平铺，选择成本又回来了。建议控制原则：状态类筛选（草稿/已发布/置顶/审核中）是刚需可保留，维度类筛选（分类、作者、时间范围）放系统原生下拉框就够了，那里本来就有完整表单，别在子菜单重复。工具的目的是减少操作，不是转移操作。

## 五、代码仓库

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

---

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

zblogphp 文章管理页自带的筛选是"下拉框式"的：想看草稿，先点开状态下拉框，选"草稿"，再点搜索按钮，两步外加一次页面刷新前的等待。找已发布的、找置顶的，同样流程再走一遍。这些明明是每个编辑天天用的操作，却埋在下拉框深处。zb_ArticleDraftMenu 把"草稿""已发布""置顶"三个高频筛选直接做成子菜单按钮，文章管理页一进去，一键直达。

找草稿不再翻下拉框，在Z-Blog PHP给文章管理页装上三键状态筛选

后端

开发工具

新闻资讯

zb_ArticleDraftMenu插件将Z-Blog文章管理页的"草稿""已发布""置顶"高频筛选从下拉框改为子菜单一键直达，免去两步操作。通过挂载Filter_Plugin_Admin_ArticleMng_SubMenu接口拼接系统原生GET参数，无需改核心代码。支持扩展分类、作者等筛选维度，可添加当前态高亮提示，有效提升编辑日常管理效率。

代码解释

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

zb_ArticleDraftMenu插件将Z-Blog文章管理页的"草稿""已发布""置顶"高频筛选从下拉框改为子菜单一键直达，免去两步操作。通过挂载Filter_Plugin_Admin_ArticleMng_SubMenu接口拼接系统原生GET参数，无需改核心代码。支持扩展分类、作者等筛选维度，可添加当前态高亮提...

找草稿不再翻下拉框，在Z-Blog PHP给文章管理页装上三键状态筛选-腾讯云开发者社区-腾讯云

找草稿不再翻下拉框，在Z-Blog PHP给文章管理页装上三键状态筛选

找草稿不再翻下拉框，在Z-Blog PHP给文章管理页装上三键状态筛选

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐