如何用用户元数据自动填充WooCommerce结账字段

原代码的核心问题 #

• 变量名笔误：你用$dealer_state获取了postcode数据，但后续赋值给billing_postcode时用了未定义的$dealer_postcode，导致该字段无法获取值。
• 过滤器选择错误：woocommerce_checkout_fields的default参数仅对未登录用户生效，登录用户的结账字段值会被WooCommerce默认从billing_*前缀的用户元数据中读取，设置default不会覆盖这一逻辑。
• 元数据键不匹配：你的用户元数据用的是自定义键（phone、dealer_city、postcode），但WooCommerce默认读取的是标准的billing_phone、billing_city、billing_postcode键，这是字段未自动填充的根本原因。

修正方案（直接覆盖字段显示值） #

使用woocommerce_checkout_get_value过滤器，这个过滤器专门用来修改结账字段的显示值，优先级高于默认的元数据读取逻辑，代码如下：

add_filter( 'woocommerce_checkout_get_value', 'custom_checkout_field_value', 10, 2 );
function custom_checkout_field_value( $value, $input ) {
    // 仅针对登录用户处理
    if ( is_user_logged_in() ) {
        $user_id = get_current_user_id();
        // 根据字段名映射自定义元数据
        switch( $input ) {
            case 'billing_phone':
                $value = get_user_meta( $user_id, 'phone', true );
                break;
            case 'billing_city':
                $value = get_user_meta( $user_id, 'dealer_city', true );
                break;
            case 'billing_postcode':
                $value = get_user_meta( $user_id, 'postcode', true );
                break;
            // 如需添加其他字段，继续在这里补充case即可
        }
    }
    return $value;
}

可选方案（同步自定义元数据到标准字段） #

如果希望长期让WooCommerce自动读取这些值，可以添加元数据同步逻辑，把自定义元数据同步到WooCommerce标准的billing_*字段中：

// 用户登录或更新资料时同步元数据
add_action( 'wp_login', 'sync_user_custom_meta_to_billing' );
add_action( 'user_profile_update_errors', 'sync_user_custom_meta_to_billing', 10, 3 );

function sync_user_custom_meta_to_billing( $user_id ) {
    // 处理wp_login钩子的参数（第一个参数是用户名，需转换为用户ID）
    if ( is_string( $user_id ) ) {
        $user = get_user_by( 'login', $user_id );
        $user_id = $user->ID;
    }

    // 获取自定义元数据
    $phone = get_user_meta( $user_id, 'phone', true );
    $city = get_user_meta( $user_id, 'dealer_city', true );
    $postcode = get_user_meta( $user_id, 'postcode', true );

    // 同步到标准billing字段
    if ( !empty( $phone ) ) update_user_meta( $user_id, 'billing_phone', $phone );
    if ( !empty( $city ) ) update_user_meta( $user_id, 'billing_city', $city );
    if ( !empty( $postcode ) ) update_user_meta( $user_id, 'billing_postcode', $postcode );
}

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