> zbogphp分类管理页表头有个"文章数量"列，每个分类下多少篇文章一目了然。但这个列**没有排序按钮**——系统 `order` 参数白名单只认 ID、排序号、名称、别名这四个，文章数量不在里面。想按文章数量排序找出哪些分类活跃、哪些是空壳，你做不到。zb_CategoryMngMenu 解决这个问题：SubMenu 接口往空着的子菜单区域塞一个"按文章数量排序"入口，Core 接口检测自定义参数 `sort=count_desc` 后覆盖查询排序。两个接口配合，排序就真的生效了。

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

### SubMenu 接口

`Filter_Plugin_Admin_CategoryMng_SubMenu` 是分类管理页专属的 SubMenu 接口。接口规格：

- **参数**：无
- **触发位置**：分类管理页（`cmd.php?act=CategoryMng`）子菜单区域组装时
- **输出方式**：回调内直接 `echo MakeSubMenu()`，返回值不被使用

和其他 SubMenu 接口有个关键区别：**CategoryMng 的子菜单区域系统默认就是空的**，连个默认项都没有。所以本插件是"往空地填东西"。

### Core 接口

`Filter_Plugin_Admin_CategoryMng_Core` 是分类管理查询构建接口。接口规格：

- **参数**：`($s, $w, &$or, $l, $op)`
- **触发位置**：系统构建完查询条件、准备执行查询前
- **`$or` 是引用传递的排序数组**，改它就能改查询的 ORDER BY

Core 接口是本插件排序真正生效的关键——系统 `order` 参数有白名单校验（只认 id_desc、order_asc、name_desc、alias_asc 等 8 个值），自定义参数传进去会被静默忽略。所以 SubMenu 入口用自定义参数名 `sort`（避开和系统 `order` 参数冲突），然后在 Core 回调里手动检测和覆盖排序数组。

## 二、插件做了什么

### SubMenu 回调：注入排序入口

```php
function zb_CategoryMngMenu_SubMenu()
{
    global $zbp;
    $base = $zbp->host . 'zb_system/cmd.php?act=CategoryMng';
    $current = GetVars('sort', 'GET');
    $array = array();
    $array[] = array('按文章数量排序', $base . '&sort=count_desc', 'm-left' . ($current === 'count_desc' ? ' m-now' : ''), '');
    foreach ($array as list($name, $url, $class, $target)) {
        echo MakeSubMenu($name, $url, $class, $target);
    }
}
```

SubMenu 部分就是本系列一贯的"数组 + foreach + MakeSubMenu"模式。两个要点：

**用自定义参数 `sort` 而不是系统 `order`。** 系统 `order` 有白名单校验，传未知值会被静默忽略退回默认排序。自定义参数名 `sort` 系统不认识、不会拦截，Core 回调里自己检测处理。

**当前状态高亮。** `$current` 从 GET 取当前 sort 值，和目标值对比，相等时在 class 里拼 `m-now`。

### Core 回调：让排序真正生效

```php
function zb_CategoryMngMenu_Core($s, $w, &$or, $l, $op)
{
    if (GetVars('sort', 'GET') === 'count_desc') {
        $or = array('cate_Count' => 'DESC');
    }
}
```

Core 回调的五个参数中，`$or` 是引用传递的排序数组。系统默认是 `array('cate_ID' => 'ASC')`（第 491-492 行），回调检测到 `sort=count_desc` 就把 `$or` 覆盖为 `array('cate_Count' => 'DESC')`，后续 `GetCategoryList()` 查询就按文章数量降序排。因为是引用传递，直接改 `$or` 就行，不需要 return。

`cate_Count` 是分类的文章数量字段，对应 Category 对象上的 `Count` 属性（第 540 行 `$category->Count`）。

### 为什么两个接口配合才能完整

SubMenu 回调的职责是"往子菜单区域输出菜单项 HTML"——但输出的 URL 能不能生效、排序能不能真的按文章数量排，SubMenu 自己管不了。系统 `order` 白名单不认 count，得靠 Core 接口在查询层覆盖排序。SubMenu 让入口可见，Core 让排序生效，两个接口配合才是完整的功能闭环。

安装卸载函数空壳，纯功能注入，无配置无数据。

## 三、实际怎么用

