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
相关产品推荐
相关产品推荐

