如何为 WooCommerce 变体订阅产品中的特定变体启用手动续订功能

6次阅读

本文介绍如何通过代码精准控制 woocommerce 订阅插件（woocommerce subscriptions）中“手动续订”功能的启用范围，仅对指定变体（如一次性付款变体）开启手动续订，而保留其他变体（如月付变体）的自动续订能力。

在 WooCommerce 中使用 WooCommerce Subscriptions 插件时，默认的「手动续订」设置（位于 WooCommerce → Settings → Subscriptions → General）是全局生效的——即开启后，所有订阅产品均支持手动续订；关闭则全部禁用。但实际业务中，常需差异化处理：例如一个可变订阅产品包含两个变体——「月度自动续订」和「一次性付费（24个月有效期）」，前者应保持自动续订，后者则必须禁用自动续订、仅允许手动触发（如对接离线支付、银行转账等手动网关）。

要实现按变体粒度控制手动续订开关，核心思路是：动态覆盖 woocommerce_subscriptions_accept_manual_renewals 选项的读取结果，并在结账（checkout）环节根据购物车中实际加入的变体 ID 做条件判断。

以下为推荐实现方案（兼容 WooCommerce Subscriptions v5+）：

add_filter( 'pre_option_woocommerce_subscriptions_accept_manual_renewals', 'conditionally_enable_manual_renewal_for_variations', 10, 3 );  function conditionally_enable_manual_renewal_for_variations( $pre, $option, $default ) {     // 仅在结账页面执行判断（避免后台/订单页误触发）     if ( ! is_checkout() || is_admin() ) {         return $pre;     }      // 定义需要启用「手动续订」的变体 ID 列表（务必替换为你的真实变体ID）     $manual_renewal_variation_ids = array( 1631818389, 1631818390 );      // 遍历购物车商品     foreach ( WC()->cart->get_cart() as $cart_item ) {         $variation_id = $cart_item['variation_id'] ?: $cart_item['product_id'];          // 若当前购物车中存在任一目标变体，则强制启用手动续订         if ( in_array( $variation_id, $manual_renewal_variation_ids, true ) ) {             return 'yes';         }     }      // 其他情况（如无目标变体）维持原有设置（即默认值或后台配置值）     return $pre; }

✅ 关键说明与注意事项：

✅ 使用 variation_id 而非 product_id：变量订阅产品的变体具有独立 ID，务必在 WooCommerce 后台「编辑变体」页面确认其真实 ID（URL 中 post= 后的数字），而非父级可变产品的 ID。
✅ 优先级控制：该钩子在选项读取前介入（pre_option_），因此能高效覆盖全局设置，且不影响其他逻辑。
⚠️ 不适用于已创建的订阅：本方案仅影响新购订阅的创建流程（即 checkout 阶段）。已存在的订阅续订行为由订单元数据（_subscription_renewal_order 等）决定，若需批量更新历史订阅，需额外使用 wcs_update_subscription() 或 sql 手动修正。
? 安全建议：将代码添加至子主题的 functions.php 文件，或使用 Code Snippets 插件管理，避免主题更新丢失。
? 测试要点：
- 单独加入「一次性变体」→ 结账时应显示「手动续订」支付方式（如 Bank Transfer）；
- 单独加入「月付变体」→ 应仅显示自动扣款方式（如 Stripe Subscription）；
- 同时加入两者 → 以「存在任一目标变体」为准，即启用手动续订（可根据业务需求调整为 AND 逻辑）。