WooCommerce账户地址字段自定义失效：checkout_fields过滤器仅结账页生效

你遇到的问题很常见——woocommerce_checkout_fields这个过滤器仅对结账页面的字段生效，账户页面的「编辑地址」端点用的是完全不同的过滤器钩子。要让自定义标签同时覆盖结账和账户地址页面，你需要针对不同场景使用对应的过滤器。

问题原因 #

WooCommerce把结账页面和账户地址编辑页面的字段配置分开处理了：

• 结账页面的字段由woocommerce_checkout_fields控制
• 账户编辑地址页面的账单/配送字段，分别由woocommerce_billing_fields和woocommerce_shipping_fields控制（这两个钩子同时也会影响结账页面的对应字段）

解决方案 #

我们可以写一个通用的标签设置函数，然后把它挂到多个过滤器上，避免重复代码，同时覆盖所有需要的场景：

// 通用函数：设置地址字段的自定义标签
function custom_address_field_labels( $fields ) {
    // 统一修改地址字段标签
    $fields['first_name']['label'] = 'First name';
    $fields['last_name']['label'] = 'Last name';
    $fields['company']['label'] = 'Company name';
    $fields['address_1']['label'] = 'Street address';
    $fields['address_2']['label'] = 'Apartment, unit, etc.';
    $fields['city']['label'] = 'City';
    $fields['country']['label'] = 'Country';
    $fields['state']['label'] = 'County/State';
    $fields['postcode']['label'] = 'Postcode';
    
    return $fields;
}

// 处理结账页面的所有字段（包括地址、账户、订单备注）
add_filter( 'woocommerce_checkout_fields', 'custom_woocommerce_checkout_fields' );
function custom_woocommerce_checkout_fields( $fields ) {
    // 调用通用函数处理账单和配送地址字段
    $fields['billing'] = custom_address_field_labels( $fields['billing'] );
    $fields['shipping'] = custom_address_field_labels( $fields['shipping'] );
    
    // 仅针对结账页面的账户和订单字段
    $fields['account']['account_username']['label'] = 'Username or email';
    $fields['account']['account_password']['label'] = 'Password';
    $fields['order']['order_comments']['label'] = 'Order notes';
    
    return $fields;
}

// 处理账户页面的账单地址字段
add_filter( 'woocommerce_billing_fields', 'custom_address_field_labels' );

// 处理账户页面的配送地址字段
add_filter( 'woocommerce_shipping_fields', 'custom_address_field_labels' );

额外说明 #

• woocommerce_billing_fields和woocommerce_shipping_fields会同时作用于结账页面和账户地址编辑页面，所以用通用函数可以保证两处的标签一致。
• 如果需要给结账页面和账户页面设置不同的标签，可以在custom_address_field_labels函数里通过is_account_page()和is_wc_endpoint_url('edit-address')判断当前页面，再做差异化处理。

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