> 在用zblogphp写博客的人多少都有点"字数执念"：这篇稿子到底写了多少字？读者点开要花几分钟读完？可惜 Z-Blog 后台的文章管理列表默认只给你看标题、分类、日期、状态，字数这种关键信息完全靠你自己开编辑器数。文章多了以后，想快速找出那几篇"注水严重"或者"过于单薄"的内容，只能一篇篇点进去看。这篇要讲的 zb_ArticleWordCount 插件，就是给文章管理列表加一列"字数/阅读时长"，让整个内容库的健康状况一眼扫出来。

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

## 一、接口在哪触发

zb_ArticleWordCount 挂的是 `Filter_Plugin_Admin_ArticleMng_Table` 接口。这个接口藏在后台文章管理页的列表渲染逻辑里，源码位置在 `zb_system/function/c_system_admin.php`。它的工作方式是这样的：文章管理页把所有文章查出来之后，用一个 `foreach` 循环逐行渲染表格，每循环一篇文章就触发一次这个接口：

```php
foreach ($array as $article) {
 $tabletds = array(); // 当前行
 $tabletds[] = '<tr>';
 // ... 各 <td> ...
 $tabletds[] = '</tr>';

 foreach ($GLOBALS['hooks']['Filter_Plugin_Admin_ArticleMng_Table'] as $fpname => &$fpsignal) {
 $fpname ($article, $tabletds, $tableths);
 }
 $tables .= implode($tabletds);
}
```

接口签名是 `Filter_Plugin_Admin_ArticleMng_Table(Post &$article, arr &$tabletds, arr &$tableths)`，三个参数全部是引用传递：

- `$article`：当前正在渲染的文章对象，是完整的 `Post` 实例，`Content`、`Title`、`Status` 等属性都在，不需要自己去查数据库；
- `$tabletds`：当前行的 `<td>` 数组，首元素 `<tr>`，末元素 `</tr>`，中间每个元素是一个单元格的 HTML，你在回调里往这个数组里塞东西，就等于往表格行里塞单元格；
- `$tableths`：表头列数组，结构和 `$tabletds` 一样，但它是在 `foreach` 循环外构建的，所有行共享同一个引用。

正因为三个参数都是引用，回调函数不需要返回值，对数组的任何修改都会直接生效。这也意味着一件事：回调对 `$tableths` 插入一次表头之后，这个插入动作会在后续每一行的回调里"继承"下去——这一点是理解本插件防重复逻辑的关键。

触发时机也很讲究：每输出一行文章触发一次。也就是说列表页每页显示 20 篇文章，你的回调就会被调用 20 次，每次拿到的 `$article` 是不同的文章。

## 二、插件做了什么

插件的目标很明确：在"状态"列后面插一个"字数 / 时长"列，表头和数据行都得对齐。核心代码如下：

```php
function zb_ArticleWordCount_Table(&$article, &$tabletds, &$tableths)
{
 global $zbp;

 // 表头：插在「状态」列后面，只加一次
 static $headerAdded = false;
 if (!$headerAdded) {
 $i = array_search('<th>' . $zbp->lang['msg']['status'] . '</th>', $tableths, true);
 if ($i !== false) {
 array_splice($tableths, $i + 1, 0, array('<th class="td10">字数 / 时长</th>'));
 }
 $headerAdded = true;
 }

 // 配置只读一次
 static $wpm = 0;
 if ($wpm === 0) {
 $wpm = (int) $zbp->Config('zb_ArticleWordCount')->wpm;
 if ($wpm <= 0) $wpm = 300;
 }

 // 字数：去 HTML 标签后按字符数计
 $wordCount = mb_strlen(trim(strip_tags($article->Content)), 'UTF-8');
 $mins = (int) ceil($wordCount / $wpm);
 $time = $mins < 1 ? '&lt;1分钟' : '约' . $mins . '分钟';
 $cell = '<td class="td10 tdCenter">' . $wordCount . ' 字 ' . $time . '</td>';

 // 数据行：插在「操作」列前面
 foreach ($tabletds as $i => $td) {
 if (strpos($td, 'icon-pencil-square') !== false) {
 array_splice($tabletds, $i, 0, array($cell));
 break;
 }
 }
}
```

实现思路拆开看是三步：

**第一步，插表头，但要防重复。** 前面说过 `$tableths` 在循环外构建、所有行共享。如果回调里每次都执行 `array_splice` 往表头数组里插一个 `<th>`，那么 50 篇文章渲染下来，表头会出现 50 个重复的"字数 / 时长"列—— implode 之后表头直接爆掉。解决办法是 `static $headerAdded = false` 这个静态变量：第一次调用时插入表头并把标记置为 true，后续 49 次调用直接跳过。这是 PHP 处理"循环内触发、循环外共享"类接口的惯用手法。

