本文介绍在 wordpress 中如何监听用户角色变化，当用户角色变为“unsubscribed”时，自动将其发布的自定义文章状态由“publish”更新为“draft”，从而实现订阅失效后内容自动下架。
本文介绍在 wordpress 中如何监听用户角色变化，当用户角色变为“unsubscribed”时，自动将其发布的自定义文章状态由“publish”更新为“draft”，从而实现订阅失效后内容自动下架。
在基于 WooCommerce Subscriptions 构建的付费内容站点中，常需确保仅活跃订阅用户的内容对外可见。一种高效方案是：当用户因欠费或取消而被标记为 unsubscribed 角色时，系统自动将其已发布的自定义文章（如会员专属帖子、课程笔记等）状态由 publish 改为 draft，使其从前端消失，无需人工干预。
实现该逻辑的核心在于监听用户角色变更事件。WordPress 提供了 add_user_role 动作钩子（hook），它在用户被新增赋予某个角色时触发（注意：不适用于角色被移除或替换的场景）。因此，我们需确保业务流程中确实在用户退订时为其显式添加 unsubscribed 角色（例如通过 WP_User::add_role('unsubscribed')），而非仅移除其他角色。
以下是完整、可直接集成到主题 functions.php 或插件中的实现代码：
add_action( 'add_user_role', 'unpublish_non_subscriber_posts', 10, 2 );
function unpublish_non_subscriber_posts( $user_id, $role ) {
// 仅当新添加的角色为 'unsubscribed' 时执行
if ( $role !== 'unsubscribed' ) {
return;
}
// 查询该用户所有已发布的自定义文章（请将 'your_custom_post_type' 替换为你的实际 CPT 名称）
$user_posts = get_posts( array(
'posts_per_page' => -1,
'post_type' => 'your_custom_post_type',
'post_status' => 'publish',
'author' => $user_id,
'fields' => 'ids', // 仅获取 ID，提升性能
'suppress_filters' => true, // 避免其他插件过滤干扰查询
) );
// 若无匹配文章，直接退出
if ( empty( $user_posts ) ) {
return;
}
// 批量更新每篇文章状态为 draft
foreach ( $user_posts as $post_id ) {
wp_update_post( array(
'ID' => $post_id,
'post_status' => 'draft',
) );
}
}
✅ 关键注意事项：
- 请务必将
'your_custom_post_type'替换为你实际注册的自定义文章类型名称（如'member_article'或'course_lesson'）； - 此方案依赖于
unsubscribed是一个真实存在的用户角色（需提前用add_role()注册），且退订逻辑中明确调用了$user->add_role('unsubscribed')； - 若需支持角色被移除（如从
subscriber变为无订阅角色）的场景，应改用set_user_role钩子并结合get_userdata()判断当前角色集合； - 建议配合 WP-Cron 或后台批量任务做兜底检查，防止钩子遗漏；
- 生产环境部署前，请在测试站点验证逻辑，并备份数据库。
该机制轻量、可靠，将权限控制与内容可见性深度绑定，是构建合规、自动化会员内容系统的实用范式。
