WordPress文章真实浏览量统计优化：避免刷新重复计数

现有代码的核心问题 #

• 重复注册了track_post_views到wp_head钩子，导致函数可能执行两次，是刷新重复计数的直接原因之一。
• Cookie配置不完整，缺少httponly、secure属性（HTTPS站点需要），且未指定域名，可能导致Cookie在部分场景下无法正确识别。
• 未排除后台管理员/编辑用户的访问，这类用户的编辑预览不应该计入真实浏览。
• 仅依赖Cookie，用户清除浏览器Cookie后会重复计数，登录用户可结合用户元数据实现更持久的去重。

优化后的完整实现代码 #

1. 核心计数函数 #

// 获取文章浏览量
function get_post_view_count($postID) {
    $key = 'post_views_count';
    $count = get_post_meta($postID, $key, true);
    return empty($count) ? '0' : $count;
}

// 追踪浏览量逻辑
function track_post_views() {
    // 排除非单页、后台用户、机器人
    if (!is_single() || is_admin() || wp_doing_cron() || is_robots()) {
        return;
    }

    global $post;
    $post_id = $post->ID;
    $user_id = get_current_user_id();
    $cookie_name = 'viewed_post_' . $post_id;

    // 已登录用户：用用户元数据记录已浏览的文章
    if ($user_id > 0) {
        $viewed_posts = get_user_meta($user_id, 'viewed_posts', true);
        $viewed_posts = is_array($viewed_posts) ? $viewed_posts : [];
        
        if (!in_array($post_id, $viewed_posts)) {
            update_post_view_count($post_id);
            $viewed_posts[] = $post_id;
            update_user_meta($user_id, 'viewed_posts', $viewed_posts);
        }
        return;
    }

    // 未登录用户：用Cookie记录，有效期设为30天（可调整）
    if (!isset($_COOKIE[$cookie_name])) {
        update_post_view_count($post_id);
        
        // 配置完整的Cookie参数
        $cookie_expire = time() + 30 * 24 * 3600;
        $cookie_path = '/';
        $cookie_domain = COOKIE_DOMAIN; // WordPress内置常量，自动适配站点域名
        $cookie_secure = is_ssl(); // HTTPS站点自动启用secure
        $cookie_httponly = true; // 防止XSS窃取Cookie

        setcookie($cookie_name, '1', $cookie_expire, $cookie_path, $cookie_domain, $cookie_secure, $cookie_httponly);
    }
}
// 移除重复的钩子，只注册一次
add_action('wp_footer', 'track_post_views'); // 改用wp_footer，避免wp_head可能的缓存提前输出问题

// 更新浏览量的通用函数
function update_post_view_count($post_id) {
    $key = 'post_views_count';
    $count = get_post_meta($post_id, $key, true);
    
    if (empty($count)) {
        add_post_meta($post_id, $key, 1, true);
    } else {
        update_post_meta($post_id, $key, $count + 1);
    }
}

2. single.php调用代码 #

<?php echo '👁️ ' . get_post_view_count(get_the_ID()) . ' views'; ?>

关键优化点说明 #

• 移除重复钩子：删除了重复的add_action('wp_head', 'track_post_views');，避免函数重复执行。
• 改用wp_footer钩子：相比wp_head，wp_footer执行时机更靠后，能确保Cookie设置不会被页面缓存提前拦截。
• 排除无效访问：过滤掉后台用户、机器人、定时任务等非真实浏览场景，提升计数准确性。
• 分场景去重：
  • 已登录用户：用用户元数据记录已浏览文章，永久去重（除非用户手动清除）。
  • 未登录用户：用配置完整的Cookie记录，有效期可根据需求调整（示例为30天）。
• Cookie参数优化：使用WordPress内置常量COOKIE_DOMAIN适配域名，自动识别HTTPS设置secure属性，开启httponly提升安全性。

额外建议 #

• 如果站点使用缓存插件（如WP Rocket、W3 Total Cache），需要确保浏览计数逻辑不被缓存，可将计数输出改为AJAX异步请求，避免缓存页面导致计数不更新。
• 若需要更精准的用户识别，可结合IP地址+浏览器指纹的方式，但需注意隐私合规（如GDPR）。

内容的提问来源于stack exchange，提问作者Ahmad Reza