### 场景 1：一键找出空分类

分类管理页点"按文章数量排序"，列表立刻按文章数量降序排——空分类（Count=0）全跑到末尾，活跃分类顶到最上面。批量清理空分类、或者给空分类补内容，操作流变成：点入口 → 滑到底部 → 逐个删除，比在默认排序下一个个翻快得多。

### 场景 2：快速定位热门分类

降序排列后，文章数量最多的分类直接顶到第一行。想看看"产品"分类为什么这么热、或者"归档"分类为什么没人看，直接点进去编辑，不用在长列表里找。

### 场景 3：扩展成多种排序

在 SubMenu 的 `$array` 里加行就行：

```php
$array[] = array('按文章数量升序', $base . '&sort=count_asc', 'm-left' . ($current === 'count_asc' ? ' m-now' : ''), '');
```

然后 Core 回调里补一行：

```php
} elseif (GetVars('sort', 'GET') === 'count_asc') {
    $or = array('cate_Count' => 'ASC');
}
```

## 四、注意点

**1. 系统 `order` 参数有白名单，自定义参数要避开**

系统 `order` 只认 `id_desc`、`id_asc`、`order_desc`、`order_asc`、`name_desc`、`name_asc`、`alias_desc`、`alias_asc` 这 8 个值（第 474-492 行），传未知值会被静默忽略。本插件用自定义参数 `sort` 就是为了避开这个白名单校验——自定义参数系统不认识、不会拦截，Core 回调里自己检测处理。

**2. SubMenu 和 Core 职责分离，缺一不可**

SubMenu 回调只管"注入入口"，Core 回调只管"让排序生效"。如果只注册 SubMenu 不注册 Core，点入口 URL 会被系统忽略，列表还是默认排序，用户以为插件坏了。如果只注册 Core 不注册 SubMenu，排序逻辑在但没有入口，用户得自己手改 URL `&sort=count_desc` 才能触发。

**3. `cate_Count` 是数据库字段，不是属性名**

排序数组 `$or` 的键是数据库字段名 `cate_Count`，不是 PHP 对象属性名 `Count`。Core 接口传过来的是查询层的排序数组，键必须是数据库字段名。而 SubMenu 回调里取分类文章数量用的是 `$category->Count`（PHP 属性）。两个不要搞混。

## 五、代码仓库

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

***

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

zbogphp分类管理页表头有个"文章数量"列，每个分类下多少篇文章一目了然。但这个列没有排序按钮——系统 order 参数白名单只认 ID、排序号、名称、别名这四个，文章数量不在里面。想按文章数量排序找出哪些分类活跃、哪些是空壳，你做不到。zb_CategoryMngMenu 解决这个问题：SubMenu 接口往空着的子菜单区域塞一个"按文章数量排序"入口，Core 接口检测自定义参数 sort=count_desc 后覆盖查询排序。两个接口配合，排序就真的生效了。

分类管理子菜单空荡荡，用 SubMenu + Core 接口给Z-Blog PHP补上按文章数量排序

zbogphp分类管理页表头有个"文章数量"列，每个分类下多少篇文章一目了然。但这个列没有排序按钮——系统 order 参数白名单只认 ID、排序号、名称、别名这四个，文章数量不在里面。想按文章数量排序找出哪些分类活跃、哪些是空壳，你做不到。zb_CategoryMngMenu 解决这个问题：SubMenu 接口往空着的子菜单区域塞一个"按文章数量排序"入口，Core 接口检测自定义参数 sort

编程语言

开发工具

新闻资讯

zb_CategoryMngMenu插件为Z-Blog分类管理页增加按文章数量排序功能。通过SubMenu接口注入排序入口，Core接口覆盖查询排序数组，绕过系统order白名单限制，支持按文章数量降序排列，快速识别活跃分类和空壳分类，操作便捷，提升管理效率。

代码解释

数据库

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

分类管理子菜单空荡荡，用 SubMenu + Core 接口给Z-Blog PHP补上按文章数量排序-腾讯云开发者社区-腾讯云

分类管理子菜单空荡荡，用 SubMenu + Core 接口给Z-Blog PHP补上按文章数量排序

分类管理子菜单空荡荡，用 SubMenu + Core 接口给Z-Blog PHP补上按文章数量排序

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