WooCommerce订阅管理：限制单活跃订阅并支持升级/降级

在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 ):

   

   小绿鲸英文文献阅读器

   英文文献阅读器，专注提高SCI阅读效率

   199

   查看详情
   • 这是核心的过滤器函数，它在商品被添加到购物车之前执行。
   • 首先，它检查尝试添加的商品是否为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订阅管理：限制单活跃订阅并支持升级/降级的详细内容，更多请关注php中文网其它相关文章！