别瞎搞!WordPress积分阅读从零搭建全攻略

网站做好了没人访问，是不是让你夜不能寐？流量像石沉大海，内容发了一堆，后台数据却纹丝不动。很多老板觉得是推广没跟上，其实是网站本身缺乏“钩子”。今天咱们不聊虚的，直接上干货，教你如何在 WordPress 上从零搭建一套积分阅读系统。这套玩法的核心逻辑很简单：用户想阅读全文？先干活。关注公众号、转发朋友圈、或者完成一个小任务，积分到账，内容解锁。这不仅能筛选出高价值用户，还能把公域流量死死扣在你的私域池子里。

需求分析与选型避坑

在动手之前，得先想清楚你要什么。市面上做 WordPress 积分阅读的插件不少，比如 Members、Paid Memberships Pro，还有专门做阅读积分的插件。但大多数付费插件要么贵，要么功能臃肿，动不动就要你买年度订阅。对于咱们这种追求性价比、想快速落地的运营人员来说，自己写或者找轻量级开源方案才是正道。

很多四川本地的企业站，特别是做本地生活服务或者技术分享类的，特别需要这种机制。比如你写了一篇《成都高新区公司注册避坑指南》，核心干货在最后。用户不注册、不关注你的微信，就只让他看前 30%。这就是典型的“积分阅读”场景。

这里有个常见的误区：很多人以为积分阅读就是收费阅读。大错特错。收费是交易，积分是行为。用户花 9.9 元买断是交易；用户转发文章得 10 积分，积分兑换全文阅读权限，这是行为激励。前者转化率低，但客单价高；后者转化率高，能极大增加用户粘性。对于 SEO 来说，用户停留时间越长、互动越多，搜索引擎越喜欢你的站。积分阅读正好解决了“跳出率高”这个 SEO 大忌。

我们要达到的效果是：

内容分级：免费部分吸引眼球，核心部分设置门槛。
行为绑定：阅读权限与用户动作（注册、分享、评论）挂钩。
数据留存：知道哪些用户完成了动作，方便后续营销。

环境准备与服务器配置

工欲善其事，必先利其器。WordPress 本身不原生支持复杂的积分逻辑，我们需要借助 PHP 脚本和数据库来扩展功能。

第一步：确认服务器环境 去你的服务器控制台看一眼 PHP 版本。现在主流推荐 PHP 8.0 以上，性能更好，安全性更高。如果你还在用 PHP 7.4，建议趁这次升级一下。怎么升？以阿里云为例，登录 阿里云官方文档 查找 ECS 实例的 PHP 版本升级指南，里面详细写了如何通过 yum 或 apt 切换版本，以及重启 PHP-FPM 服务的命令。别手动去改配置文件，容易改崩，跟着云厂商的官方文档走最稳妥。

第二步：备份数据库 这一步至关重要！在动任何代码之前，必须备份数据库。如果你用的是宝塔面板，直接在数据库管理里点“备份”；如果是命令行，用 mysqldump 命令。

mysqldump -u root -p your_db_name > backup_before_points.sql

万一代码写挂了，没备份就是灾难现场。我见过太多新手，改一行代码没备份，结果全站白屏，哭都来不及。

第三步：开发环境搭建 不要在正式站上直接测试！找一个本地环境，或者服务器的一个子目录，用 WordPress 测试站来跑通全流程。你可以用 Local WP 或者 MAMP 在本地搭一个环境，域名指向本地，这样怎么折腾都不怕。

核心步骤：从零搭建积分逻辑

接下来是硬核部分。我们不用复杂的插件，直接通过 WordPress 的钩子（Hooks）来实现。这样代码轻量，不拖慢网站速度。

1. 数据库表设计 我们需要一张表来存储用户的积分变动记录。在 WordPress 的数据库里新建一张表 wp_user_points_log。

