本文介绍如何在 woocommerce 结账页中，根据购物车内特定订阅商品的 id，自动取消勾选并隐藏第三方支付插件（如 payrexx）的“允许定期扣款”复选框，实现精准的条件化表单控制。
在 WooCommerce 开发中，常需根据用户购物车内容动态调整结账表单行为。例如，当用户仅购买某类特殊订阅产品（如一次性付费订阅）时，应禁用支付网关的「允许定期扣款」功能——这通常通过控制一个名为 payrexx-allow-recurring 的复选框实现：需同时取消勾选（checked=false）并视觉隐藏（display:none）。
虽然 PHP 可用于服务端逻辑判断，但表单元素的 DOM 状态（如勾选、显示/隐藏）必须由 JavaScript 在客户端实时操作。因此，最佳实践是：用 PHP 判断购物车内容，再按需注入轻量级 jQuery 脚本——既避免前端盲目轮询，又确保逻辑与业务规则强绑定。
以下为推荐实现方案（兼容 WooCommerce 6.0+，需添加至子主题 functions.php）：
HISUI 前端框架开发指南（IRIS版）
下载
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
function conditional_hide_recurring_checkbox( $fields ) {
// 获取当前购物车所有商品
$cart = WC()->cart->get_cart();
$target_product_id = 1631817356; // ✅ 替换为你需要匹配的订阅商品 ID
$found_target = false;
// 遍历购物车，检查是否存在目标商品（支持多件、变体等场景）
foreach ( $cart as $item ) {
if ( $item['data']->get_id() === $target_product_id ) {
$found_target = true;
break;
}
}
// 仅当目标商品存在时，注入 JS 控制逻辑
if ( $found_target ) {
?>
<script type="text/javascript">
document.addEventListener('DOMContentLoaded', function() {
const checkbox = document.getElementById('payrexx-allow-recurring');
if (checkbox) {
checkbox.checked = false; // 移除勾选状态
checkbox.style.display = 'none'; // 彻底隐藏（比 hide() 更可靠）
// 可选：移除其关联的 label（如有），提升可访问性一致性
const label = document.querySelector('label[for="payrexx-allow-recurring"]');
if (label) label.style.display = 'none';
}
});
</script>
<?php
}
return $fields;
}
add_filter( 'woocommerce_checkout_fields', 'conditional_hide_recurring_checkbox' );✅ 关键说明与注意事项：
- 不要直接修改插件源码：所有定制均通过 WordPress 钩子（woocommerce_checkout_fields）安全注入，确保插件更新后逻辑仍有效；
- ID 匹配建议：若目标商品为变体（Variable Product），请使用 $item['data']->get_parent_id() 或检查 $item['variation_id']；
- 性能优化：脚本在 DOM 加载后执行，避免 jQuery(document).ready() 依赖 jQuery 库是否已加载；如主题未引入 jQuery，改用原生 document.addEventListener（如上所示）更健壮；
- 无障碍友好：隐藏复选框时同步隐藏其
- 扩展性提示：如需支持多个禁止复选框的商品 ID，可将 $target_product_id 改为数组，并用 in_array() 判断。
该方案兼顾可靠性、可维护性与兼容性，适合初学者快速集成。部署后，请清空 WooCommerce 缓存并测试含目标商品与非目标商品的两种结账流程，确保行为符合预期。
