WooCommerce订阅：支持单活跃与升级降级

本文深入探讨了在WooCommerce Subscriptions中实现“单活跃订阅”并允许升级/降级的解决方案。针对某些业务场景，限制用户同时拥有多个活跃订阅至关重要。本文分析了传统方法的局限性，即简单阻止用户购买新订阅会影响升级/降级体验。文章重点介绍了如何通过定制`woocommerce_add_to_cart_validation`钩子，区分用户是购买全新订阅还是进行升级/降级操作。通过结合`WC_Subscriptions_Manager::user_has_subscription()`方法，实现精准控制，既满足了单活跃订阅的业务需求，又保证了用户升级/降级的灵活性。文中提供了详细的代码示例和注意事项，帮助开发者在WooCommerce商店中有效管理订阅服务，提升用户体验。

本教程详细阐述如何在 WooCommerce Subscriptions 中配置用户只能拥有一份活跃订阅，同时确保订阅的升级和降级功能不受影响。通过定制购物车验证逻辑，我们识别并区分用户是尝试购买新的订阅，还是对其现有订阅进行切换操作，从而实现精确的业务规则控制，提升用户体验。

理解单一活跃订阅的需求

在某些业务场景中，商家可能希望限制用户同时只能拥有一份活跃的订阅服务。这可能是出于资源管理、业务模式限制或简化用户管理等考虑。例如，一个提供会员服务的网站可能只允许用户持有一种会员等级。

为了实现这一目标，我们通常会利用 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 中，升级或降级通常意味着用户将一个新的订阅产品添加到购物车，以替换或修改其现有订阅。由于上述代码简单地检查“是否有活跃订阅”，而不区分新购还是切换，因此所有涉及订阅产品添加到购物车的行为都会被阻止，这与我们希望保留的升级/降级功能相冲突。

优化方案：区分新购与切换

为了在保持单一活跃订阅规则的同时，允许用户进行订阅的升级和降级，我们需要在购物车验证逻辑中引入一个更精细的判断。核心思想是：

1. 首先判断用户是否已经拥有活跃订阅。
2. 如果用户有活跃订阅，则进一步判断当前尝试添加到购物车的订阅产品，是否是用户已经订阅过的产品。
   • 如果用户已经订阅了当前产品（意味着这是升级或降级操作），则允许其添加到购物车。
   • 如果用户没有订阅当前产品，且已有活跃订阅（意味着这是购买一份全新的、不相关的订阅），则阻止其添加到购物车。

为了实现第二点，我们可以利用 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 中“单一活跃订阅”的业务需求，同时确保了用户可以灵活地进行订阅的升级和降级操作。这种方法兼顾了业务规则的严谨性与用户体验的流畅性，是管理复杂订阅模式的有效策略。

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