WordPress 获取当前作者文章总浏览量的实现方法

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

前言

在开发 WordPress 主题（例如用户中心）时，经常需要展示作者的文章总浏览量。上一篇文章介绍了如何获取指定作者的文章总浏览量，本文将详细讲解如何获取当前作者（即当前页面或循环中对应的作者）的文章总浏览量。

核心功能函数

以下是一个封装好的函数，用于获取并输出指定作者的所有文章浏览量总和。该函数通过直接查询数据库的方式实现，效率较高。

// WordPress 获取指定作者文章浏览总数
if (!function_exists('cx_posts_views')) {
    function cx_posts_views($author_id = 1, $display = true) {
        global $wpdb;
        // 构建 SQL 查询语句，统计特定作者所有文章的 'views' 元字段值之和
        $sql = $wpdb->prepare(
            "SELECT SUM(meta_value+0) FROM {$wpdb->posts} 
            LEFT JOIN {$wpdb->postmeta} ON ({$wpdb->posts}.ID = {$wpdb->postmeta}.post_id) 
            WHERE meta_key = 'views' AND post_author = %d",
            $author_id
        );
        $total_views = intval($wpdb->get_var($sql));
        
        if ($display) {
            // 直接输出格式化后的数字（如 1,234）
            echo number_format_i18n($total_views);
        } else {
            // 返回整型数值，供其他逻辑使用
            return $total_views;
        }
    }
}

函数参数说明

$author_id (整数)：作者的ID。默认值为1。
$display (布尔值)：控制函数行为。为 true 时直接输出浏览量；为 false 时返回浏览量数值。

安全性与性能说明

安全性：原始代码中的 SQL 语句存在 SQL 注入风险。修正后的代码使用了 $wpdb->prepare() 方法对作者ID进行参数化处理，这是 WordPress 推荐的安全做法。
性能：此方法直接对数据库进行聚合查询。如果网站文章量极大，频繁调用可能影响性能。建议考虑结合缓存机制（如 Transients API）进行优化。
前提：此函数假设文章的浏览数据保存在名为 views 的自定义字段（Post Meta）中。请确保你的主题或插件使用此字段名记录浏览量。

使用方法

按照以下两步操作，即可在主题中显示当前作者的文章总浏览量。

步骤一：添加函数到主题

将上面的 cx_posts_views 函数代码复制到当前主题的 functions.php 文件中。

步骤二：在模板中调用函数

在需要显示当前作者总浏览量的模板文件（例如 author.php, single.php 或在主循环中）中，插入以下调用代码：

<?php 
// 获取当前作者ID并输出其文章总浏览量
if (function_exists('cx_posts_views')) {
    cx_posts_views(get_the_author_meta('ID'));
}
?>

或者，如果你需要将数值赋给一个变量用于其他计算，可以这样调用：

<?php 
// 获取当前作者ID并返回其文章总浏览量（不直接输出）
if (function_exists('cx_posts_views')) {
    $author_total_views = cx_posts_views(get_the_author_meta('ID'), false);
    // 现在你可以使用 $author_total_views 变量
    echo '总阅读：' . number_format_i18n($author_total_views);
}
?>

总结与扩展建议

本文提供的方法是一个基础且有效的解决方案，适用于大多数使用自定义字段记录浏览量的场景。为了获得更好的性能和可维护性，你可以考虑以下扩展方向：

使用缓存：通过 WordPress 的 Transients API 缓存查询结果，例如缓存12小时，可以显著降低数据库查询压力。
创建短代码：将功能封装成短代码（如 [author_views]），方便在文章或页面编辑器中调用。
集成到用户查询：修改 WP_User_Query 或通过在作者信息中存储总浏览数，避免在列表页多次查询数据库。

通过上述方法，你可以灵活地在 WordPress 站点的任何位置展示当前作者的影响力指标。

前言