WordPress纯代码实现文章浏览量统计与标签调用的方法

准备工作与代码放置位置说明

在开始修改代码之前，请务必先通过 FTP 或者主机后台文件管理器，备份你当前主题文件夹下的 functions.php 文件。所有的代码逻辑都需要添加到该文件中。如果你使用的是子主题，请将代码添加到子主题的 functions.php 文件里，这样主题更新后代码不会丢失。为了方便后续维护，建议将所有关于浏览量的代码集中在一起放置。

第一步：添加文章浏览量统计基础函数

这一步的核心目的是创建一个函数，用于在数据库中记录文章的浏览次数。WordPress 使用 post_meta 表来存储这类自定义数据。我们需要在 functions.php 中追加以下代码：

```php function set_post_views($postID) { $count_key = 'post_views_count'; $count = get_post_meta($postID, $count_key, true); if ($count == '') { $count = 0; delete_post_meta($postID, $count_key); add_post_meta($postID, $count_key, '0'); } else { $count++; update_post_meta($postID, $count_key, $count); } } ```

这段代码定义了一个名为 set_post_views 的函数。它首先检查数据库中是否已经有 post_views_count 这个字段。如果没有，它会初始化为 0；如果已经存在，则将数值加 1 并更新回数据库。请确保将此代码完整复制并粘贴到 functions.php 的 ?> 结束标签之前。

第二步：解决统计逻辑的触发问题

仅仅定义函数是不够的，我们需要让 WordPress 在加载文章页面时自动执行这个函数。最稳妥的方法是利用 WordPress 的 wp_head 钩子。请在 functions.php 中继续添加以下代码：

```php function track_post_views($post_id) { if (!is_single()) { return; } if (empty($post_id)) { global $post; $post_id = $post->ID; } set_post_views($post_id); } add_action('wp_head', 'track_post_views'); ```

这里我们定义了 track_post_views 函数并将其挂载到 wp_head。代码中包含了一个判断 if (!is_single())，这非常关键，它确保了只有在文章详情页才会触发统计，避免在首页或列表页刷新时产生无效的重复计数。通过 add_action，每次页面头部加载时都会自动运行这段逻辑。

第三步：获取并显示浏览量的函数

现在数据库里有了数据，我们需要一个函数来把这些数据读取出来并在前端显示。请在 functions.php 中添加获取函数：

```php function get_post_views($postID) { $count_key = 'post_views_count'; $count = get_post_meta($postID, $count_key, true); if ($count == '') { delete_post_meta($postID, $count_key); add_post_meta($postID, $count_key, '0'); return "0 次浏览"; } return $count . ' 次浏览'; } ```

这个 get_post_views 函数用于读取指定 ID 文章的浏览量。如果读取不到数据，默认返回 "0 次浏览"。你可以根据需要修改返回的字符串格式，比如将 "次浏览" 修改为图标或英文 "Views"。

第四步：在主题模板文件中调用标签

函数已经准备就绪，接下来需要在主题的模板文件中输出它。通常我们需要在文章详情页（single.php）和列表页（如 index.php 或 category.php）显示浏览量。

打开你的 single.php 文件，找到你希望显示浏览量的位置（通常在标题下方或作者信息旁边），插入以下代码：

```php ```

如果你是在 index.php 或其他循环列表文件中调用，请确保代码放在 while (have_posts()) : the_post(); ?> 循环内部。因为在循环内部，get_the_ID() 可以自动获取当前文章的 ID，无需手动传参。插入位置建议紧跟在发布时间或评论数后面，保持排版整齐。

第五步：实现文章内容编辑器内短代码调用

除了修改模板文件，有时候你可能希望在文章内容的正文中手动插入浏览量，或者在使用页面构建器时调用。这时我们需要注册一个短代码。在 functions.php 中添加：

```php function post_views_shortcode() { return get_post_views(get_the_ID()); } add_shortcode('views', 'post_views_shortcode'); ```

添加这段代码后，你只需要在 WordPress 后台编辑文章时，在任意位置输入 [views]，系统就会自动将该标签替换为当前文章的实际浏览量数字。这对于不想修改 PHP 模板文件的用户来说非常方便。

第六步：优化细节（排除管理员与防刷）

目前的代码有一个问题：管理员每刷新一次页面，浏览量都会增加。为了数据准确性，我们需要排除已登录的管理员，并增加简单的防刷机制。请修改之前的 track_post_views 函数，替换为以下优化后的代码：

```php function track_post_views($post_id) { if (!is_single()) { return; } if (empty($post_id)) { global $post; $post_id = $post->ID; } // 排除管理员和编辑的浏览 if (current_user_can('edit_posts')) { return; } // 简单的 Cookie 防刷，24小时内同一IP不重复计数 if (isset($_COOKIE['post_viewed_' . $post_id])) { return; } set_post_views($post_id); // 设置 Cookie，有效期 86400 秒（24小时） setcookie('post_viewed_' . $post_id, 'true', time() + 86400, '/'); } ```

这里增加了两个关键判断：current_user_can('edit_posts') 用于检查当前用户是否有编辑文章的权限，如果有（通常是管理员或编辑），则直接返回不计数。isset($_COOKIE[...]) 检查浏览器是否存有一个名为 "post_viewed_文章ID" 的 Cookie。如果有，说明今天已经看过，不再计数；如果没有，计数后通过 setcookie 设置一个 24 小时过期的 Cookie。这能有效防止同一个人频繁刷新增加无效浏览量。

第七步：按浏览量排序实现热门文章列表

有了浏览量数据，我们通常需要在侧边栏展示“热门文章”。这可以通过 WP_Query 自定义查询来实现。你可以在 sidebar.php 或者任何你想显示列表的地方添加以下代码块：

```php

热门文章

'post', 'posts_per_page' => 5, // 显示数量 'meta_key' => 'post_views_count', 'orderby' => 'meta_value_num', // 按数值排序 'order' => 'DESC' // 降序 ); $query = new WP_Query($args); if ($query->have_posts()) : while ($query->have_posts()) : $query->the_post(); ?>
• （）
• 暂无数据

```

这段代码的核心在于 $args 数组配置。'meta_key' => 'post_views_count' 告诉 WordPress 去查找我们之前存储浏览量的字段。'orderby' => 'meta_value_num' 非常重要，它指定了按照数字大小排序，而不是按照字符串字母顺序排序（否则 9 会排在 10 之后）。wp_reset_post_data() 必须在循环结束后调用，以确保这个自定义查询不会破坏页面其他地方的文章显示逻辑。