如何在WooCommerce购物车及结账页实现类似运费的可选手续费功能

嘿，这个问题我之前踩过坑！想在WooCommerce购物车/结账页加可选的包装手续费，还得解决自定义字段传值的问题，其实核心是要把字段塞进购物车表单、用Session存值，再配合钩子计算费用。下面给你一套完整的可落地方案：

1. 在购物车页面插入包装类型选择表单 #

首先要把包装选项放在购物车的更新表单里，这样点击「更新购物车」时字段才会被一起提交。用woocommerce_cart_actions钩子就能把选择框加到更新按钮附近：

add_action( 'woocommerce_cart_actions', 'add_packaging_type_selection' );
function add_packaging_type_selection() {
    // 从Session获取已选的包装类型，默认选标准包装
    $selected_type = WC()->session->get( 'selected_packaging_type', 'standard' );
    ?>
    <div class="packaging-selection" style="margin: 10px 0;">
        <label for="packaging_type" style="display: block; margin-bottom: 5px;"><?php _e( '选择包装类型:', 'woocommerce' ); ?></label>
        <select name="packaging_type" id="packaging_type" style="padding: 8px;">
            <option value="standard" <?php selected( $selected_type, 'standard' ); ?>><?php _e( '标准包装 - 免费', 'woocommerce' ); ?></option>
            <option value="gift" <?php selected( $selected_type, 'gift' ); ?>><?php _e( '礼品包装 - ￥10', 'woocommerce' ); ?></option>
            <option value="premium" <?php selected( $selected_type, 'premium' ); ?>><?php _e( '高端包装 - ￥25', 'woocommerce' ); ?></option>
        </select>
    </div>
    <?php
}

2. 保存选中的包装类型到WooCommerce Session #

点击更新购物车后，要把选中的包装类型存到Session里，这样页面刷新、跳转到结账页都能保留选择。用init钩子监听表单提交：

add_action( 'init', 'save_packaging_type_to_session' );
function save_packaging_type_to_session() {
    // 验证是购物车更新请求，且包装类型字段存在
    if ( isset( $_POST['update_cart'] ) && isset( $_POST['packaging_type'] ) ) {
        // 白名单验证，防止恶意输入
        $valid_types = array( 'standard', 'gift', 'premium' );
        $packaging_type = in_array( $_POST['packaging_type'], $valid_types ) ? $_POST['packaging_type'] : 'standard';
        
        // 存入Session
        WC()->session->set( 'selected_packaging_type', $packaging_type );
    }
}

3. 根据包装类型计算并添加手续费 #

用woocommerce_cart_calculate_fees钩子，在购物车计算总价时自动添加对应手续费：

add_action( 'woocommerce_cart_calculate_fees', 'add_packaging_fee' );
function add_packaging_fee( $cart ) {
    // 后台页面跳过计算
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return;
    }
    
    $selected_type = WC()->session->get( 'selected_packaging_type', 'standard' );
    
    // 根据包装类型设置费用和标签
    switch ( $selected_type ) {
        case 'gift':
            $fee = 10;
            $label = __( '礼品包装费', 'woocommerce' );
            break;
        case 'premium':
            $fee = 25;
            $label = __( '高端包装费', 'woocommerce' );
            break;
        default:
            $fee = 0;
            $label = '';
            break;
    }
    
    // 大于0的费用才添加到购物车
    if ( $fee > 0 ) {
        $cart->add_fee( $label, $fee, false, '' );
        // 第三个参数控制是否含税，第四个参数指定税类，按需调整
    }
}

4. （可选）在结账页也支持修改包装类型 #

如果想让用户在结账页也能调整包装选项，用woocommerce_checkout_before_order_review钩子添加选择框，再处理提交：

// 结账页添加包装选择
add_action( 'woocommerce_checkout_before_order_review', 'add_packaging_selection_checkout' );
function add_packaging_selection_checkout() {
    $selected_type = WC()->session->get( 'selected_packaging_type', 'standard' );
    ?>
    <div class="packaging-selection-checkout" style="margin: 20px 0; padding: 15px; border: 1px solid #eee;">
        <h3><?php _e( '包装选项', 'woocommerce' ); ?></h3>
        <label for="checkout_packaging_type" style="display: block; margin-bottom: 5px;"><?php _e( '选择包装类型:', 'woocommerce' ); ?></label>
        <select name="checkout_packaging_type" id="checkout_packaging_type" style="padding: 8px;">
            <option value="standard" <?php selected( $selected_type, 'standard' ); ?>><?php _e( '标准包装 - 免费', 'woocommerce' ); ?></option>
            <option value="gift" <?php selected( $selected_type, 'gift' ); ?>><?php _e( '礼品包装 - ￥10', 'woocommerce' ); ?></option>
            <option value="premium" <?php selected( $selected_type, 'premium' ); ?>><?php _e( '高端包装 - ￥25', 'woocommerce' ); ?></option>
        </select>
    </div>
    <?php
}

// 处理结账页的包装类型更新
add_action( 'woocommerce_checkout_update_order_review', 'update_packaging_type_from_checkout' );
function update_packaging_type_from_checkout( $posted_data ) {
    parse_str( $posted_data, $data );
    
    if ( isset( $data['checkout_packaging_type'] ) ) {
        $valid_types = array( 'standard', 'gift', 'premium' );
        $packaging_type = in_array( $data['checkout_packaging_type'], $valid_types ) ? $data['checkout_packaging_type'] : 'standard';
        
        WC()->session->set( 'selected_packaging_type', $packaging_type );
        // 触发购物车重新计算总价
        WC()->cart->calculate_totals();
    }
}

关于你遇到的wc_update_cart传值问题的关键说明： #

• 一定要把自定义字段放在购物车主表单（.woocommerce-cart-form）内部，否则点击更新按钮时字段不会被提交；
• 不要手动调用wc_update_cart()，依赖表单默认的提交动作就能自动触发购物车更新；
• 用WooCommerce Session存值而不是直接用$_POST，因为$_POST只在提交瞬间有效，Session能跨页面保留用户选择；
• 必须做字段值的白名单验证，防止恶意数据注入。

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