在WooCommerce购物车中为不同商品添加差异化附加费
在运营WooCommerce电子商务网站时，商家常常需要根据商品的特殊属性来收取额外的费用。例如，易碎品需要额外的包装费，大件商品需要特殊处理费，或者某些定制商品需要加急处理费。默认情况下，WooCommerce只提供全局的费率设置，无法针对购物车中的特定商品添加差异化附加费。本文将详细介绍如何通过自定义代码，在WooCommerce购物车中实现针对不同商品收取不同附加费的功能。
理解WooCommerce购物车费用机制
WooCommerce提供了一个非常灵活的钩子系统，允许开发者在购物车计算总价的过程中插入自定义逻辑。我们要使用的核心钩子是woocommerce_cart_calculate_fees。通过这个动作钩子，我们可以遍历购物车中的所有商品，检查每个商品的ID、分类或自定义字段，然后根据条件动态添加附加费。
实现差异化附加费的步骤
1. 遍历购物车商品
首先，我们需要获取购物车中的所有商品，并逐一检查它们。WooCommerce的购物车对象包含了当前会话中的所有商品信息，通过遍历可以获取到每一个商品项的详细数据。
2. 判断商品条件并计算附加费
在遍历过程中，我们可以根据商品ID、商品分类或商品标签来设定不同的附加费金额。例如，商品A需要加收10元，商品B需要加收20元。计算时需要注意乘以商品的数量，确保每件商品都收取了对应费用。
3. 添加附加费到购物车
当条件匹配且计算出费用后，使用购物车对象的add_fee()方法将附加费添加到购物车中。该方法接受费用名称、金额、是否计税以及计税类别等参数。
完整代码示例
以下代码可以添加到当前主题的functions.php文件中，或通过自定义插件引入。此代码演示了如何根据不同的商品ID和商品分类添加差异化的附加费。
add_action( 'woocommerce_cart_calculate_fees', 'custom_differentiated_surcharge' );
function custom_differentiated_surcharge( $cart ) {
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) return;
$surcharge_total = 0;
$fee_name = '特殊处理费';
foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
$product_id = $cart_item['product_id'];
$quantity = $cart_item['quantity'];
// 条件1：特定商品ID加收附加费
if ( $product_id == 101 ) {
$surcharge_total += 10 * $quantity;
}
// 条件2：另一特定商品ID加收不同附加费
if ( $product_id == 202 ) {
$surcharge_total += 25 * $quantity;
}
// 条件3：属于特定分类的商品加收附加费
if ( has_term( 'fragile', 'product_cat', $product_id ) ) {
$surcharge_total += 5 * $quantity;
}
}
if ( $surcharge_total > 0 ) {
$cart->add_fee( __( $fee_name, 'textdomain' ), $surcharge_total, true );
}
}代码解析
在上述代码中，我们首先通过add_action函数将自定义逻辑挂载到woocommerce_cart_calculate_fees钩子上。在custom_differentiated_surcharge函数内部：
我们使用
is_admin()进行判断，确保该附加费只在前台购物车计算时生效，避免在后台订单编辑时重复计算。通过
$cart->get_cart()遍历购物车中的每一个商品项。获取商品ID和数量后，我们使用
if语句进行条件判断。如果商品ID匹配，或者通过has_term()函数检测到商品属于特定分类，则累加相应的附加费金额。最后，如果累加的附加费金额大于0，则调用
$cart->add_fee()方法添加费用。该方法的第三个参数设置为true，表示该附加费需要计算税费。
在展示附加费时，WooCommerce默认会生成相应的HTML结构。如果开发者希望通过<span>或<div>标签对附加费的显示样式进行定制，可以通过覆写购物车模板文件来实现，但这不影响后台费用计算的逻辑。
高级应用场景
基于商品自定义字段添加附加费
如果你的附加费规则更加复杂，例如某些商品在后台编辑时勾选了某个自定义字段，你可以通过获取商品的元数据来判断是否收费。获取商品对象后，使用get_meta()方法读取自定义字段值。
$product = $cart_item['data'];
$is_special_handling = $product->get_meta( '_special_handling_fee' );
if ( $is_special_handling === 'yes' ) {
$surcharge_total += 15 * $quantity;
}区分不同附加费名称
默认情况下，上述代码将所有附加费汇总为一项。如果需要在前台购物车页面清晰展示每种附加费的用途，你可以针对不同条件分别调用add_fee()方法，并赋予不同的费用名称。
if ( $product_id == 101 ) {
$cart->add_fee( __( '易碎品包装费', 'textdomain' ), 10 * $quantity, true );
}
if ( has_term( 'oversized', 'product_cat', $product_id ) ) {
$cart->add_fee( __( '大件商品处理费', 'textdomain' ), 20 * $quantity, true );
}总结
在WooCommerce中为不同商品添加差异化附加费，能够帮助商家更灵活地处理特殊商品的运营成本。通过利用woocommerce_cart_calculate_fees钩子，结合商品ID、分类或自定义字段的判断，我们可以实现各种复杂的收费规则。在实际部署代码前，建议在测试环境中充分验证，确保费用计算逻辑准确无误，且不会与现有的支付网关或物流插件产生冲突。