在 WooCommerce 购物车中为不同商品添加差异化附加费用教程
在 WooCommerce 电商网站的日常运营中，商家常常会遇到需要为特定商品添加额外费用的场景。例如：重型家具需要额外收取搬运费、易碎品需要增加特殊包装费、或者冷链生鲜商品需要附加保鲜处理费。WooCommerce 默认的固定费率运费或统一附加费功能，往往无法满足这种基于不同商品进行差异化收费的精细化管理需求。本文将详细介绍如何通过自定义代码，在购物车中为不同商品添加差异化的附加费用。
核心实现逻辑
实现该功能的核心在于使用 WooCommerce 提供的 woocommerce_cart_calculate_fees 动作钩子。这个钩子允许开发者在购物车计算总价时，动态地注入自定义的费用项目。
整体的实现逻辑如下：
挂载到
woocommerce_cart_calculate_fees钩子，获取当前购物车实例。定义一个映射数组，将特定商品 ID 与对应的附加费用名称、金额绑定。
遍历购物车中的所有商品，检查当前商品是否存在于预设的映射数组中。
如果匹配成功，则计算费用（可结合商品数量计算），并使用购物车对象的
add_fee()方法将费用添加到账单中。
代码实现：基于商品 ID 添加附加费用
请将以下代码添加到您当前所用主题（建议使用子主题）的 functions.php 文件中，或者通过自定义插件注入。代码必须写在 <?php 标签之后。
// 挂载钩子，在购物车计算费用时执行自定义逻辑
add_action( 'woocommerce_cart_calculate_fees', 'add_custom_fees_by_product_id', 10, 1 );
function add_custom_fees_by_product_id( $cart ) {
// 避免在后台管理界面触发计算
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
return;
}
// 定义商品ID与附加费用的映射规则数组
$fee_rules = array(
101 => array(
'name' => '重型商品搬运费',
'amount' => 15.00
),
102 => array(
'name' => '易碎品特殊包装费',
'amount' => 8.50
),
103 => array(
'name' => '冷链生鲜保鲜费',
'amount' => 5.00
),
);
// 遍历购物车中的所有商品
foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
$product_id = $cart_item['product_id'];
$quantity = $cart_item['quantity'];
// 检查当前商品是否在费用规则映射数组中
if ( isset( $fee_rules[$product_id] ) ) {
$rule = $fee_rules[$product_id];
$fee_name = $rule['name'];
// 费用金额乘以商品数量，实现按件计费
$fee_amount = $rule['amount'] * $quantity;
// 将附加费用添加到购物车
// 参数说明：费用名称、费用金额、是否计税（true表示计税）、税率类别（空字符串表示使用默认）
$cart->add_fee( $fee_name, $fee_amount, true, '' );
}
}
}代码解析与排错
上述代码中的关键点说明如下：
防御性判断：
is_admin() && ! defined( 'DOING_AJAX' )确保了代码只在前台购物车计算时运行，防止后台手动重新计算订单时产生不必要的干扰。规则数组：
$fee_rules数组是整个逻辑的配置中心。键名101、102代表商品的 ID，您需要在实际使用时将其替换为自己网站中的真实商品 ID。name是结账页面展示给顾客看的费用说明，amount是单件商品的费用。您可以在 WordPress 后台的商品列表中找到对应的商品 ID。按数量计费：通过
$rule['amount'] * $quantity的计算方式，附加费用会随商品数量成比例增加。如果您希望不论购买多少件都只收固定费用，只需将此处的乘法修改为仅保留$rule['amount']即可。添加费用方法：
$cart->add_fee()是 WooCommerce 内置的方法，第一个参数为费用名，第二个为金额，第三个参数true表示该费用需要参与计税。
进阶扩展：基于商品分类添加附加费用
有时您的网站中可能有几十个易碎品，逐一填写商品 ID 效率太低。此时，更合理的做法是基于商品分类来添加附加费用。以下是修改后的逻辑：
add_action( 'woocommerce_cart_calculate_fees', 'add_custom_fees_by_product_category', 10, 1 );
function add_custom_fees_by_product_category( $cart ) {
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
return;
}
// 定义分类别名与附加费用的映射规则
$category_fee_rules = array(
'heavy-furniture' => array(
'name' => '大件家具搬运费',
'amount' => 25.00
),
'fragile-goods' => array(
'name' => '易碎品包装处理费',
'amount' => 10.00
),
);
foreach ( $cart->get_cart() as $cart_item ) {
$product_id = $cart_item['product_id'];
$quantity = $cart_item['quantity'];
// 获取当前商品所属的所有分类
$terms = get_the_terms( $product_id, 'product_cat' );
if ( $terms && ! is_wp_error( $terms ) ) {
foreach ( $terms as $term ) {
$slug = $term->slug;
// 检查分类别名是否在规则数组中
if ( isset( $category_fee_rules[$slug] ) ) {
$rule = $category_fee_rules[$slug];
$fee_name = $rule['name'];
$fee_amount = $rule['amount'] * $quantity;
$cart->add_fee( $fee_name, $fee_amount, true, '' );
// 如果一个商品只收取一次分类费用，打破内层循环
break;
}
}
}
}
}在此扩展代码中，我们不再比对商品 ID，而是使用 WordPress 的 get_the_terms() 函数获取商品所属分类，并将规则数组的键名替换为分类的别名。这种方式在管理大规模商品目录时显得更加灵活和高效。
注意事项与最佳实践
费用名称的唯一性：WooCommerce 在处理附加费用时，如果遇到同名费用会自动合并金额。因此，如果您希望每件商品的包装费单独列出，建议在费用名称后追加商品标识，例如：
'name' => '易碎品包装费 - 商品ID:' . $product_id。税务合规：在调用
$cart->add_fee()时，第三个参数控制是否计税。请根据当地税法规定谨慎设置，避免因税务计算错误导致的法律风险。官方参考：如需了解更多关于购物车费用接口的底层说明，可参考 WooCommerce 官方开发文档（https://www.ipipp.com）。
通过以上方法，您可以完全掌控 WooCommerce 购物车的差异化收费逻辑，满足各类复杂的业务场景需求。
WooCommerce附加费用购物车费用商品差异化收费woocommerce_cart_calculate_feesWooCommerce定制功能