> 垃圾评论是每个开评论的博客的日常。zblogphp评论管理页的筛选和文章管理页同款下拉框设计：想看待审核的，点开状态下拉、选中、点搜索；想翻垃圾评论确认误杀，再把下拉换个值重来一遍。一个每天要执行十几次的操作，每次都要三步。zb_CommentFilterMenu 把"待审核""已通过""垃圾评论"做成子菜单一级入口，进评论管理页，一键开筛。

## 一、接口在哪触发

zb_CommentFilterMenu 挂的是 `Filter_Plugin_Admin_CommentMng_SubMenu` 接口。SubMenu 体系在本系列已完整建立，规格直接列：

- **参数**：无
- **触发位置**：评论管理页（`cmd.php?act=CommentMng`）子菜单区域组装时
- **输出方式**：回调内直接 `echo`，用 `MakeSubMenu()` 构造菜单项

评论管理页的系统默认子菜单同样接近空白，本接口回调的输出就是这个页面工具栏的主要内容。

`MakeSubMenu($strName, $strUrl, $strClass = 'm-left', $strTarget = '', $strId = '', $strTitle = '', $strIconClass = '')` 继续作为唯一的构造工具，不再重复拆解。本讲的干货在于**评论状态字段的取值体系**——这是三个筛选链接的灵魂。

Z-Blog 的评论对象（`Comment`）有 `IsChecking` 状态字段，配合审核体系形成几个离散状态。管理页通过 `status` GET 参数做视图过滤，关键取值：

- `status=0`：已通过的评论（正常展示在前台的）
- `status=1`：待审核的评论（等站长放行的）
- `status=4`：垃圾评论（被系统或站长判定为垃圾的）

注意评论的 status 取值和文章的 status 取值（第 7 讲讲过：0 发布、1 审核、2 草稿）**不是同一套映射**——文章的草稿是 2，评论的垃圾是 4。两套体系数字撞名但语义完全不同，是开发时最容易记混的一个坑。这里先把结论钉死，注意点部分还会展开。

从工作流角度理解这三个视图为什么是评论管理的核心：站长的每日评论处理动线是"进待审核视图放行真评论 → 抽查垃圾视图捞误杀 → 偶尔回已通过视图找历史"。三个视图覆盖了评论管理 95% 的访问目的，做成一级入口的收益远高于任何其他配置。

还有一点系统背景值得知道：Z-Blog 有应用中心提供的反垃圾插件（如"验证码""评分审核"类），垃圾评论被它们拦截后进入垃圾状态而非直接删除——这是"垃圾评论视图"存在的意义，误杀的正经评论可以从那里捞回来。没有这个视图的快捷入口，误杀的代价就是一条条翻找。

## 二、插件做了什么

核心函数，系列第七次出现的"数组 + foreach"标准骨架：

```php
function zb_CommentFilterMenu_SubMenu()
{
    global $zbp;
    $base = $zbp->host . 'zb_system/cmd.php?act=CommentMng';
    $array = array();
    $array[] = array('待审核', $base . '&status=1', 'm-left', '');
    $array[] = array('已通过', $base . '&status=0', 'm-left', '');
    $array[] = array('垃圾评论', $base . '&status=4', 'm-left', '');
    foreach ($array as list($name, $url, $class, $target)) {
        echo MakeSubMenu($name, $url, $class, $target);
    }
}
```

结构上和 zb_ArticleDraftMenu（第 7 讲）是镜像的：同一套骨架，变量换成评论语义。三个链接对应三个状态视图，这里重点讲三个入口的**排序设计**——"待审核"放第一不是随手的。

**入口排序即工作流排序。** 待审核是最高优先级视图：里面有真读者的留言在等回复，每多等一小时，互动体验就冷一分，所以放最前面，鼠标移动距离最短。已通过第二：处理完待审核顺手检查一下新发布的评论区氛围。垃圾评论第三：抽查误杀是低频操作，位置放最后不抢前两个的点击动线。这个"按使用频率和紧迫度排入口"的原则适用于一切工具栏设计，不是这个插件独有的讲究。

