WordPress 分类目录总浏览量统计：实现方法与代码详解

2020-05-11 · Ryan · 发表评论

前言

在 WordPress 网站运营中，统计分类目录（或标签、自定义分类法）的总浏览量是一个常见的需求，它有助于分析不同主题内容的受欢迎程度。本文将详细介绍如何通过代码实现这一功能，并提供完整的实现方案与调用方法。

核心功能实现

实现原理是为每个分类法术语（term）创建一个自定义元字段（_views），用于存储其累计浏览量。当用户访问该分类页面时，浏览量自动加1。

步骤一：添加核心函数到主题

请将以下 PHP 代码添加到您当前使用主题的 functions.php 文件末尾。

/**
 * 获取指定分类法术语的浏览量
 * @param int $term_id 术语ID，为空则自动获取当前查询对象的ID
 * @return int 返回浏览量，默认为0
 */
function fa_get_tax_views($term_id = null) {
    // 如果未提供term_id，则尝试获取当前查询对象（如分类页）的ID
    if (!$term_id) {
        $term = get_queried_object();
        if ($term && isset($term->term_id)) {
            $term_id = $term->term_id;
        }
    }
    // 如果仍然没有term_id，则返回0
    if (!$term_id) {
        return 0;
    }
    // 获取存储的浏览量，不存在则返回0
    $view = (int) get_term_meta($term_id, '_views', true);
    return $view;
}

/**
 * 为当前访问的分类法术语增加一次浏览量
 * 此函数在页面头部加载时执行
 */
function fa_set_tax_views() {
    // 仅在对分类法归档页面（如分类目录、标签页）生效
    if (!is_tax() && !is_category() && !is_tag()) {
        return;
    }
    $term = get_queried_object();
    if (!$term || !isset($term->term_id)) {
        return;
    }
    $term_id = $term->term_id;
    $current_views = fa_get_tax_views($term_id);
    // 浏览量加1并更新
    update_term_meta($term_id, '_views', $current_views + 1);
}
// 将浏览量统计函数挂载到 WordPress 的 'get_header' 动作上
add_action('get_header', 'fa_set_tax_views');

代码功能说明

fa_get_tax_views：这是一个获取函数。它接收一个可选的术语ID参数。如果未提供，它会自动尝试获取当前页面（如分类页）对应的术语ID，然后从数据库的 termmeta 表中查询 _views 字段的值并返回。
fa_set_tax_views：这是一个设置/更新函数。它通过 get_queried_object() 确定当前访问的是哪个分类页面，然后调用获取函数得到当前浏览量，并为其加1后更新回数据库。
add_action：这行代码将更新函数 fa_set_tax_views 绑定到 WordPress 的 get_header 钩子上。这意味着每当网站页面开始加载头部时，都会尝试执行一次浏览量累加操作。

步骤二：在前台模板中调用显示

添加上述代码后，浏览量统计功能已在后台运行。接下来，您需要在主题模板的适当位置插入调用代码，以在前台显示统计数字。

调用方法

在您希望显示浏览量的模板文件（例如分类归档页面模板 archive.php、category.php 或侧边栏文件 sidebar.php）中，找到合适的位置，插入以下 PHP 代码：

<?php echo fa_get_tax_views(); ?>

例如，您可以在分类标题下方添加：

<div class="term-views">
    本分类总浏览量：<?php echo fa_get_tax_views(); ?>
</div>

进阶用法：获取指定分类的浏览量

如果您想在非分类页面上（如首页、文章页）显示某个特定分类的浏览量，可以直接传入分类ID：

<?php echo fa_get_tax_views(5); // 假设分类ID为 5 ?>

注意事项与优化建议

性能考虑：本方法简单直接，但对于高流量网站，每次页面加载都更新数据库可能会带来性能压力。可以考虑结合缓存机制或使用更高效的统计方案。
适用范围：代码默认支持内置的“分类目录”（category）和“标签”（tag）。通过修改 fa_set_tax_views 函数中的条件判断 is_tax()，可以使其支持所有自定义分类法。
数据初始化：对于已存在的分类，首次使用此功能时，其 _views 元字段值为空，函数会将其视为0。统计将从代码激活后开始累计。
代码安全：请务必将代码添加到子主题的 functions.php 文件中，以避免主题更新时被覆盖。

总结

通过以上两个核心函数和一行调用代码，您就可以轻松为 WordPress 网站的分类目录添加总浏览量统计功能。此方法扩展性强，稍作修改即可用于标签、自定义分类法甚至作者页面，是进行网站内容数据分析的一个实用工具。

前言