WooCommerce订阅管理：单订阅与升级支持

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《WooCommerce订阅管理：单活跃订阅与升级支持》，聊聊，希望可以帮助到正在努力赚钱的你。

本教程详细介绍了如何在WooCommerce商店中实现用户只能拥有一份活跃订阅的策略，同时确保用户能够顺利进行订阅的升级或降级操作。通过修改woocommerce_add_to_cart_validation钩子，并引入额外的函数来判断用户是否已有活跃订阅以及购物车中的商品是否为其现有订阅的一部分，从而精确控制订阅商品的购买行为，避免用户拥有多份独立订阅。

在WooCommerce订阅（WooCommerce Subscriptions）插件的实际应用中，商家可能希望限制用户在任何给定时间只能拥有一份活跃订阅。例如，一个会员网站可能只提供不同级别的会员订阅，用户在成为其中一个级别的会员后，不应再购买另一个独立的会员订阅。然而，一个常见的挑战是，当实施这种限制时，往往会意外地阻止用户对其现有订阅进行升级或降级操作。本教程将提供一个解决方案，在限制用户仅拥有一个活跃订阅的同时，允许订阅的切换功能（升级或降级）。

理解核心问题与解决方案

最初的限制逻辑通常是通过woocommerce_add_to_cart_validation过滤器实现，检查用户是否已有活跃订阅。如果存在，则阻止任何新的订阅产品加入购物车。这种简单粗暴的逻辑虽然实现了“单活跃订阅”的目标，但也误伤了订阅切换的场景，因为升级或降级本质上也是将新的订阅产品加入购物车。

解决方案的关键在于，在检查用户是否已有活跃订阅的基础上，增加一个判断：当前尝试加入购物车的订阅产品，是否是用户现有活跃订阅所对应的产品。如果是，则允许加入购物车（因为这通常是订阅切换的流程）；如果不是，且用户已有活跃订阅，则阻止其购买新的独立订阅。

实现代码

以下是经过优化和测试的代码片段，您可以将其添加到您主题的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() ) {
            // 如果用户已有活跃订阅，则进一步检查尝试添加的产品是否是其现有订阅的一部分
            // 如果不是现有订阅的一部分，则阻止添加；如果是，则允许（用于升级/降级）
            if ( ! has_woocommerce_subscription('', $product_id, '') ) {
                wc_clear_notices();
                wc_add_notice(__('您已经拥有一个活跃的订阅。如需更改，请访问您的账户页面进行升级或降级。', 'woocommerce'), 'error');
                return false;
            } else {
                return true; // 允许，因为这是现有订阅的切换（升级/降级）
            }
        } else {
            return true; // 用户没有活跃订阅，允许购买
        }
    }
    return $valid; // 非订阅产品，直接返回原验证结果
}

/**
 * 检查当前用户是否拥有任何活跃的订阅。
 *
 * @return bool
 */
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' // 查找状态为 'wc-active' 的订阅
    ));

    return ! empty($active_subscriptions);
}

/**
 * 检查特定用户是否拥有特定产品的订阅。
 * 此函数利用 WooCommerce Subscriptions 提供的 API。
 *
 * @param int    $the_user_id    要检查的用户ID，如果为空则使用当前用户。
 * @param int    $the_product_id 要检查的订阅产品ID。
 * @param string $the_status     要检查的订阅状态，例如 'active'。如果为空则检查任何状态。
 * @return bool
 */
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 ( class_exists('WC_Subscriptions_Manager') && WC_Subscriptions_Manager::user_has_subscription( $the_user_id, $the_product_id, $the_status) ) {
        return true;
    }
    return false;
}

代码解析

1. check_num_of_subscriptions( $valid, $product_id ):

   • 这是核心的过滤器函数，它在商品被添加到购物车之前执行。
   • 首先，它检查尝试添加的商品是否为WooCommerce订阅产品（WC_Product_Subscription或WC_Product_Variable_Subscription）。如果不是，则直接放行。
   • 接着，调用has_active_subscription()函数判断当前用户是否已经拥有任何活跃的订阅。
   • 关键逻辑:
     • 如果用户没有活跃订阅，则允许其购买（return true）。
     • 如果用户有活跃订阅：
       • 它会进一步调用has_woocommerce_subscription('', $product_id, '')来检查用户是否已经拥有当前尝试添加到购物车的特定产品的订阅。
       • 如果has_woocommerce_subscription返回false（即用户有活跃订阅，但这个活跃订阅不是当前尝试购买的这个产品），则阻止添加，并显示错误通知。这防止了用户购买第二个独立的订阅。
       • 如果has_woocommerce_subscription返回true（即用户有活跃订阅，并且这个活跃订阅就是当前尝试购买的这个产品），则允许添加。这通常发生在用户想要切换（升级/降级）到同一系列的不同订阅计划时，WooCommerce Subscriptions 会处理旧订阅的取消和新订阅的激活。

2. has_active_subscription():

   • 这个辅助函数用于查询当前用户是否拥有任何状态为wc-active的订阅。
   • 它通过get_posts()查询shop_subscription类型的文章，并根据_customer_user元键筛选出当前用户的订阅，然后检查其post_status是否为wc-active。

3. has_woocommerce_subscription($the_user_id, $the_product_id, $the_status):

   • 这个函数是实现订阅切换兼容性的关键。它利用了WooCommerce Subscriptions插件内置的WC_Subscriptions_Manager::user_has_subscription()方法。
   • 该方法能够精确判断指定用户是否拥有某个特定产品ID的订阅，并且可以根据订阅状态进行筛选。
   • 在本教程的场景中，我们传入空的状态参数，意味着只要用户拥有该产品ID的任何状态的订阅，都会返回true，从而允许订阅切换流程的进行。

实施步骤与注意事项

1. 代码位置: 将上述代码片段添加到您WordPress主题的functions.php文件末尾。更推荐的做法是创建一个自定义插件来管理这类功能，以避免主题更新时代码丢失。
2. 测试: 在将代码部署到生产环境之前，务必在开发或测试环境中进行全面测试。
   • 测试新用户购买订阅。
   • 测试已有活跃订阅的用户尝试购买另一个独立的订阅（应被阻止）。
   • 测试已有活跃订阅的用户尝试升级或降级到另一个订阅计划（应被允许）。
3. 用户体验: 确保错误提示信息清晰明了，引导用户前往正确的页面（如“我的账户”页面）进行订阅管理。
4. 插件兼容性: 虽然此代码是基于WooCommerce Subscriptions的官方API，但与其他第三方插件的复杂交互可能会产生意外行为。在添加任何自定义代码后，请检查您的网站功能是否正常。
5. 备份: 在修改网站核心文件或添加代码之前，请务必进行完整的网站备份。

通过以上代码和详细解释，您将能够精确控制WooCommerce商店中的订阅行为，既能强制用户只能拥有一份活跃订阅，又能灵活地支持订阅的升级和降级，从而提升用户体验和业务逻辑的严谨性。

理论要掌握，实操不能落！以上关于《WooCommerce订阅管理：单订阅与升级支持》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！