**第二步，找位置。** 表头这端用 `array_search` 精确定位系统"状态"列的 `<th>`（内容是 `$zbp->lang['msg']['status']`，从语言包里取，跟着系统语言走），插在它后面。注意 `array_search` 的第三个参数 `true` 开启了严格模式，因为 `<th>` 内容是完全拼接出来的字符串，必须一字不差地匹配。

**第三步，数据行插在"操作"列前面。** 数据行不好用 `array_search` 精确匹配——因为操作列的 `<td>` 里包含的是图标按钮的 HTML，内容复杂且带文章 ID。所以这里改用 `strpos` 找特征串：编辑按钮的图标类名 `icon-pencil-square` 是 Z-Blog 后台编辑按钮的固定特征，找到了它就等于找到了操作列，把字数单元格插到它前面。这样最终列序是"状态 → 字数/时长 → 操作"，位置相当合理：状态说明这篇文章"活没活"，字数说明这篇文章"肥不肥"，操作负责"动它"。

字数统计部分用的是 `mb_strlen(trim(strip_tags($article->Content)), 'UTF-8')`：先 `strip_tags` 把内容里的 HTML 标签剥掉，再 `trim` 掉首尾空白，最后 `mb_strlen` 按 UTF-8 编码数字符。对中文博客来说，一个汉字算一个字符，一个英文字母也算一个，简单粗暴但足够实用。阅读时长则是拿字数除以配置的阅读速度（默认 300 字/分钟，管理页可调），`ceil` 向上取整，不足一分钟显示"&lt;1分钟"。

配置读取也做了 `static` 缓存：`$wpm` 第一次从 `$zbp->Config` 读出来后缓存住，后面 49 次调用不再碰配置对象。虽然读配置本身不慢，但 50 次重复读完全没有必要。

## 三、实际怎么用

### 场景 1：直接安装，让列表多一列字数

插件安装后无需任何配置即可工作。启用后进后台"文章管理"，列表会多出一列：

状态 | 字数 / 时长 | 操作
----------- | ------------------- | ----
已发布 | 2840 字 / 约10分钟 | 编辑 删除

字数用 `` 加粗、阅读时长用小号灰字跟在下面，视觉上主次分明。一眼扫下去就能看出哪些文章是两三千字的干货长文、哪些是三五百字的碎片记录。

### 场景 2：按自己的读者群调整阅读速度

默认 300 字/分钟是大众阅读速度，但技术博客的读者读代码段时慢得多，小说类博客读者读得飞快。插件在 `include.php` 里提供了配置入口，管理页 `main.php` 把配置写进 `wpm` 字段：

```php
function InstallPlugin_zb_ArticleWordCount()
{
 global $zbp;
 $cfg = $zbp->Config('zb_ArticleWordCount');
 if ($cfg->wpm === null) {
 $cfg->wpm = 300;
 $zbp->SaveConfig('zb_ArticleWordCount');
 }
}
```

安装函数只在 `wpm` 为 null 时写入默认值，避免重复安装把用户改过的配置冲掉。如果你想给技术站配 200 字/分钟，进插件管理页改一下保存，列表里的时长立刻按新速度换算。回调里的边界兜底逻辑（`$wpm <= 0` 时强制回 300）保证了配置被改坏时列表不至于算出负数分钟。

### 场景 3：借这套思路加自己的列

这个插件的"表头定位 + 防重复 + 行内特征匹配"三板斧是可以直接复用的。比如你想加一列显示文章浏览量：

```php
function myplugin_Table(&$article, &$tabletds, &$tableths)
{
 static $headerAdded = false;
 if (!$headerAdded) {
 $i = array_search('<th>' . $zbp->lang['msg']['status'] . '</th>', $tableths, true);
 if ($i !== false) {
 array_splice($tableths, $i + 1, 0, array('<th class="td10">浏览量</th>'));
 }
 $headerAdded = true;
 }
 $cell = '<td class="td10 tdCenter">' . $article->ViewNums . '</td>';
 foreach ($tabletds as $i => $td) {
 if (strpos($td, 'icon-pencil-square') !== false) {
 array_splice($tabletds, $i, 0, array($cell));
 break;
 }
 }
}
```

把 `$article->ViewNums` 换成 `Comments`（评论数）、`PostTime`（格式化后的日期）、`Author->StaticName`（作者）等任何 `Post` 对象上的属性，就能改造成你自己的信息列。核心框架完全不用动。

## 四、注意点

