理解单一活跃订阅的需求
在某些业务场景中，商家可能希望限制用户同时只能拥有一份活跃的订阅服务。这可能是出于资源管理、业务模式限制或简化用户管理等考虑。例如，一个提供会员服务的网站可能只允许用户持有一种会员等级。
为了实现这一目标，我们通常会利用 WooCommerce 的 woocommerce_add_to_cart_validation 过滤器钩子。这个钩子在商品被添加到购物车之前执行，允许我们根据自定义逻辑来验证或阻止商品添加操作。
原始实现及其局限性
最初的实现思路是简单地检查用户是否已经拥有任何活跃订阅。如果存在，则阻止任何新的订阅产品加入购物车。以下是这种思路的典型代码结构：
add_filter('woocommerce_add_to_cart_validation', 'check_num_of_subscriptions', 10, 2);
function check_num_of_subscriptions( $valid, $product_id ) {
$product_to_add = wc_get_product( $product_id );
if ( $product_to_add instanceof WC_Product_Subscription || $product_to_add instanceof WC_Product_Variable_Subscription) {
if ( has_active_subscription() ) {
wc_clear_notices();
wc_add_notice(__('您已有一个活跃的订阅。', 'woocommerce'), 'error');
return false;
} else {
return true;
}
}
return $valid;
}
function has_active_subscription() {
$user_id = get_current_user_id();
$active_subscriptions = get_posts(array(
'numberposts' => -1,
'meta_key' => '_customer_user',
'meta_value' => $user_id,
'post_type' => 'shop_subscription',
'post_status' => 'wc-active'
));
return !empty($active_subscriptions);
}局限性分析：
上述代码能够有效地阻止用户购买第二份全新的订阅。然而，它也带来了一个严重的问题：它会阻止用户进行订阅的“升级”或“降级”操作。在 WooCommerce Subscriptions 中，升级或降级通常意味着用户将一个新的订阅产品添加到购物车，以替换或修改其现有订阅。由于上述代码简单地检查“是否有活跃订阅”，而不区分新购还是切换，因此所有涉及订阅产品添加到购物车的行为都会被阻止，这与我们希望保留的升级/降级功能相冲突。
优化方案：区分新购与切换
为了在保持单一活跃订阅规则的同时，允许用户进行订阅的升级和降级，我们需要在购物车验证逻辑中引入一个更精细的判断。核心思想是：
- 首先判断用户是否已经拥有活跃订阅。
-
如果用户有活跃订阅，则进一步判断当前尝试添加到购物车的订阅产品，是否是用户已经订阅过的产品。
- 如果用户已经订阅了当前产品（意味着这是升级或降级操作），则允许其添加到购物车。
- 如果用户没有订阅当前产品，且已有活跃订阅（意味着这是购买一份全新的、不相关的订阅），则阻止其添加到购物车。
为了实现第二点，我们可以利用 WooCommerce Subscriptions 插件提供的 WC_Subscriptions_Manager::user_has_subscription() 方法。这个方法能够可靠地检查特定用户是否订阅了某个产品。
实现代码
以下是经过优化后的完整代码片段，包含了三个辅助函数，共同实现了所需的功能：
<?php
/**
* 限制用户只能拥有一份活跃订阅，同时允许订阅升级/降级。
* 将此代码添加到主题的 functions.php 文件或自定义插件中。
*/
add_filter('woocommerce_add_to_cart_validation', 'check_num_of_subscriptions', 10, 2);
/**
* 检查用户是否可以添加订阅产品到购物车。
* 阻止新订阅，但允许现有订阅的升级/降级。
*
* @param bool $valid 当前验证结果。
* @param int $product_id 尝试添加到购物车的商品ID。
* @return bool
*/
function check_num_of_subscriptions( $valid, $product_id ){
$product_to_add = wc_get_product( $product_id );
// 仅对订阅产品或可变订阅产品进行处理
if ($product_to_add instanceof WC_Product_Subscription || $product_to_add instanceof WC_Product_Variable_Subscription){
// 如果用户已有活跃订阅，并且当前添加的商品不是用户已有订阅的商品（即非升级/降级）
if ( has_active_subscription() && (! has_woocommerce_subscription('', $product_id, '')) ) {
wc_clear_notices();
wc_add_notice(__('您已有一个活跃的订阅。', 'woocommerce'), 'error');
return false; // 阻止添加到购物车
} else {
return true; // 允许添加到购物车（要么没有活跃订阅，要么是现有订阅的切换）
}
}
return $valid; // 非订阅产品，按原逻辑处理
}
/**
* 检查当前用户是否拥有任何活跃的订阅。
*
* @return bool 如果用户有活跃订阅则返回 true，否则返回 false。
*/
function has_active_subscription(){
$user_id = get_current_user_id();
if ( ! $user_id ) {
return false; // 未登录用户不可能有活跃订阅
}
$active_subscriptions = get_posts(array(
'numberposts' => -1,
'meta_key' => '_customer_user',
'meta_value' => $user_id,
'post_type' => 'shop_subscription',
'post_status' => 'wc-active' // 只查询活跃状态的订阅
));
return !empty($active_subscriptions);
}
/**
* 检查指定用户是否订阅了某个特定的 WooCommerce 产品。
*
* @param int|string $the_user_id 用户ID，如果为空则使用当前登录用户ID。
* @param int $the_product_id 产品ID。
* @param string $the_status 订阅状态（例如 'active', 'on-hold'），空字符串表示任何状态。
* @return bool 如果用户订阅了该产品则返回 true，否则返回 false。
*/
function has_woocommerce_subscription($the_user_id, $the_product_id, $the_status) {
$current_user = wp_get_current_user();
if (empty($the_user_id)) {
$the_user_id = $current_user->ID;
}
// 使用 WooCommerce Subscriptions 官方管理器方法进行检查
if (WC_Subscriptions_Manager::user_has_subscription( $the_user_id, $the_product_id, $the_status)) {
return true;
}
return false;
}注意事项
- 代码放置： 建议将上述代码片段放置在一个自定义插件中，或者添加到您主题的 functions.php 文件中。使用自定义插件是更推荐的做法，因为它独立于主题，便于管理和更新。
- 插件依赖： 此代码片段需要 WooCommerce 和 WooCommerce Subscriptions 插件的正确安装和激活才能正常工作。
-
测试： 在将此代码部署到生产环境之前，务必在开发或测试环境中进行全面的测试。测试场景应包括：
- 新用户首次购买订阅。
- 已有活跃订阅的用户尝试购买第二份不同的订阅（应被阻止）。
- 已有活跃订阅的用户尝试升级或降级其现有订阅（应被允许）。
- 取消订阅后的行为。
- 用户通知： 确保 wc_add_notice 中的错误提示信息清晰明了，能够有效引导用户理解为何无法添加商品。
- 性能考量： get_posts 查询和 WC_Subscriptions_Manager::user_has_subscription 方法在大多数情况下性能良好。对于极高并发的网站，可以考虑适当的缓存策略。
总结
通过对 woocommerce_add_to_cart_validation 钩子进行精细化控制，并结合 WC_Subscriptions_Manager::user_has_subscription 这样的官方 API，我们成功地实现了在 WooCommerce Subscriptions 中“单一活跃订阅”的业务需求，同时确保了用户可以灵活地进行订阅的升级和降级操作。这种方法兼顾了业务规则的严谨性与用户体验的流畅性，是管理复杂订阅模式的有效策略。