CREATE TABLE wp_user_points_log (id BIGINT(20) NOT NULL AUTO_INCREMENT,user_id BIGINT(20) NOT NULL,points INT(11) NOT NULL DEFAULT 0,action VARCHAR(50) NOT NULL,created_at DATETIME DEFAULT CURRENT_TIMESTAMP,PRIMARY KEY (id),KEY user_id (user_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

这张表记录了谁、在什么时候、因为什么行为、获得了多少积分。

2. 积分增减函数 在主题的 functions.php 或者自定义插件文件里，加入以下代码。这段代码负责处理积分的增加和减少，并写入数据库。

<?php
// 添加积分
function add_user_points($user_id, $points, $action) {global $wpdb;// 验证用户是否存在if (!get_user_by('id', $user_id)) {return false;}// 插入日志$wpdb->insert('wp_user_points_log',array('user_id' => $user_id,'points' => $points,'action' => $action));// 这里可以触发 AJAX 更新前端显示wp_send_json_success(array('points' => $points));
}// 获取用户总积分
function get_user_total_points($user_id) {global $wpdb;return $wpdb->get_var("SELECT SUM(points) FROM wp_user_points_log WHERE user_id = $user_id");
}
?>

3. 内容截断与权限判断 这是实现“积分阅读”的关键。我们需要在文章输出时，判断用户是否有足够积分，或者是否已解锁。如果没有，就截断内容，并显示“解锁”按钮。

<?php
// 在 the_content 过滤器中截断内容
function truncate_content_for_points($content) {// 仅对已登录用户且文章类型为 post 时生效if (!is_user_logged_in() || !is_single('post')) {return $content;}$user_id = get_current_user_id();$total_points = get_user_total_points($user_id);// 假设解锁一篇核心文章需要 100 积分$required_points = 100;// 检查是否已经解锁过（这里简化处理，实际可查另一张解锁记录表）$is_unlocked = has_user_unlocked_post($user_id, get_the_ID());if ($is_unlocked || $total_points >= $required_points) {return $content; // 显示全文} else {// 截取前 20% 的内容$post_content = get_the_content();$length = strlen($post_content);$cut_point = (int)($length * 0.2);$short_content = substr($post_content, 0, $cut_point);$unlock_button = '<div class="points-unlock-box"><p>剩余内容需 100 积分解锁，当前积分：' . $total_points . '</p><button id="unlock-btn" data-post-id="' . get_the_ID() . '">立即解锁</button></div>';return $short_content . $unlock_button;}
}
add_filter('the_content', 'truncate_content_for_points');// 辅助函数：检查是否已解锁
function has_user_unlocked_post($user_id, $post_id) {global $wpdb;$result = $wpdb->get_var("SELECT COUNT(*) FROM wp_post_unlocks WHERE user_id = $user_id AND post_id = $post_id");return $result > 0;
}
?>

注意：上面代码中引用了 wp_post_unlocks 表，你需要在数据库里也创建这张表，结构类似 wp_user_points_log，但主键是 user_id 和 post_id 的组合。

代码配置与前端交互

后端逻辑通了，还得让前端能操作。用户点了“立即解锁”，得真的能扣积分并解锁内容。这就需要用到 AJAX。

1. 前端 JavaScript 逻辑 在主题的 js 文件夹里新建一个 points.js，引入到前端。

document.addEventListener('DOMContentLoaded', function() {const unlockBtn = document.getElementById('unlock-btn');if (unlockBtn) {unlockBtn.addEventListener('click', function() {const postId = this.dataset.postId;const spinner = document.createElement('span');spinner.innerHTML = '解锁中...';this.appendChild(spinner);this.disabled = true;fetch(ajaxurl, {method: 'POST',headers: { 'Content-Type': 'application/x-www-form-urlencoded' },body: 'action=unlock_post&post_id=' + postId}).then(response => response.json()).then(data => {if (data.success) {alert('解锁成功！正在刷新页面...');location.reload();} else {alert('解锁失败：' + data.data.message);this.disabled = false;this.removeChild(spinner);}}).catch(error => {console.error('Error:', error);alert('网络错误，请重试');this.disabled = false;this.removeChild(spinner);});});}
});

2. 后端 AJAX 处理 回到 PHP 文件，添加处理 AJAX 请求的逻辑。

<?php
// 处理解锁文章的 AJAX 请求
function handle_unlock_post_ajax() {// 安全验证：必须登录if (!is_user_logged_in()) {wp_send_json_error(array('message' => '请先登录'));}$user_id = get_current_user_id();$post_id = isset($_POST['post_id']) ? intval($_POST['post_id']) : 0;if (!$post_id) {wp_send_json_error(array('message' => '参数错误'));}// 检查是否已解锁if (has_user_unlocked_post($user_id, $post_id)) {wp_send_json_error(array('message' => '您已经解锁过这篇文章'));}// 检查积分是否足够$required_points = 100;$current_points = get_user_total_points($user_id);if ($current_points < $required_points) {wp_send_json_error(array('message' => '积分不足，请完成任务获取积分'));}// 扣除积分$wpdb->insert('wp_user_points_log',array('user_id' => $user_id,'points' => -$required_points, // 负数表示扣除'action' => 'unlock_post_' . $post_id));// 记录解锁状态$wpdb->insert('wp_post_unlocks',array('user_id' => $user_id,'post_id' => $post_id));wp_send_json_success(array('message' => '解锁成功'));
}
add_action('wp_ajax_unlock_post', 'handle_unlock_post_ajax');
?>

3. 获取积分的任务入口 光能扣积分不行，还得让用户有地方赚积分。最简单的就是绑定微信关注。你可以写一个函数，检测用户是否关注了公众号（通过微信服务器接口），如果关注了，调用 add_user_points 函数给他加积分。这部分涉及微信开发，建议参考微信开放文档，逻辑不复杂，主要是接口鉴权的问题。

常见报错与排错指南

在实操过程中，我遇到过不少坑，这里分享几个最常见的，帮你省时间。

1. undefined variable: ajaxurl 这是 WordPress 里最经典的报错。原因是你在前端 JS 里用了 ajaxurl，但没把它传给前端。解决：在 wp_enqueue_scripts 钩子里，用 wp_localize_script 把 ajaxurl 传给前端。

function localize_ajax_url() {wp_localize_script('my-script', 'wp_ajax_vars', array('ajaxurl' => admin_url('admin-ajax.php'),'nonce' => wp_create_nonce('my_nonce')));
}
add_action('wp_enqueue_scripts', 'localize_ajax_url');

2. 积分扣了，但内容没解锁 这种情况通常是 has_user_unlocked_post 函数查询失败。检查一下 wp_post_unlocks 表是否创建成功，字段名是否对得上。另外，注意事务处理，如果插入 wp_user_points_log 成功，但插入 wp_post_unlocks 失败，就会出现积分没了但没解锁的情况。建议在关键操作加上数据库事务（$wpdb->query("START TRANSACTION") 和 COMMIT/ROLLBACK）。

3. 跨域问题 如果你的前端 JS 是单独部署在 CDN 上，而 AJAX 请求是发给主站，可能会遇到 CORS 跨域问题。解决：最简单的方法是让 JS 和 WordPress 在同域下，或者在 Nginx/Apache 配置里允许 CORS 头。参考 阿里云官方文档 中关于 Nginx 配置 CORS 的章节，添加 add_header Access-Control-Allow-Origin *; 等指令。

4. 性能问题 如果文章量大，每次加载都查数据库计算总积分，速度会很慢。解决：在用户表中加一个 total_points 字段，缓存当前总积分。每次增减积分时，同时更新这个字段。查询时直接读用户表，速度快几个数量级。