**1. 表头防重复不是可选项**

`Filter_Plugin_Admin_ArticleMng_Table` 是循环内触发的接口，而 `$tableths` 是循环外构建的共享引用。忘了加 `static $headerAdded` 这类防重复标记，列表里有多少篇文章就有多少个重复表头。这是这类"行级接口"最经典的翻车点，而且翻车方式特别隐蔽——你本地测试时列表只显示 1 页 1 篇文章，看不出问题，上到生产环境一页 50 篇直接炸。写这类接口时请默认按"回调会被连续调用 N 次"来设计。

**2. strip_tags 之后的字数是"纯文本字数"**

`$article->Content` 存的是带 HTML 标签的正文。`strip_tags` 剥掉标签后，代码块里的缩进空格、换行符都还在。所以严格说插件算出来的是"去标签后的字符数"而非"去空白后的字数"，会略偏大一点。对体感参考来说这个误差无伤大雅；如果你要做"精确字数统计"（比如按字数付费的写作场景），需要在统计前把空白也压掉：

```php
$text = preg_replace('/\s+/u', '', strip_tags($article->Content));
$wordCount = mb_strlen($text, 'UTF-8');
```

另外提醒一句：文章内容里如果有 UEditor 之类编辑器插入的分页符、隐藏注释，也会被一起算进去。字数列适合看量级，不适合当计费依据。

**3. 依赖"状态"列和"操作"列的存在**

表头定位靠 `array_search` 匹配语言包里的"状态"文案，数据行定位靠 `icon-pencil-square` 图标类名。这两个特征分别来自 Z-Blog 官方语言包和后台默认样式。两种极端情况会让定位失败：一是系统升级后"状态"列的 `<th>` HTML 结构变了（比如加了额外的 class 或属性包装），`array_search` 会返回 false，此时插件用 `if ($i !== false)` 兜底，表头不插但也不会报错，行照常输出——代价是"表头缺一列、数据行多一格"的错位；二是某些第三方后台主题改写了文章管理页的操作按钮图标，`icon-pencil-square` 匹配不到时，字数单元格无处可插，这一列的行数据就静默丢失。遇到这类问题先检查是否换了后台皮肤，再考虑把特征匹配换成更稳定的锚点（比如最后一个 `</tr>` 前强制插入）。

## 五、代码仓库

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

在用zblogphp写博客的人多少都有点"字数执念"：这篇稿子到底写了多少字？读者点开要花几分钟读完？可惜 Z-Blog 后台的文章管理列表默认只给你看标题、分类、日期、状态，字数这种关键信息完全靠你自己开编辑器数。文章多了以后，想快速找出那几篇"注水严重"或者"过于单薄"的内容，只能一篇篇点进去看。这篇要讲的 zb_ArticleWordCount 插件，就是给文章管理列表加一列"字数/阅读时长"，让整个内容库的健康状况一眼扫出来。

给Z-Blog PHP文章管理列表装上"体检报告"，让每篇文章的字数和阅读时长一目了然

在用zblogphp写博客的人多少都有点"字数执念"：这篇稿子到底写了多少字？读者点开要花几分钟读完？可惜 Z-Blog 后台的文章管理列表默认只给你看标题、分类、日期、状态，字数这种关键信息完全靠你自己开编辑器数。文章多了以后，想快速找出那几篇"注水严重"或者"过于单薄"的内容，只能一篇篇点进去看。这篇要讲的 zb_ArticleWordCount 插件，就是给文章管理列表加一列"字数/阅读时长

编程语言

zb_ArticleWordCount插件为Z-Blog后台文章管理列表新增"字数/阅读时长"列，通过挂载Filter_Plugin_Admin_ArticleMng_Table接口实现。基于mb_strlen统计去标签字符数，按可调阅读速度（默认300字/分钟）换算时长。包含表头防重复机制、配置缓存和边界兜底，源码注释清晰可复用。

代码解释

数据库

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

zb_ArticleWordCount插件为Z-Blog后台文章管理列表新增"字数/阅读时长"列，通过挂载Filter_Plugin_Admin_ArticleMng_Table接口实现。基于mb_strlen统计去标签字符数，按可调阅读速度（默认300字/分钟）换算时长。包含表头防重复机制、配置缓存和边界兜底，源码注...

给Z-Blog PHP文章管理列表装上"体检报告"，让每篇文章的字数和阅读时长一目了然-腾讯云开发者社区-腾讯云

给Z-Blog PHP文章管理列表装上"体检报告"，让每篇文章的字数和阅读时长一目了然

给Z-Blog PHP文章管理列表装上"体检报告"，让每篇文章的字数和阅读时长一目了然

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