WooCommerce结账字段自定义：角色可见性与排序问题排查

问题诊断 #

1. 字段重复且显示异常：你同时通过woocommerce_before_order_notes动作添加字段，又用woocommerce_default_address_fields过滤器调整位置，但后者仅用于修改默认地址字段，直接给未定义的license_no字段赋值优先级，会导致WooCommerce自动生成一个缺失标签、占位符的默认字段，加上原动作的输出，就出现了重复显示。
2. 角色可见性未实现：现有代码缺少用户角色判断逻辑，所有用户都能看到该字段。

修正方案 #

1. 移除重复逻辑，通过正确过滤器添加并排序字段 #

替换原字段创建和排序代码，改用woocommerce_checkout_fields过滤器将字段添加到账单地址区域，直接通过priority参数控制位置，避免重复。

2. 添加用户角色判断逻辑 #

在字段添加和验证环节，检查当前登录用户是否拥有wholesaler_customer角色，仅对该角色用户显示并要求填写字段。

完整修正代码 #

// 添加并设置自定义NIF/CIF字段（仅对批发商客户可见）
add_filter( 'woocommerce_checkout_fields', 'bbloomer_add_and_reorder_license_field' );
function bbloomer_add_and_reorder_license_field( $fields ) {
    // 获取当前用户
    $current_user = wp_get_current_user();
    
    // 仅对wholesaler_customer角色用户显示字段
    if ( in_array( 'wholesaler_customer', $current_user->roles ) ) {
        // 添加NIF/CIF字段到账单地址区域，优先级35（位于company和country之间）
        $fields['billing']['billing_license_no'] = array(
            'type'        => 'text',
            'class'       => array( 'form-row-wide' ),
            'label'       => 'NIF/CIF',
            'placeholder' => 'B12345678',
            'required'    => true,
            'priority'    => 35,
            'default'     => $current_user->license_no ?? ''
        );
    }
    
    return $fields;
}

// 验证字段不为空（仅对批发商客户验证）
add_action( 'woocommerce_checkout_process', 'bbloomer_validate_license_field' );
function bbloomer_validate_license_field() {
    $current_user = wp_get_current_user();
    if ( in_array( 'wholesaler_customer', $current_user->roles ) && empty( $_POST['billing_license_no'] ) ) {
        wc_add_notice( 'Por favor ingrese su número de NIF', 'error' );
    }
}

// 保存字段值到订单元数据
add_action( 'woocommerce_checkout_update_order_meta', 'bbloomer_save_license_field' );
function bbloomer_save_license_field( $order_id ) {
    if ( isset( $_POST['billing_license_no'] ) ) {
        update_post_meta( $order_id, '_billing_license_no', esc_attr( $_POST['billing_license_no'] ) );
    }
}

// 感谢页面显示字段
add_action( 'woocommerce_thankyou', 'bbloomer_show_license_field_thankyou' );
function bbloomer_show_license_field_thankyou( $order_id ) {
    $license_no = get_post_meta( $order_id, '_billing_license_no', true );
    if ( $license_no ) {
        echo '<p><strong>NIF/CIF:</strong> ' . $license_no . '</p>';
    }
}

// 后台订单页面显示字段
add_action( 'woocommerce_admin_order_data_after_billing_address', 'bbloomer_show_license_field_admin' );
function bbloomer_show_license_field_admin( $order ) {
    $license_no = $order->get_meta( '_billing_license_no' );
    if ( $license_no ) {
        echo '<p><strong>NIF/CIF:</strong> ' . $license_no . '</p>';
    }
}

// 订单邮件显示字段
add_action( 'woocommerce_email_after_order_table', 'bbloomer_show_license_field_email', 20, 4 );
function bbloomer_show_license_field_email( $order, $sent_to_admin, $plain_text, $email ) {
    $license_no = $order->get_meta( '_billing_license_no' );
    if ( $license_no ) {
        echo '<p><strong>NIF/CIF:</strong> ' . $license_no . '</p>';
    }
}

关键修改说明 #

• 字段命名规范：将字段名改为billing_license_no，遵循WooCommerce账单字段命名规则，避免冲突。
• 统一字段添加方式：通过woocommerce_checkout_fields过滤器添加字段到账单组，直接用priority控制位置，无需额外排序代码，彻底解决重复问题。
• 角色权限控制：在字段添加和验证逻辑中加入角色检查，确保仅目标用户可见该字段。
• 代码优化：后台订单页面使用$order->get_meta()替代get_post_meta()，符合WooCommerce最新开发规范。

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