本文介绍如何通过代码精准控制 woocommerce 订阅插件（woocommerce subscriptions）中“手动续订”功能的启用范围，仅对指定变体（如一次性付款变体）开启手动续订，而保留其他变体（如月付）的自动续订能力。
在 WooCommerce 中使用 WooCommerce Subscriptions 插件时，默认的「手动续订」设置（位于 WooCommerce → Settings → Subscriptions → General）是全局生效的：一旦启用，所有订阅产品都会允许客户手动触发续订；一旦禁用，则全部关闭。但实际业务中，常需差异化处理——例如一个可变订阅产品包含两个变体：月度自动扣费变体（应启用自动续订）和一次性付费变体（到期后不自动续订，需人工干预或手动触发支付）。此时，全局开关无法满足需求。
解决方案是利用 WordPress 的 pre_option_{option_name} 过滤钩子，动态覆盖 woocommerce_subscriptions_accept_manual_renewals 选项的返回值。该钩子在选项读取前触发，允许我们根据上下文（如购物车中的商品 ID）实时决定是否启用手动续订。
以下代码实现了精准控制逻辑：
add_filter('pre_option_woocommerce_subscriptions_accept_manual_renewals', 'conditional_manual_renewal_for_variation', 10, 3);
function conditional_manual_renewal_for_variation($pre, $option, $default) {
// 仅在结账页（checkout）生效，避免影响后台订单、管理界面等场景
if (!is_checkout()) {
return $pre;
}
// 定义需要启用手动续订的变体 ID（即你的一次性付款变体 ID）
$target_variation_ids = array(1631818389, 1631818390);
// 获取当前购物车内容
$cart = WC()->cart;
if (!$cart || $cart->is_empty()) {
return $pre;
}
// 遍历购物车项，检查是否存在目标变体
foreach ($cart->get_cart() as $cart_item) {
$variation_id = $cart_item['variation_id'] ?: $cart_item['product_id'];
if (in_array($variation_id, $target_variation_ids)) {
// 若存在任一目标变体，则强制启用手动续订（仅对该次结账生效）
return 'yes';
}
}
// 其他情况保持原有设置（例如月付变体仍走默认自动续订逻辑）
return $pre;
}✅ 关键说明与注意事项：
- 变体 ID 而非产品 ID：务必填写实际变体（variation）的数据库 ID（可在 WordPress 后台「产品 → 编辑商品 → 变体」中，鼠标悬停“编辑”链接查看 URL 中的 variation_id= 参数），而非父级可变产品 ID。
- 作用时机精准：该逻辑仅在用户进入结账页（is_checkout()）时触发，确保不影响订单创建、续订计划生成、管理员操作等其他流程。
- 兼容性保障：基于 pre_option_ 钩子，兼容 WooCommerce Subscriptions 4.0+ 版本；若使用旧版（
- 扩展建议：如需更精细控制（例如按用户角色、订阅状态或自定义字段判断），可在条件分支中加入 WC_Subscription 对象查询或 get_post_meta() 调用。
? 总结：此方案不修改核心插件、不依赖额外插件，以轻量钩子实现业务级灵活控制。部署后，含指定变体的订单将自动启用手动续订通道（支持手动网关如银行转账、支票等），而其他变体继续遵循全局自动续订策略，真正实现“一品多策”。建议将代码添加至子主题的 functions.php 或专用功能插件中，并在测试环境验证变体 ID 与行为一致性。
