根据配送方式移除WooCommerce结账页面指定账单字段

你的思路方向是对的，但原代码存在一个核心问题：woocommerce_checkout_fields 过滤器只会在结账页面初始加载时执行一次，当用户在前端切换配送方式时，PHP不会重新触发这个钩子，所以字段无法动态响应变化。另外直接unset字段可能引发WooCommerce内部验证逻辑异常，下面是完整的修复方案，包含PHP后端处理和前端动态交互：

步骤1：PHP处理初始状态与后端验证 #

add_filter('woocommerce_checkout_fields', 'xa_remove_billing_checkout_fields');
function xa_remove_billing_checkout_fields($fields) {
    // 仅在结账页面执行逻辑
    if (!is_checkout()) return $fields;

    $target_shipping_method = 'local_pickup:1';
    $chosen_methods = WC()->session->get('chosen_shipping_methods');
    
    // 检查是否选中目标自提方式
    if (!empty($chosen_methods) && $chosen_methods[0] === $target_shipping_method) {
        // 先取消这些字段的必填要求，避免验证报错
        $fields['billing']['billing_address_1']['required'] = false;
        $fields['billing']['billing_address_2']['required'] = false;
        $fields['billing']['billing_city']['required'] = false;
        $fields['billing']['billing_state']['required'] = false;
        $fields['billing']['billing_postcode']['required'] = false;
        
        // 给字段添加自定义CSS类，方便JS控制显示/隐藏
        $fields['billing']['billing_address_1']['class'][] = 'hide-if-local-pickup';
        $fields['billing']['billing_address_2']['class'][] = 'hide-if-local-pickup';
        $fields['billing']['billing_city']['class'][] = 'hide-if-local-pickup';
        $fields['billing']['billing_state']['class'][] = 'hide-if-local-pickup';
        $fields['billing']['billing_postcode']['class'][] = 'hide-if-local-pickup';
    }
    
    return $fields;
}

// 后端验证：选择自提时忽略这些字段的必填检查
add_action('woocommerce_checkout_process', 'xa_validate_billing_fields_for_local_pickup');
function xa_validate_billing_fields_for_local_pickup() {
    $target_shipping_method = 'local_pickup:1';
    $chosen_methods = WC()->session->get('chosen_shipping_methods');
    
    if (!empty($chosen_methods) && $chosen_methods[0] === $target_shipping_method) {
        // 移除对应字段的错误提示
        $errors = WC()->session->get('errors');
        if (is_array($errors)) {
            unset($errors['billing_address_1'], $errors['billing_address_2'], $errors['billing_city'], $errors['billing_state'], $errors['billing_postcode']);
            WC()->session->set('errors', $errors);
        }
    }
}

步骤2：添加JavaScript实现动态切换 #

需要在结账页面添加JS监听配送方式变化，实时显示/隐藏字段：

add_action('wp_footer', 'xa_dynamic_billing_fields_hide');
function xa_dynamic_billing_fields_hide() {
    // 仅在结账页面加载脚本
    if (!is_checkout() && !is_wc_endpoint_url()) return;
?>
<script>
jQuery(document).ready(function($) {
    const targetMethod = 'local_pickup:1';
    
    // 页面加载完成后先执行一次，匹配初始选中的配送方式
    toggleBillingFields($('input[name="shipping_method[0]"]:checked').val());
    
    // 监听配送方式切换事件
    $('form.checkout').on('change', 'input[name="shipping_method[0]"]', function() {
        toggleBillingFields($(this).val());
    });
    
    // 核心切换函数
    function toggleBillingFields(selectedMethod) {
        if (selectedMethod === targetMethod) {
            $('.hide-if-local-pickup').hide();
            // 清空字段值，避免提交无效数据
            $('.hide-if-local-pickup input').val('');
        } else {
            $('.hide-if-local-pickup').show();
        }
    }
});
</script>
<?php
}

原代码失效的关键原因 #

1. woocommerce_checkout_fields 是静态钩子，无法响应前端配送方式的动态切换动作
2. 直接unset字段会破坏WooCommerce的字段结构，可能引发依赖地址的功能异常
3. 未处理后端验证逻辑，即使前端隐藏字段，提交时仍可能触发必填校验报错

把以上代码添加到你的主题functions.php文件或自定义插件中，即可实现选择local_pickup:1时动态隐藏指定账单字段的功能。

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