WooCommerce 中根据客户订单总数动态调整特定国家的运费-php教程-PHP中文网

WooCommerce 中根据客户订单总数动态调整特定国家的运费

本文详解如何在 WooCommerce 中基于用户历史订单数量，为英国等指定国家动态设置不同档位的平邮费用（如首单 6€、后续订单 25€），并通过 woocommerce_package_rates 钩子精准修改运费成本与对应税额，避免误删运输方式。

本文详解如何在 woocommerce 中基于用户历史订单数量，为英国等指定国家动态设置不同档位的平邮费用（如首单 6€、后续订单 25€），并通过 `woocommerce_package_rates` 钩子精准修改运费成本与对应税额，避免误删运输方式。

在 WooCommerce 商城运营中，针对高价值客户或复购用户实施差异化的物流策略（例如“首单免运费”或“老客运费升级”）是提升转化与忠诚度的有效手段。本文聚焦一个典型场景：仅对英国（UK）、比利时（BE）等特定国家的已登录用户，依据其历史完成订单总数，动态设定 Flat Rate 运费——首单为 €6，第二单起统一升至 €25。该方案不取消运输方式，而是实时重写运费金额及关联税费，确保结账流程稳定、数据准确。

✅ 核心实现逻辑

使用 woocommerce_package_rates 钩子（优先级 10），在运费计算最终阶段介入；
通过 $package['destination']['country'] 精确识别收货国，仅对目标国家生效；
调用原生函数 wc_get_customer_order_count($user_id) 获取用户已完成订单数（自动排除待处理/已取消订单）；
遍历 $rates 数组，定位 flat_rate 方法，直接修改其 ->cost 属性；
关键增强：同步按比例重算各项运费税额（->taxes），保障含税总价一致性（若未启用运费税，此部分自动跳过）。

? 完整可部署代码

将以下代码添加至您子主题的 functions.php 文件末尾（推荐）或使用 Code Snippets 插件管理：

function filter_woocommerce_package_rates( $rates, $package ) {
    // ? 定义需应用规则的国家代码（ISO 3166-1 alpha-2）
    $specific_countries = array( 'UK', 'BE' );

    // 检查当前包裹目的地是否在目标国家列表中，否则跳过处理
    if ( ! in_array( $package['destination']['country'], $specific_countries ) ) {
        return $rates;
    }

    // 仅对已登录用户生效
    if ( ! is_user_logged_in() ) {
        return $rates;
    }

    $user_id = get_current_user_id();
    $order_count = wc_get_customer_order_count( $user_id ); // 自动统计 'completed' 状态订单

    // 遍历所有可用运费选项
    foreach ( $rates as $rate_key => $rate ) {
        // 仅处理 Flat Rate 运输方式
        if ( $rate->method_id !== 'flat_rate' ) {
            continue;
        }

        // 设定新运费：首单 €6，之后均为 €25
        $new_cost = ( $order_count === 0 ) ? 6 : 25;

        // 更新基础运费
        $rates[$rate_key]->cost = $new_cost;

        // ✅ 同步更新运费税额（保持税率不变）
        if ( ! empty( $rate->taxes ) ) {
            $updated_taxes = array();
            $original_cost = $rate->cost; // 注意：此处取原始 cost，非 $rates[$rate_key]->cost（因已修改）

            foreach ( $rate->taxes as $tax_key => $tax_amount ) {
                if ( $tax_amount > 0 && $original_cost > 0 ) {
                    $tax_rate = $tax_amount / $original_cost;
                    $updated_taxes[$tax_key] = round( $new_cost * $tax_rate, 2 );
                } else {
                    $updated_taxes[$tax_key] = 0;
                }
            }
            $rates[$rate_key]->taxes = $updated_taxes;
        }
    }

    return $rates;
}
add_filter( 'woocommerce_package_rates', 'filter_woocommerce_package_rates', 10, 2 );

⚠️ 重要注意事项

缓存刷新：WooCommerce 默认缓存运费结果。修改代码后，请清空购物车并重新添加商品，或在后台「WooCommerce → 设置 → 运输 → 实例」中点击「保存更改」强制刷新；
国家代码规范：'UK' 是 WooCommerce 内部使用的国家代码（非 'GB'），请勿混淆；如需扩展其他国家，直接追加到 $specific_countries 数组即可；
订单状态依赖：wc_get_customer_order_count() 仅统计 wc-completed 状态订单。若需包含其他状态（如 wc-processing），请改用 wc_get_orders() 并自定义查询参数；
多运输方式兼容：本代码仅修改 flat_rate 类型，不影响 UPS、FedEx 等第三方插件运费；
调试建议：临时添加 error_log( "User {$user_id} orders: {$order_count}" ); 可快速验证用户订单数是否获取正确。