You need to enable JavaScript to run this app. WooCommerce非烟草类购物车阶梯自定义运费代码优化问题
优惠活动
大模型
产品
解决方案
定价
更多

WooCommerce非烟草类购物车阶梯自定义运费代码优化问题

WooCommerce 阶梯运费功能问题排查与优化

原代码核心逻辑缺陷

  • 核算金额计算完全错误:遍历购物车时,逐次累加非烟草类商品的单品价格、总购买数量,最后用「累计单品价格 * 累计总数量」计算核算值,和实际应算的「每个非烟草商品的单品行小计(单价*购买数量)累加」的口径完全不符,会导致金额匹配偏差极大。
  • 阶梯区间存在临界值漏判:人为设置了10.01、20.01这类判断阈值,刚好10、20、30英镑的临界场景无法被对应分支匹配,会直接触发兜底逻辑出现运费计算错误。
  • 运费速率匹配逻辑冗余且易出错:逐次遍历所有已有速率时修改成本、删除其他速率的写法,会随着速率数组的顺序不同出现匹配混乱,甚至出现同个场景下多个重复速率的问题。
  • 免费配送规则落地错位:超过40英镑的场景下,没有正确保留flat_rate:17的免费配送速率,反而把原有阶梯速率的成本强制设为0,导致前端出现重复的免费配送选项,且完全没有用到需求里指定的flat_rate:17。
  • 无边界场景兜底:当购物车内全部为烟草类商品(可核算金额为0)时,原有逻辑的判断分支无法稳定匹配,容易出现运费显示异常。

优化后可直接使用的代码

add_filter('woocommerce_package_rates', 'custom_tiered_shipping_calculation', 10, 2);
function custom_tiered_shipping_calculation($rates, $package) {
    // 后台非Ajax请求场景直接返回,避免干扰后台配置功能
    if (is_admin() && !defined('DOING_AJAX')) {
        return $rates;
    }

    // 业务配置常量
    $tobacco_shipping_class_id = 150; // 烟草类商品对应的运费组ID
    // 阶梯规则:[最低核算金额(含), 最高核算金额(不含), 对应运费速率ID, 运费成本]
    $tier_rules = [
        [0, 10, 'flat_rate:12', 4.99],
        [10, 20, 'flat_rate:13', 3.99],
        [20, 30, 'flat_rate:14', 2.99],
        [30, 40, 'flat_rate:15', 1.99],
        [40, INF, 'flat_rate:17', 0],
    ];

    // 计算可参与阶梯核算的商品总金额
    $eligible_amount = 0;
    foreach ($package['contents'] as $cart_item) {
        $item_shipping_class_id = (int)$cart_item['data']->get_shipping_class_id();
        // 烟草类商品不计入核算基数
        if ($item_shipping_class_id === $tobacco_shipping_class_id) {
            continue;
        }
        // 累加非烟草类商品的行小计(与WooCommerce购物车金额口径保持一致)
        $eligible_amount += $cart_item['line_total'];
    }

    // 匹配对应阶梯规则
    $matched_rule = null;
    foreach ($tier_rules as $rule) {
        if ($eligible_amount >= $rule[0] && $eligible_amount < $rule[1]) {
            $matched_rule = $rule;
            break;
        }
    }
    if (!$matched_rule) {
        return $rates;
    }

    // 先清空所有阶梯类速率,避免残留重复选项
    $all_tier_rate_ids = array_column($tier_rules, 2);
    foreach ($all_tier_rate_ids as $rate_id) {
        if (isset($rates[$rate_id])) {
            unset($rates[$rate_id]);
        }
    }

    // 写入匹配到的速率配置
    $target_rate_id = $matched_rule[2];
    $target_cost = $matched_rule[3];
    if (isset($rates[$target_rate_id])) {
        $rates[$target_rate_id]->cost = $target_cost;
    }

    return $rates;
}

上线操作注意事项

  • 代码生效前需清空WooCommerce运费缓存:进入WooCommerce「系统状态-工具」页面,清空运费临时存储数据,否则旧的速率配置会被缓存,新规则无法即时生效。
  • 提前核对所有速率ID与配置值的一致性:在运费配置页打开对应费率的编辑链接,从URL中确认instance_id与代码中配置的flat_rate:xx完全匹配,避免因为ID不对应导致速率不显示。
  • 如果站点设置为商品价格含税展示,需将核算金额的计算逻辑调整为含税口径,保证阶梯匹配与前端展示的购物车金额口径一致。
  • 确认所有烟草类商品已正确绑定ID为150的运费组,避免出现商品归类错误导致核算金额偏差。

内容的提问来源于stack exchange,提问作者Chandima

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 09:15:01