如何解决WooCommerce自定义字段无法保存到账单详情的问题？

问题核心：你移除默认结账字段并在订单审核区重新添加同名字段后，WooCommerce不会自动将该字段值同步到订单账单详情，需要补充验证和保存逻辑。

以下是完整修复代码：

// 移除默认结账页面的billing_first_name字段
add_filter('woocommerce_checkout_fields', 'quadlayers_remove_checkout_fields');
function quadlayers_remove_checkout_fields($fields)
{
    unset($fields['billing']['billing_first_name']);
    return $fields;
}

// 在订单审核区域添加billing_first_name字段
add_action('woocommerce_checkout_order_review', 'checkout_review_order_custom_field');
function checkout_review_order_custom_field()
{
    // 填充当前用户默认名字作为字段默认值（可选优化）
    $current_user = wp_get_current_user();
    $default_name = $current_user->first_name ? $current_user->first_name : '';

    woocommerce_form_field('billing_first_name', array(
        'type'        => 'text',
        'class'       => array('form-row-wide'),
        'label'       => __('Name', 'sidesmedia'),
        'placeholder' => 'Card Holder Name',
        'required'    => true,
        'default'     => $default_name,
    ));
}

// 验证字段是否填写
add_action('woocommerce_checkout_process', 'validate_billing_first_name_field');
function validate_billing_first_name_field()
{
    if (!isset($_POST['billing_first_name']) || empty(trim($_POST['billing_first_name']))) {
        wc_add_notice(__('Please enter the card holder name.', 'sidesmedia'), 'error');
    }
}

// 将字段值保存到订单账单详情
add_action('woocommerce_checkout_update_order_meta', 'save_billing_first_name_to_order');
function save_billing_first_name_to_order($order_id)
{
    if (isset($_POST['billing_first_name']) && !empty(trim($_POST['billing_first_name']))) {
        $order = wc_get_order($order_id);
        $first_name = sanitize_text_field($_POST['billing_first_name']);
        
        // 同步更新订单元数据和核心账单属性
        $order->update_meta_data('_billing_first_name', $first_name);
        $order->set_billing_first_name($first_name);
        $order->save();
    }
}

// 可选：后台订单编辑页显示字段值
add_action('woocommerce_admin_order_data_after_billing_address', 'display_billing_first_name_in_admin');
function display_billing_first_name_in_admin($order)
{
    $first_name = $order->get_billing_first_name();
    if ($first_name) {
        echo '<p><strong>' . __('Card Holder Name', 'sidesmedia') . ':</strong> ' . esc_html($first_name) . '</p>';
    }
}

// 可选：前台订单详情页显示字段值
add_action('woocommerce_order_details_after_billing_address', 'display_billing_first_name_in_frontend');
function display_billing_first_name_in_frontend($order)
{
    $first_name = $order->get_billing_first_name();
    if ($first_name) {
        echo '<p><strong>' . __('Card Holder Name', 'sidesmedia') . ':</strong> ' . esc_html($first_name) . '</p>';
    }
}

关键逻辑说明： #

1. 字段验证：通过woocommerce_checkout_process钩子拦截结账流程，确保必填字段不为空，为空则抛出错误提示。
2. 数据同步：使用woocommerce_checkout_update_order_meta钩子，同时更新订单的元数据和核心账单名字属性，保证WooCommerce核心逻辑能正确识别该数据。
3. 体验优化：添加用户默认名字作为字段默认值，减少用户重复输入操作。
4. 数据可视化：可选的前后台显示逻辑，让管理员和用户都能在对应页面看到该字段值。

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