基于配送方式设置WooCommerce结账账单手机号必填规则

你的代码无法生效的核心原因是：woocommerce_checkout_fields钩子仅在结账页面首次加载时执行，用户切换配送方式属于前端动态操作，不会触发这个钩子重新运行，因此字段的必填状态不会跟着配送方式变化更新。此外，你还缺少前端状态同步和后端验证逻辑，导致功能不完整。

下面是完整的解决方案，包含后端逻辑、前端动态更新和后端验证：

1. 后端代码（处理初始状态与订单验证） #

将以下代码添加到你的主题functions.php文件或自定义插件中：

add_filter('woocommerce_checkout_fields', 'fire_set_billing_phone_required_based_on_shipping');
function fire_set_billing_phone_required_based_on_shipping($fields) {
    // 定义需要强制手机号必填的配送方式
    $target_shipping_methods = array('flat_rate:2', 'flat_rate:3', 'flat_rate:17', 'flat_rate:20');
    
    // 确保WC会话已初始化
    if (WC()->session) {
        $chosen_methods = WC()->session->get('chosen_shipping_methods');
        // 检查是否有选中的配送方式
        if (!empty($chosen_methods)) {
            $chosen_method = $chosen_methods[0];
            // 根据选中的配送方式设置必填状态
            $fields['billing']['billing_phone']['required'] = in_array($chosen_method, $target_shipping_methods);
        }
    }
    
    return $fields;
}

// 后端验证：防止前端绕过必填检查
add_action('woocommerce_after_checkout_validation', 'fire_validate_billing_phone_based_on_shipping', 10, 2);
function fire_validate_billing_phone_based_on_shipping($checkout_fields, $errors) {
    $target_shipping_methods = array('flat_rate:2', 'flat_rate:3', 'flat_rate:17', 'flat_rate:20');
    
    if (WC()->session) {
        $chosen_methods = WC()->session->get('chosen_shipping_methods');
        if (!empty($chosen_methods)) {
            $chosen_method = $chosen_methods[0];
            
            // 目标配送方式下手机号为空时，添加错误提示
            if (in_array($chosen_method, $target_shipping_methods) && empty($checkout_fields['billing_phone'])) {
                $errors->add('billing_phone_error', __('账单手机号为必填项', 'woocommerce'));
            }
            // 非目标配送方式下，清除手机号的必填错误
            elseif (!in_array($chosen_method, $target_shipping_methods)) {
                foreach ($errors->get_error_codes() as $code) {
                    if ($code === 'billing_phone_error' || strpos($code, 'required') !== false) {
                        $errors->remove($code);
                    }
                }
            }
        }
    }
}

2. 前端JS代码（动态同步字段状态） #

这段代码会监听配送方式的切换，实时修改手机号字段的必填属性和视觉提示：

add_action('wp_footer', 'fire_dynamic_billing_phone_required');
function fire_dynamic_billing_phone_required() {
    // 仅在结账页面加载该脚本
    if (!is_checkout()) return;
    ?>
    <script>
        jQuery(document).ready(function($) {
            const targetMethods = ['flat_rate:2', 'flat_rate:3', 'flat_rate:17', 'flat_rate:20'];
            
            // 页面加载时初始化字段状态
            updatePhoneFieldStatus();
            
            // 监听配送方式切换事件
            $('form.checkout').on('change', 'input[name^="shipping_method"]', updatePhoneFieldStatus);
            
            function updatePhoneFieldStatus() {
                const selectedMethod = $('input[name^="shipping_method"]:checked').val();
                const phoneField = $('#billing_phone_field');
                const phoneInput = $('#billing_phone');
                
                if (targetMethods.includes(selectedMethod)) {
                    // 设置为必填：添加验证类、required属性和星号提示
                    phoneField.addClass('validate-required');
                    phoneInput.prop('required', true);
                    if (!phoneField.find('.required').length) {
                        phoneField.find('label').append('<abbr class="required" title="必填">*</abbr>');
                    }
                } else {
                    // 设置为非必填：移除验证类、required属性和星号
                    phoneField.removeClass('validate-required');
                    phoneInput.prop('required', false);
                    phoneField.find('.required').remove();
                    // 清除前端错误提示
                    phoneField.find('.woocommerce-error').remove();
                }
            }
        });
    </script>
    <?php
}

关键改进点 #

• 动态状态更新：通过JS监听配送方式切换事件，实时修改字段的必填状态，解决原代码仅初始化一次的问题。
• 后端验证：添加woocommerce_after_checkout_validation钩子，确保订单提交时的验证逻辑和前端一致，防止恶意绕过。
• 鲁棒性优化：增加了WC会话和选中配送方式的非空判断，避免出现未定义变量的错误。

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