**三个视图互斥且完备。** 待审核、已通过、垃圾，加上极少手动访问的"全部"（默认视图），评论的四个状态视图在子菜单可达三个加默认一个。互斥性保证了入口语义清晰——点"待审核"和点"垃圾评论"看到的一定是两个不相交的列表；完备性保证了不用再碰下拉框。

**URL 结构与文章版完全同构。** `$base` 是 `act=CommentMng`，筛选参数 `status` 追加在后。正因为 Z-Blog 的管理页筛选协议全站统一（Mng 页 + 状态 GET 参数），第 7 讲讲透的技术细节在这里可以整套复用——这也是系列插件代码高度相似的原因：**协议统一的地方，代码就该统一**。

安装卸载函数空壳，纯注入零配置，系列标准形态。

## 三、实际怎么用

### 场景 1：每日评论处理动线


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

启用插件后，站长晨间处理评论的标准动线：进评论管理页，点"待审核"——昨晚进来的评论逐条放行或删除；处理完点"垃圾评论"——扫一眼有没有被误杀的真人留言（营销号伪装、新读者触发风控等），有就恢复；正常日子里"已通过"入口偶尔用（找某条历史评论做引用回复）。三个视图把"审评论"这件事从下拉框苦力活变成了一键切换的工作台。

### 场景 2：给"待审核"入口加上待办计数

评论管理最痛的不是点入口，是"不知道有没有待审核的"。给待审核视图加个数字徽标，让站长登录后台就知道该不该去处理：

```php
function myplugin_SubMenu()
{
    global $zbp;
    $base = $zbp->host . 'zb_system/cmd.php?act=CommentMng';
    // 查询待审核数量
    $pending = 0;
    $sql = $zbp->db->sql->Count($zbp->table['Comment'], array('*'), array(array('=', 'comm_IsChecking', 1)));
    $res = $zbp->db->Query($sql);
    if (count($res) > 0) {
        $pending = (int) reset($res[0]);
    }
    $label = $pending > 0 ? '待审核 (' . $pending . ')' : '待审核';
    echo MakeSubMenu($label, $base . '&status=1', 'm-left', '');
    echo MakeSubMenu('已通过', $base . '&status=0', 'm-left', '');
    echo MakeSubMenu('垃圾评论', $base . '&status=4', 'm-left', '');
}
```

用 Z-Blog 的 SQL 构造器（`$zbp->db->sql->Count`）统计 `comm_IsChecking=1` 的条数，拼进菜单文案。字段名以你版本的表结构为准（`Comment` 表的 `IsChecking` 字段生成 `comm_IsChecking` 列名）。效果是"待审核 (5)"——一眼知道工作量，零待办时保持干净文案。这个查询只在评论管理页渲染时执行一次，成本可忽略；若想全站后台可见，把它挪到顶栏或侧栏接口同理，但注意那些接口在所有页面触发，查询建议加静态缓存。

### 场景 3：加上"作者回复"快捷过滤

处理评论的高频操作还包括找"自己该回复的"和"已经回复过的"。利用评论树结构（Z-Blog 评论支持子回复）可以再做两个视图：

```php
$array[] = array('待审核', $base . '&status=1', 'm-left', '');
$array[] = array('已通过', $base . '&status=0', 'm-left', '');
$array[] = array('垃圾评论', $base . '&status=4', 'm-left', '');
// 更多筛选维度按系统支持的 GET 参数扩展，例如按作者、按文章过滤：
$array[] = array('站长的留言', $base . '&authid=1', 'm-right', '');
```

按作者过滤（`authid` 参数指向用户 ID，1 号即站长）可以看到自己发过的回复，检查哪些读者留言还没被回复到。配合前两个场景，评论管理子菜单从"三个状态视图"进化为"状态视图 + 工作量提示 + 自查视图"的完整评论工作台。扩展前记得用第 7 讲教的土办法：在下拉框里筛一次，看地址栏确认参数名，别拍脑袋写。

