本文介绍在wordpress中，当用户角色变为“unsubscribed”时，自动将其已发布的自定义文章状态更改为“draft”，从而实现订阅失效后内容自动下线的功能。
本文介绍在wordpress中，当用户角色变为“unsubscribed”时，自动将其已发布的自定义文章状态更改为“draft”，从而实现订阅失效后内容自动下线的功能。
在基于 WooCommerce Subscriptions 构建的付费内容站点中，常需确保仅活跃订阅用户的内容对外可见。一种可靠策略是：当用户取消订阅（即被赋予 unsubscribed 角色）时，立即将其名下已发布的自定义文章（如 product_listing、member_post 等）状态由 publish 改为 draft，使其从前台消失且不可被搜索引擎索引。
实现该逻辑的核心在于监听用户角色变更事件。WordPress 提供了 add_user_role 钩子——它在用户新增获得某一角色时触发（注意：不适用于角色被移除或替换的场景）。因此，我们需确保业务流程中，“取消订阅”操作明确调用了 WP_User::add_role('unsubscribed')（例如通过 WooCommerce Subscriptions 的 woocommerce_subscription_status_cancelled 钩子配合角色更新）。
以下是完整、可部署的代码示例（请将 'your_custom_post_type' 替换为你的实际自定义文章类型名，如 'listing'）：
add_action( 'add_user_role', 'unpublish_non_subscriber_posts', 10, 2 );
function unpublish_non_subscriber_posts( $user_id, $role ) {
// 仅当新添加的角色为 'unsubscribed' 时执行
if ( $role !== 'unsubscribed' ) {
return;
}
// 查询该用户所有已发布的指定类型文章ID（避免加载全文，提升性能）
$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',
) );
}
}
✅ 关键注意事项：
- ✦ 此方案依赖于
unsubscribed角色被显式添加（而非仅移除subscriber或customer）。建议在取消订阅回调中主动调用$user->add_role('unsubscribed')； - ✦ 若需支持角色被移除（如从
unsubscribed恢复为subscriber）后重新发布文章，应额外监听remove_user_role钩子并编写对应逻辑； - ✦ 生产环境建议增加日志记录（如使用
error_log()）或后台通知，便于审计与排查； - ✦ 对于高并发或大量历史文章的站点，可考虑异步处理（如使用 WP-Cron 延迟任务）以避免请求超时。
通过该机制，你无需手动干预，即可实现订阅生命周期与内容可见性的强一致性，显著提升会员内容管理的自动化水平与用户体验安全性。
