WooCommerce：结账前获取收发货地址计算运费并累加总价的Hook实现

要实现客户修改账单/配送地址时实时计算运费并更新订单总价，结合前端事件监听和WooCommerce核心钩子就能搞定，具体方案如下：

一、核心钩子与逻辑说明 #

• 前端：监听地址关键字段（如州、城市）的变更事件，触发WooCommerce内置的订单合计更新机制
• 后端：使用woocommerce_calculate_shipping钩子处理自定义运费计算，该钩子会在运费需要重新计算时自动触发（包括地址变更后的AJAX请求）

二、完整实现代码 #

替换你现有的测试代码，使用以下代码即可实现需求：

// 后端：根据客户地址计算自定义运费
add_action('woocommerce_calculate_shipping', 'custom_shipping_cost_by_state', 10, 1);
function custom_shipping_cost_by_state($shipping_package) {
    // 获取客户的配送州（若需基于账单地址计算，替换为get_billing_state()）
    $customer_state = WC()->customer->get_shipping_state();
    
    // 按地区设置运费金额
    $shipping_cost = 0;
    if ($customer_state === 'CA') { // 加州
        $shipping_cost = 15.99;
    } elseif ($customer_state === 'NY') { // 纽约
        $shipping_cost = 12.99;
    } else { // 其他地区默认运费
        $shipping_cost = 9.99;
    }

    // 覆盖默认运费，应用自定义金额
    foreach ($shipping_package['rates'] as $rate_key => $rate) {
        $shipping_package['rates'][$rate_key]->set_cost($shipping_cost);
    }
}

// 前端：监听地址字段变更，触发订单总价更新
add_action('woocommerce_checkout_after_order_review', 'address_change_listener');
function address_change_listener() {
    ?>
    <script>
        // 监听账单/配送地址的州、城市字段
        const addressFields = document.querySelectorAll('#billing_state, #shipping_state, #billing_city, #shipping_city');
        
        addressFields.forEach(field => {
            field.addEventListener('change', function() {
                // 触发WooCommerce内置的订单更新事件
                jQuery(document.body).trigger('update_checkout');
            });
        });
    </script>
    <?php
}

三、代码细节解释 #

• 后端的woocommerce_calculate_shipping钩子会在每次运费计算时执行，自动响应地址变更后的AJAX请求，你可以根据需求扩展判断条件（比如邮编、城市）
• 前端代码监听地址关键字段的变化，一旦修改就触发update_checkout事件，让WooCommerce重新计算并更新订单总价
• 若需要基于账单地址计算运费，只需把get_shipping_state()替换为get_billing_state()

四、可选钩子：额外自定义逻辑 #

如果需要在地址变更时执行日志记录等额外操作，可以使用woocommerce_checkout_update_order_review钩子，示例代码如下：

add_action('woocommerce_checkout_update_order_review', 'handle_address_change_actions', 10, 1);
function handle_address_change_actions($post_data) {
    // 解析提交的地址表单数据
    parse_str($post_data, $form_data);
    
    // 获取账单/配送州信息
    $billing_state = $form_data['billing_state'] ?? '';
    $shipping_state = $form_data['shipping_state'] ?? '';
    
    // 示例：记录地址变更日志
    file_put_contents(ABSPATH . 'address_change_log.txt', print_r($form_data, true));
    
    // 手动触发运费重新计算
    WC()->cart->calculate_shipping();
}

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