WordPress 如何获取并显示站点文章总访问量（浏览量）

2020-05-08 · Ryan

许多 WordPress 主题会在网站底部或侧边栏展示站点总访问量，这对于展示博客的受欢迎程度很有帮助。本文将介绍一种通过自定义函数获取 WordPress 站点所有文章浏览量的方法，并说明如何在前端调用显示。

核心代码：获取总浏览量的函数

将以下 PHP 代码添加到您当前使用的 WordPress 主题的 functions.php 文件末尾。此函数会查询数据库中所有文章的“views”自定义字段（假设您的浏览量数据存储在此字段中），并将其累加得到总访问量。

/**
 * 获取 WordPress 站点所有文章的总浏览量
 *
 * 此函数通过查询 `postmeta` 表中 `meta_key` 为 'views' 的记录，
 * 并累加其 `meta_value` 值来计算总浏览量。
 *
 * @return int 返回站点总浏览量的整数值。
 */
function get_total_site_views() {
    global $wpdb;
    $total_count = 0;

    // 查询所有 meta_key 为 'views' 的文章元数据
    $view_records = $wpdb->get_results("SELECT meta_value FROM {$wpdb->postmeta} WHERE meta_key = 'views'");

    // 遍历结果并累加浏览量
    foreach ( $view_records as $record ) {
        $view_count = $record->meta_value;
        // 确保值为有效数字再进行累加
        if ( is_numeric( $view_count ) ) {
            $total_count += (int) $view_count;
        }
    }

    return $total_count;
}

代码说明与注意事项

函数名：示例中使用了 get_total_site_views()，您可以根据需要修改，但需确保调用时一致。
数据字段：此代码假设您的每篇文章的浏览量存储在名为 views 的自定义字段（Custom Field）中。这是许多流行统计插件（如 WP-PostViews）或主题的默认字段名。请根据您的实际情况确认字段名。
性能考虑：如果您的网站文章数量巨大，频繁调用此函数可能会对数据库造成压力。建议结合缓存机制（如 WordPress Transients API）使用，例如将结果缓存数小时。

使用方法：在前端显示总访问量

在主题模板文件中（例如 footer.php, sidebar.php 或任何你想显示的位置），使用以下代码调用并输出总浏览量。

<?php
// 调用函数并输出结果
echo number_format( get_total_site_views() );
?>

说明：这里使用了 PHP 的 number_format() 函数对输出结果进行格式化，例如将“123456”显示为“123,456”，以提高可读性。

进阶优化：添加数据缓存

为了避免每次页面加载都执行数据库查询，我们可以使用 WordPress 的瞬态（Transient）API 来缓存结果。以下是优化后的函数版本：

/**
 * 获取带缓存的站点总浏览量
 *
 * 数据默认缓存12小时，以提高网站性能。
 *
 * @return int 返回站点总浏览量的整数值。
 */
function get_cached_total_site_views() {
    // 定义缓存的键名和有效期（12小时）
    $cache_key = 'total_site_views_cache';
    $expiration = 12 * HOUR_IN_SECONDS;

    // 尝试从缓存中获取数据
    $total_views = get_transient( $cache_key );

    // 如果缓存不存在或已过期，则重新计算
    if ( false === $total_views ) {
        global $wpdb;
        $total_views = 0;
        $view_records = $wpdb->get_results("SELECT meta_value FROM {$wpdb->postmeta} WHERE meta_key = 'views'");

        foreach ( $view_records as $record ) {
            $view_count = $record->meta_value;
            if ( is_numeric( $view_count ) ) {
                $total_views += (int) $view_count;
            }
        }
        // 将新计算的结果存入缓存
        set_transient( $cache_key, $total_views, $expiration );
    }

    return $total_views;
}

使用此优化版函数后，前端调用方式不变，只需将函数名替换为 get_cached_total_site_views() 即可。首次访问会执行查询，之后12小时内都将直接从缓存读取数据，显著提升页面加载速度。

通过以上步骤，您就可以在 WordPress 站点的任意位置展示经过准确统计和性能优化的总访问量了。