WooCommerce订阅：单活跃订阅与套餐切换教程

在许多WooCommerce订阅商店中，业务需求常常要求用户在同一时间只能持有一个活跃的订阅。例如，一个SaaS平台可能希望用户只能选择一个套餐级别（基础版、专业版、企业版），而不是同时拥有多个。然而，简单地通过购物车验证来阻止所有新的订阅购买，如果用户已经有活跃订阅，这会带来一个问题：它会阻止用户进行订阅的升级或降级操作。当用户尝试从一个低级订阅切换到高级订阅时，系统会将其识别为一次新的订阅购买，从而被阻止，这显然不符合预期。

核心挑战与解决方案

挑战： 如何区分用户是想购买一个全新的、与现有活跃订阅无关的第二个订阅，还是想通过购买新套餐来替换（升级/降级）其现有活跃订阅？

解决方案： 关键在于在购物车验证逻辑中引入一个额外的判断。我们不仅要检查用户是否已经拥有活跃订阅，还要进一步判断当前用户尝试添加到购物车的订阅产品是否是其当前已经订阅的产品之一。

• 如果用户已经有一个活跃订阅，并且尝试添加的产品不是其当前已订阅的产品（即，一个完全不同的新订阅），那么就阻止此操作。
• 如果用户已经有一个活跃订阅，并且尝试添加的产品是其当前已订阅的产品（这通常意味着用户正在通过购买新套餐来触发订阅的升级或降级流程），那么就允许此操作。

实现细节与代码解析

我们将利用WooCommerce提供的 woocommerce_add_to_cart_validation 钩子来拦截购物车添加操作，并执行我们的自定义逻辑。

以下是实现这一策略所需的PHP代码及其详细解析：

1. check_num_of_subscriptions 函数： 这是主要的验证函数，它挂载到 woocommerce_add_to_cart_validation 钩子。

   • 它首先检查即将添加到购物车的产品是否为订阅类型（WC_Product_Subscription 或 WC_Product_Variable_Subscription）。
   • 如果确认是订阅产品，它会调用 has_active_subscription() 检查当前用户是否有任何活跃订阅。
   • 如果用户有活跃订阅，它会进一步调用 has_woocommerce_subscription()。这个函数的作用是判断用户是否已经订阅了当前正尝试添加到购物车的这个特定产品。
   • 逻辑核心在于：if ( has_active_subscription() && (! has_woocommerce_subscription('', $product_id, '')) )。这意味着，如果用户有活跃订阅，并且即将添加的产品不是用户已经订阅的（即，这是一个全新的、不相关的订阅），那么购物车验证将失败，并显示错误消息。否则，验证通过。

2. has_active_subscription 函数： 此辅助函数用于查询当前登录用户是否拥有任何状态为 'wc-active' 的订阅。它通过 get_posts 查询 shop_subscription 帖子类型，并筛选出属于当前用户的活跃订阅。

3. has_woocommerce_subscription 函数： 这是区分“新订阅”和“升级/降级”的关键辅助函数。它利用 WooCommerce Subscriptions 插件提供的 WC_Subscriptions_Manager::user_has_subscription() 方法。这个方法能够精确地检查指定用户是否订阅了特定的产品。通过传递当前用户ID和即将添加到购物车的产品ID，我们可以判断用户是否已经拥有该产品的订阅。

完整代码示例

将以下代码片段添加到您WordPress主题的 functions.php 文件中，或者更推荐的做法是创建一个自定义插件来管理此类功能。

 -1,
        'meta_key' => '_customer_user',
        'meta_value' => $user_id,
        'post_type' => 'shop_subscription',
        'post_status' => 'wc-active' // 仅查询活跃状态的订阅
    ));
    return !empty($active_subscriptions);
}

/**
 * 检查指定用户是否订阅了特定产品。
 *
 * @param int    $the_user_id    用户ID，可选，默认为当前用户。
 * @param int    $the_product_id 产品ID。
 * @param string $the_status     订阅状态，可选。
 * @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;
    }

    // 确保 WC_Subscriptions_Manager 类存在，避免在插件未激活时报错
    if (class_exists('WC_Subscriptions_Manager') && WC_Subscriptions_Manager::user_has_subscription( $the_user_id, $the_product_id, $the_status)) {
        return true;
    }
    return false;
}

注意事项与最佳实践

• 代码放置位置： 强烈建议将此类功能代码放入一个自定义插件中，而不是直接修改主题的 functions.php。这样可以确保在主题更新时代码不会丢失，并且更好地组织功能。
• 兼容性： 此代码依赖于 WooCommerce Subscriptions 插件提供的API（特别是 WC_Subscriptions_Manager 类）。请确保您的插件版本与此代码兼容，并在生产环境部署前进行充分测试。
• 用户体验： 错误消息 (wc_add_notice) 的内容至关重要。清晰、友好的提示能够引导用户理解为何无法添加产品，并告知他们正确的操作路径（例如，前往“我的账户”页面管理订阅）。
• 全面测试： 在将此功能部署到生产环境之前，务必在开发或测试环境中进行全面的测试。测试场景应包括：
  • 首次购买订阅产品。
  • 尝试在已有活跃订阅的情况下，购买另一个不同的订阅产品（应被阻止）。
  • 尝试升级现有订阅（应被允许）。
  • 尝试降级现有订阅（应被允许）。
  • 取消订阅后，再次购买任意订阅产品。
  • 非订阅产品添加到购物车的情况（应不受影响）。
• 购物车内容： 此代码主要针对单个订阅产品添加到购物车时的验证。如果您的商店允许用户将多个订阅产品同时添加到购物车，或者存在更复杂的购物车逻辑，您可能需要调整或扩展此代码以适应这些场景。

通过上述实现，您的WooCommerce商店将能够有效地限制用户同时持有的活跃订阅数量，同时保持订阅升级和降级功能的流畅性，从而提供更灵活且符合业务需求的订阅管理体验。