## 四、注意点

**1. 评论和文章的 status 数值映射是两套体系，别混用**

这是评论类开发第一大坑，值得用加粗重复：**文章 status 的 0/1/2 是发布/审核/草稿，评论 status 的 0/1/4 是已通过/待审核/垃圾——同样叫 status，取值语义完全不同**。开发时如果写过文章筛选插件（第 7 讲），写评论筛选时肌肉记忆会骗你把草稿的 `2` 写进来；而评论 status=2 在不同版本里或者无效、或者对应一个边缘状态，点进去要么列表为空要么出现意外结果。防御办法只有一个：写死数字前先验一遍——建一条对应状态的测试评论，用下拉框筛一次，抄下地址栏里系统自己拼的真实参数值。本插件的 `1/0/4` 就是这么验证出来的，建议你在自己部署的版本上重验一次，版本间语义漂移在这种边缘字段上并不罕见。

**2. 垃圾评论视图依赖反垃圾体系的状态写入，别把垃圾当删除**

`status=4` 的垃圾评论不是"删除队列"，是"隔离区"——它们还在数据库里占着行数，只是不展示在前台。两个连带影响：一是别把垃圾视图当回收站清理目标，里面可能混着误杀的真人评论，直接全选删除会误伤；二是垃圾评论会随时间积累，量大后列表页会变慢（尤其无分页优化时），定期批量清理是运维刚需，但清之前永远抽查一页。另外如果你的站开了"自动把垃圾评论物理删除"类的反垃圾插件选项，垃圾视图可能长期为空，这时这个入口的作用退化，可以考虑按场景 2 的思路换成功效更强的入口（比如待办计数）。

**3. 评论管理页权限模型与 SubMenu 的展示范围**

能进评论管理页的用户范围比想象中宽：Z-Blog 的权限体系里，"评论管理"权限可以单独授予（比如给版主角色），不必是管理员。SubMenu 接口的输出对这些用户同样可见——版主看到的子菜单和管理员一模一样。三个状态视图入口对任何有评论权限的人都是合理展示（他们本来就能通过下拉框到达），所以本插件不需要权限判断。但如果你按场景 3 扩展时加了"按作者过滤"之外的敏感入口（比如直达数据库清理工具），那类入口就要自己在回调里用 `$zbp->CheckRights()` 把关了——评论管理页的受众比你写代码时假设的更杂。设计任何管理页增强插件前，先问一句：这个页面最不特权的访问者是谁，我加的东西他该看到吗。

## 五、代码仓库

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

---

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

垃圾评论是每个开评论的博客的日常。zblogphp评论管理页的筛选和文章管理页同款下拉框设计：想看待审核的，点开状态下拉、选中、点搜索；想翻垃圾评论确认误杀，再把下拉换个值重来一遍。一个每天要执行十几次的操作，每次都要三步。zb_CommentFilterMenu 把"待审核""已通过""垃圾评论"做成子菜单一级入口，进评论管理页，一键开筛。

每天审评论像挖矿，把"待审核/已通过/垃圾"三个按钮直接开在评论管理页菜单栏上

数据库

一键切换评论状态筛选：ZBlog插件zb_CommentFilterMenu在评论管理页直接显示待审核(1)、已通过(0)、垃圾(4)三个一级子菜单，替代繁琐的下拉框操作，按工作流排序提升处理效率，支持扩展待办计数等个性化功能。

代码解释

验证码

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

每天审评论像挖矿，把"待审核/已通过/垃圾"三个按钮直接开在评论管理页菜单栏上-腾讯云开发者社区-腾讯云

每天审评论像挖矿，把"待审核/已通过/垃圾"三个按钮直接开在评论管理页菜单栏上

每天审评论像挖矿，把"待审核/已通过/垃圾"三个按钮直接开在评论管理页菜单栏上

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