WooCommerce特定商品分类下COD支付隐藏失效问题排查

核心问题分析 #

你遇到的情况是：条件判断时$unset为true且输出了调试信息，但执行unset($available_gateways['cod'])后COD仍可见，直接执行unset却生效。大概率是以下两个原因导致：

1. 未传递变量引用 #

WordPress钩子默认传递的是变量副本，如果你修改的是副本而非原变量，所有操作不会生效。解决方法是在回调函数的参数前加&符号，传递原数组的引用：

错误写法：

function hide_cod_for_category($available_gateways) {
    // ...你的判断逻辑
    unset($available_gateways['cod']);
    return $available_gateways;
}

正确写法：

function hide_cod_for_category(&$available_gateways) {
    // ...你的判断逻辑
    unset($available_gateways['cod']);
    return $available_gateways;
}

2. 钩子优先级过低 #

如果你的回调函数优先级（默认是10）低于其他插件/主题修改支付网关的钩子，后续代码会重新把COD加回可用网关列表。需要提高你的钩子优先级，比如设为99或更高：

错误写法：

add_filter('woocommerce_available_payment_gateways', 'hide_cod_for_category');

正确写法：

add_filter('woocommerce_available_payment_gateways', 'hide_cod_for_category', 99);

完整可用代码示例 #

结合以上两点，同时确保分类判断逻辑覆盖所有购物车商品，完整代码如下：

add_filter('woocommerce_available_payment_gateways', 'hide_cod_for_specific_category', 99, 1);
function hide_cod_for_specific_category(&$available_gateways) {
    // 仅在结账页面执行逻辑
    if (!is_checkout()) {
        return $available_gateways;
    }

    $target_category_slug = 'your-target-category'; // 替换为你的商品分类别名
    $need_hide_cod = false;

    // 遍历购物车所有商品，检查是否存在目标分类商品
    foreach (WC()->cart->get_cart() as $cart_item) {
        $product_id = $cart_item['product_id'];
        if (has_term($target_category_slug, 'product_cat', $product_id)) {
            $need_hide_cod = true;
            break;
        }
    }

    if ($need_hide_cod) {
        unset($available_gateways['cod']);
    }

    return $available_gateways;
}

额外排查点 #

• 缓存问题：如果使用了缓存插件，修改代码后务必清除页面缓存和对象缓存，避免调试时看到旧的页面状态。
• 分类判断逻辑：确认has_term函数的参数正确（分类别名、分类 taxonomy、商品ID），避免因参数错误导致误判。

内容的提问来源于stack exchange，提问作者herve barandiaran