woocommerce stripe woocommerce订单管理
本教程详细介绍了如何在 WooCommerce 商店中实现用户只能拥有一个主动订阅的策略,同时确保用户能够顺利进行订阅的升级或降级操作。通过修改 woocommerce_add_to_cart_validat ionhoo子,并引入额外的函数来判断用户是否已活跃订阅以及购物车中的商品是否已有订阅的一部分,从而精确控制订阅商品的购买行为,避免用户拥有多份独立订阅。
在woocommerce订阅(woocommerce)订阅)插件的实际应用中,商家可能希望用户在任何给定时间只能拥有一份活跃订阅。例如,一个会员网站可能只提供不同级别的会员订阅,用户在成为其中一个级别的会员后,不应再购买限制另一个独立的会员订阅。然而,一个常见的挑战是,当实施限制时,往往会意外地阻止用户其现有订阅进行升级或降级操作。本教程将提供一个限制解决方案,在用户仅拥有一个活跃订阅的同时,允许订阅的切换功能(升级或降级)。理解核心问题与解决方案
最初的限制逻辑通常是通过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' =gt; -1, 'meta_key' =gt; '_customer_user', 'meta_value' =gt; $user_id, 'post_type' =gt; 'shop_subscription', 'post_status' =gt; 'wc-active' // 查找状态为 'wc-active' 的订阅 )); 返回! 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-gt;ID; } //确定 WooCommerce 订阅插件已激活且相关类可用 if ( class_exists('WC_Subscriptions_Manager') amp;amp; WC_Subscriptions_Manager::user_has_subscription( $the_user_id, $the_product_id, $the_status) ) { return true; } return false;}登录后复制代码解析
check_num_of_subscriptions( $valid, $product_id ):这是核心的过滤器函数,它在商品被添加到购物车之前执行。首先,它检查尝试添加的商品是否为WooCommerce订阅产品(WC_Product_Subscription或WC_Product_Variable_Subscription)。如果不是,则直接放行。接着,调用has_active_subscription()函数判断当前用户是否已经拥有任何活跃的订阅。关键逻辑:如果用户没有活跃订阅,则允许其购买(返回) true)。如果用户有活跃订阅:它会进一步调用has_woocommerce_subscription('', $product_id, '')来检查用户是否已经拥有当前尝试添加到购物车的特定产品的订阅。如果has_woocommerce_subscription返回false(即用户有活跃订阅,但该活跃订阅不是当前尝试购买的该产品),则阻止添加,并显示错误通知。这阻止了用户购买第二个一个独立的订阅。如果has_woocommerce_subscription返回true(即用户有活跃订阅,并且该活跃订阅就是当前尝试购买的该产品),则允许添加。这通常发生在用户想要切换(升级/降级)到同一系列的不同订阅时计划,WooCommerce Subscriptions 会处理旧订阅的取消和新订阅的激活。
has_active_subscription():这个辅助函数用于查询当前用户是否拥有任何状态为wc-active 的订阅。
它通过get_posts()查询shop_subscription类型的文章,并根据_customer_user元键筛选出当前用户的订阅,然后检查其post_status是否为wc-active。
has_woocommerce_subscription($the_user_id, $the_product_id, $the_status):这个函数是实现订阅切换互操作的关键。它利用了WooCommerce订阅插件允许内置的 WC_Subscriptions_Manager:user_has_subscription() 方法。该方法能够准确判断用户指定是否拥有某个特定产品ID的订阅流程,并且可以根据订阅状态进行筛选。在本教程的场景中,我们找出空的状态参数,意味着只要用户拥有该产品ID的任何状态的订阅,都会返回true,从而订阅切换的进行。实施步骤与注意事项代码位置:将代码片段添加到您的WordPress主题的功能.php文件补充。更推荐的做法是创建一个自定义插件来管理这类功能,小区主题更新时代码丢失。测试: 在将代码到部署环境生产中,务必在开发或测试环境中进行全面测试。测试新用户购买订阅。测试现有活跃订阅的用户尝试购买另一个独立的订阅(应被阻止)。测试现有活跃订阅的用户尝试插件升级或降级到另一个订阅计划(应被允许)。用户体验:确定错误提示信息响亮了,引导用户前往正确的页面(如“我的账户”页面)进行订阅管理。至少:虽然此代码是基于WooCommerce订阅的官方API,但与其他第三方插件的复杂交互可能会产生意外行为。在添加任何自定义代码后,请检查您的网站功能是否正常。备份:在修改网站核心文件或添加代码之前,请务必进行完整的网站备份。
通过以上代码和详细解释,您将能够精确控制WooCommerce商店中的订阅行为,既能强制用户只能拥有一份活跃订阅,又能灵活地地支持订阅的升级和降级,从而提升用户体验和业务逻辑的严谨性。
以上就是WooCommerce订阅管理:限制单活跃订阅并支持升级/降级的详细内容,更多请关注乐哥常识网其他文章相关!