WooCommerce结账页面自定义选项附加费未同步至订单问题

问题根源 #

你的代码存在两个核心问题：

1. 依赖不可靠的$_POST['post_data']：订单提交后，$_POST['post_data']无法稳定获取到结账时选择的贺卡类型，导致附加费计算逻辑失效。
2. 未持久化自定义字段值：没有将用户选择的贺卡类型保存到订单元数据或会话中，订单创建时无法读取到之前的选择，自然不会计算附加费。

修复后的完整代码 #

1. 添加结账自定义字段并保存到会话

// 添加结账贺卡类型字段
add_filter('woocommerce_checkout_fields', 'add_custom_field_to_checkout');
function add_custom_field_to_checkout($fields) {
    $fields['shipping']['card_type'] = array(
        'type' => 'select',
        'label' => __('Greeting Card', 'woocommerce'),
        'options' => array(
            '' => __('Select an option', 'woocommerce'),
            'nocard' => __('No Card', 'woocommerce'),
            'Bestwishes' => __('Best Wishes (Free)', 'woocommerce'),
            'congratulations' => __('Congratulations ($0.99)', 'woocommerce'),
            'happybirthday' => __('Happy birthday (Free)', 'woocommerce'),
            'happyanniversary' => __('Happy Anniversary ($0.99)', 'woocommerce'),
        ),
        'required' => true,
        'class' => array('form-row-wide'),
        'clear' => true
    );

    return $fields;
}

// 将贺卡类型保存到WC会话，确保订单创建时能读取到
add_action('woocommerce_checkout_update_order_review', 'save_card_type_to_session');
function save_card_type_to_session($posted_data) {
    parse_str($posted_data, $output);
    if (isset($output['card_type'])) {
        WC()->session->set('card_type', sanitize_text_field($output['card_type']));
    }
}

2. 修复附加费计算逻辑

// 添加贺卡附加费
add_action('woocommerce_cart_calculate_fees', 'add_card_fee');
function add_card_fee() {
    if (is_admin() && !defined('DOING_AJAX')) return;

    // 从会话获取贺卡类型，同时兼容POST提交时的场景
    $card_type = WC()->session->get('card_type') ?? (isset($_POST['card_type']) ? sanitize_text_field($_POST['card_type']) : '');
    
    // 定义免费选项列表
    $free_options = array('nocard', 'Bestwishes', 'happybirthday');
    
    // 如果不是免费选项，添加附加费
    if (!empty($card_type) && !in_array($card_type, $free_options)) {
        WC()->cart->add_fee(__('Greeting Card Fee', 'woocommerce'), 0.99);
    }
}

3. 将贺卡类型保存到订单元数据（可选但推荐）

这样在订单详情页能看到用户选择的贺卡类型，方便管理：

// 将贺卡类型保存到订单元
add_action('woocommerce_checkout_create_order', 'save_card_type_to_order_meta');
function save_card_type_to_order_meta($order) {
    $card_type = WC()->session->get('card_type');
    if (!empty($card_type)) {
        $order->update_meta_data('_card_type', $card_type);
        // 可选：清理会话中的值
        WC()->session->__unset('card_type');
    }
}

// 在订单详情页显示贺卡类型
add_action('woocommerce_admin_order_data_after_shipping_address', 'display_card_type_in_admin_order');
function display_card_type_in_admin_order($order) {
    $card_type = $order->get_meta('_card_type');
    if (!empty($card_type)) {
        echo '<p><strong>' . __('Greeting Card Type', 'woocommerce') . ':</strong> ' . esc_html($card_type) . '</p>';
    }
}

关键改进点 #

• 用WC会话存储用户选择的贺卡类型，避免依赖不稳定的$_POST数据
• 直接通过字段名card_type获取值，而非模糊匹配post_data字符串，逻辑更清晰可靠
• 添加订单元数据保存，让附加费的计算依据在订单中可查
• 兼容结账时实时计算和订单创建时的重新计算场景

内容的提问来源于stack exchange，提问作者Muhammad Faraz safder