如何在WooCommerce切换配送方式时实时更新购物车运费折扣费用

问题回顾 #

你通过WooCommerce的Fee API实现了最高25美元的运费折扣逻辑：当购物车小计≥99美元且运费不为0时，取当前运费、小计25%、25美元三者的最小值作为折扣。但切换配送方式时，折扣不会自动更新，必须刷新页面或触发update_checkout事件才会显示正确值——这个问题确实很常见，因为WooCommerce默认切换配送方式时只重新计算运费，不会主动触发自定义费用的重新计算。

核心解决方案：监听配送方式切换，触发费用重算 #

最直接有效的方法是通过前端JavaScript监听配送方式的选择变化，手动触发WooCommerce的update_checkout事件，这样购物车的所有费用（包括你自定义的折扣fee）都会重新计算。

步骤1：添加前端监听代码

把这段代码添加到你的主题functions.php文件，或者自定义插件中：

add_action( 'wp_footer', 'trigger_checkout_update_on_shipping_switch' );
function trigger_checkout_update_on_shipping_switch() {
    // 只在购物车和结账页面加载这段脚本
    if ( is_cart() || is_checkout() ) {
        ?>
        <script>
            jQuery(document).ready(function($) {
                // 监听配送方式单选框的变化
                $('form.woocommerce-shipping-calculator, form.checkout').on('change', 'input[name^="shipping_method"]', function() {
                    // 触发update_checkout事件，强制重算所有购物车费用
                    $(document.body).trigger('update_checkout');
                });
            });
        </script>
        <?php
    }
}

步骤2：优化PHP计算逻辑（可选，提升可靠性）

有时候WC()->session->get('cart_totals')['shipping_total']可能会拿到缓存的旧值，我们可以直接从选中的配送方式对象获取最新运费，让计算更准确：

add_action( 'woocommerce_cart_calculate_fees', 'conditional_shipping_discount' );
function conditional_shipping_discount() {
    $max_shipping_discount = 25;
    $cart_subtotal = WC()->cart->subtotal;
    $chosen_shipping_methods = WC()->session->get( 'chosen_shipping_methods' );
    
    // 没有选中配送方式时直接返回
    if ( empty( $chosen_shipping_methods ) ) return;
    
    // 获取当前选中的配送方式实例
    $shipping_method = WC()->shipping->get_shipping_method( $chosen_shipping_methods[0] );
    // 获取该配送方式的实际费用
    $current_shipping_method_cost = $shipping_method->cost;

    // 折扣触发条件
    if ( ($cart_subtotal >= 99) && ($current_shipping_method_cost > 0) ) {
        $calculated_shipping_discount = $cart_subtotal * 0.25;
        $shipping_discount = min( $current_shipping_method_cost, $calculated_shipping_discount, $max_shipping_discount );
        WC()->cart->add_fee( 'Shipping Discount', -1 * abs($shipping_discount) );
    }
}

为什么这样有效？ #

• 前端脚本监听了配送方式的切换动作，一旦用户选择新的配送方式，就立刻触发update_checkout——这个事件是WooCommerce内置的，会重新计算购物车的所有费用，包括你用add_fee添加的折扣。
• 优化后的PHP代码直接从配送方式实例取最新费用，避免了session缓存可能带来的旧值问题，让计算逻辑更可靠。

把这两段代码添加到你的项目中，切换配送方式时折扣就会实时更新了。

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