本文详解如何基于商品所属分类（如 org-prod）及购物车中对应商品的数量，精准计算并添加每件 $15 的运费附加费，修正常见逻辑错误，提供可直接部署的健壮代码方案。
本文详解如何基于商品所属分类（如 `org-prod`）及购物车中对应商品的数量，精准计算并添加每件 $15 的运费附加费，修正常见逻辑错误，提供可直接部署的健壮代码方案。
在 WooCommerce 开发中，常需根据商品属性（如分类、标签、自定义字段）动态添加购物车费用。一个典型场景是：对属于特定分类（如 org-prod）的商品，按其购买数量收取固定单价的附加运费（例如 $15/件）。但初学者易陷入逻辑陷阱——如忽略数量累加、误将费用添加逻辑置于循环内、或使用低效且不可靠的分类判断方式。
以下是一段经过优化、生产就绪的解决方案，已规避原始代码中的全部关键缺陷：
✅ 核心修复点说明
- ❌ 原始代码未将 15 * quantity 纳入计算 → ✅ 此处明确乘以 $cart_item['quantity']
- ❌ WC()->cart->add_fee() 被反复调用（每次循环都执行）→ ✅ 移至循环外，仅在总额 > 0 时统一添加一次
- ❌ 使用 wc_get_product_category_list() + strstr() 判断分类 → ✅ 改用 has_term()，支持 slug/ID/name 匹配，性能高、兼容性好、避免 HTML 标签干扰（如 标签导致匹配失败）
- ❌ 回调函数未声明参数接收 $cart → ✅ 显式接收并使用 $cart 对象，符合 WooCommerce 最佳实践
✅ 推荐实现代码（复制即用）
/**
* 动态添加基于商品分类与数量的运费附加费
* 触发时机：woocommerce_cart_calculate_fees
*/
function action_woocommerce_cart_calculate_fees( $cart ) {
// 后台管理页非 AJAX 请求时跳过，避免影响订单编辑等场景
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
return;
}
// 定义目标分类（支持 slug、name 或 term_id，多个用数组）
$target_categories = array( 'org-prod', 'org-test' ); // 可扩展：如添加 'premium', 42
$fee_amount_per_unit = 15; // 每单位商品附加费（美元）
$total_fee = 0;
// 遍历购物车商品项
foreach ( $cart->get_cart_contents() as $cart_item ) {
$product_id = $cart_item['product_id'];
// 判断商品是否属于任一目标分类（推荐：语义清晰、性能优异）
if ( has_term( $target_categories, 'product_cat', $product_id ) ) {
$quantity = $cart_item['quantity'];
$total_fee += $fee_amount_per_unit * $quantity;
}
}
// 仅当费用总额大于 0 时才添加（避免显示 $0 费用）
if ( $total_fee > 0 ) {
// 第三个参数 true 表示该费用参与税费计算（如需免税，设为 false）
$cart->add_fee(
__( 'Shipping Fees', 'woocommerce' ), // 费用名称（支持翻译）
$total_fee, // 计算得出的金额
true // 是否含税（true = 参与税率计算）
);
}
}
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees', 10, 1 );
⚠️ 注意事项与进阶建议
- 分类匹配精度：has_term() 自动处理层级关系（如子分类继承），若需严格匹配指定分类（不含子类），可改用 wp_get_post_terms() + in_array() 手动校验。
- 多币种/多货币站点：本例金额为数值型，WooCommerce 会自动按当前货币格式化显示；如需动态汇率换算，请集成 wc_get_price_html_from_text() 或第三方汇率 API。
- 调试技巧：临时添加 error_log( "Fee calculated: {$total_fee}" ); 可快速验证逻辑；前端可通过「查看页面源码」搜索 Shipping Fees 确认是否渲染成功。
- 性能考量：对于超大购物车（>100 项），建议配合 wp_cache_set() 缓存分类判断结果，但普通电商场景无需额外优化。
- 扩展性设计：如需不同分类对应不同费率（如 org-prod $15/件，org-test $8/件），可将 $target_categories 改为关联数组 array('org-prod' => 15, 'org-test' => 8) 并在循环中动态取值。
通过以上实现，您将获得一个稳定、可维护、符合 WooCommerce 官方规范的运费附加费逻辑，既满足业务需求，也为后续功能扩展打下坚实基础。
