在WooCommerce结账区块添加自定义VAT字段遇问题求助

问题1：仅在账单地址区域显示VAT字段（无需JS/CSS） #

放弃使用woocommerce_register_additional_checkout_field，改用woocommerce_billing_fields钩子直接往账单字段组里添加自定义VAT字段，字段只会出现在账单地址区域，不会混入配送区域，同时天然支持服务器端验证。

示例代码：

add_filter('woocommerce_billing_fields', 'add_billing_vat_field');
function add_billing_vat_field($billing_fields) {
    $billing_fields['billing_vat_number'] = array(
        'label'       => 'VAT编号',
        'required'    => true, // 按需设置是否必填
        'type'        => 'text', // 需要隐藏时改为'hidden'
        'class'       => array('form-row-wide'),
        'priority'    => 35, // 调整显示位置，35对应邮编之后、国家之前
        'clear'       => true
    );
    return $billing_fields;
}

问题2：隐藏/必填状态下预填充值不丢失 #

字段设为隐藏且必填时，仅依赖woocommerce_get_default_value_for_stack/vat_number可能无法保留值，需结合woocommerce_checkout_get_value钩子强制返回预填充值，同时在注册字段时直接设置default属性。

示例代码：

// 注册字段时绑定默认值
add_filter('woocommerce_billing_fields', 'add_billing_vat_field_with_default');
function add_billing_vat_field_with_default($billing_fields) {
    // 从用户元数据获取预填充值，可替换为其他来源逻辑
    $default_vat = get_user_meta(get_current_user_id(), 'billing_vat_number', true);
    
    $billing_fields['billing_vat_number'] = array(
        'label'       => 'VAT编号',
        'required'    => true,
        'type'        => 'hidden',
        'class'       => array('form-row-wide'),
        'priority'    => 35,
        'default'     => $default_vat, // 直接设置默认值
        'clear'       => true
    );
    return $billing_fields;
}

// 确保结账时字段值被正确读取
add_filter('woocommerce_checkout_get_value', 'set_checkout_vat_value', 10, 2);
function set_checkout_vat_value($value, $input) {
    if ($input === 'billing_vat_number' && empty($value)) {
        $value = get_user_meta(get_current_user_id(), 'billing_vat_number', true);
    }
    return $value;
}

额外验证补充 #

为保证必填字段的有效性，添加服务器端验证逻辑：

add_action('woocommerce_checkout_process', 'validate_billing_vat_field');
function validate_billing_vat_field() {
    if (isset($_POST['billing_vat_number']) && empty($_POST['billing_vat_number'])) {
        wc_add_notice('请填写VAT编号', 'error');
    }
    // 可按需添加VAT号格式校验逻辑
}

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