1. 问题背景与现有挑战
在 woocommerce 商店中，为特定产品或产品组添加额外费用是常见的需求，例如服务费、包装费等。然而，当这些费用被设计为应用于一组产品（例如，属于同一类别的多个产品）时，如果购物车中包含多个来自该组的产品，现有的实现可能只会对该类别的费用计算一次，而不是根据购物车中此类产品的数量进行累加。这导致了费用计算的不准确，影响了商家的营收和用户的支付体验。
问题的核心在于对产品ID的错误处理以及缺乏对购物车中同类产品数量的累加机制。例如，将多个产品ID错误地作为 __() 翻译函数的参数传入，而不是作为数组来表示一个产品集合。
2. 解决方案核心思路
解决此问题的关键在于以下几点：
- 正确配置产品ID： 将属于同一费用类别的所有产品ID以数组的形式进行定义，而不是使用 __() 翻译函数。__() 函数用于字符串翻译，与产品ID的集合无关。
- 引入累加器： 在每个费用设置中引入一个 total_amount 字段，用于在遍历购物车时累加属于该费用类别的总金额。
- 考虑商品数量： 在计算累加金额时，不仅要考虑产品ID是否匹配，还要将购物车中商品的数量纳入计算，确保费用按件累加。
3. 实现步骤与代码示例
以下是实现 WooCommerce 购物车中多产品同类附加费累加的完整 PHP 代码。这段代码应放置在您主题的 functions.php 文件中，或通过自定义插件添加。
/**
* 为 WooCommerce 购物车中的特定产品组累加附加费用
*
* @param WC_Cart $cart WooCommerce 购物车对象
*/
function action_woocommerce_cart_calculate_fees( $cart ) {
// 仅在非后台且非 AJAX 请求时执行，避免不必要的计算
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
return;
}
// 费用设置：定义不同的费用类别及其关联产品、金额和名称
// product_id: 接受一个产品ID数组，表示哪些产品会触发此费用
// amount: 单个产品触发的费用金额
// name: 费用在购物车中显示的名称
// total_amount: 累加器，用于存储该类别费用的总和，初始值为 0
$settings = array(
array(
'product_id' => array( 30, 813, 815 ), // 产品ID数组
'amount' => 5,
'name' => __( 'Additional service fee', 'woocommerce' ),
'total_amount' => 0, // 累加器
),
array(
'product_id' => array( 817, 819, 820 ),
'amount' => 25,
'name' => __( 'Packing fee', 'woocommerce' ),
'total_amount' => 0,
),
array(
'product_id' => array( 825 ),
'amount' => 100,
'name' => __( 'Another fee', 'woocommerce' ),
'total_amount' => 0,
),
);
// 遍历购物车中的所有商品，计算每个费用类别的总金额
foreach ( $cart->get_cart_contents() as $cart_item_key => $cart_item ) {
// 获取当前购物车商品的ID
$product_id = $cart_item['product_id'];
// 获取当前购物车商品的数量
$quantity = $cart_item['quantity'];
// 遍历所有费用设置，检查当前商品是否属于某个费用类别
foreach ( $settings as $key => $setting ) {
// 如果当前商品的ID存在于某个费用设置的产品ID数组中
if ( in_array( $product_id, $settings[$key]['product_id'] ) ) {
// 将该商品的费用金额（乘以数量）累加到对应的 total_amount 中
$settings[$key]['total_amount'] += $setting['amount'] * $quantity;
}
}
}
// 再次遍历费用设置，将计算出的总费用添加到购物车
foreach ( $settings as $setting ) {
// 只有当累加的总金额大于 0 时才添加费用
if ( $setting['total_amount'] > 0 ) {
// 添加费用到购物车，第三个参数 false 表示此费用不含税
$cart->add_fee( $setting['name'], $setting['total_amount'], false );
}
}
}
// 挂载到 woocommerce_cart_calculate_fees 动作，优先级 10，接受 1 个参数
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees', 10, 1 );
4. 代码详解
-
action_woocommerce_cart_calculate_fees( $cart ) 函数：
- 这是一个 WooCommerce 钩子函数，用于在购物车计算费用时执行自定义逻辑。
- if ( is_admin() && ! defined( 'DOING_AJAX' ) ) return;：这是一个优化措施，确保代码只在前端购物车页面或 AJAX 更新时运行，避免在后台管理界面或非 AJAX 请求时进行不必要的计算。
-
$settings 数组：
- 这是核心配置部分，定义了所有的附加费用规则。
- 'product_id' => array( 30, 813, 815 )：关键改动点。 这里使用了一个数组来包含所有触发此费用的产品ID。请根据您的实际产品ID进行修改。
- 'amount' => 5：单个产品触发的费用金额。
- 'name' => __( 'Additional service fee', 'woocommerce' )：费用在购物车小计中显示的名称。
- 'total_amount' => 0：关键累加器。 这个字段用于在遍历购物车时累加属于此费用类别的总金额。它必须被初始化为 0。
-
遍历购物车内容 (foreach ( $cart->get_cart_contents() as $cart_item_key => $cart_item ))：
- 此循环遍历购物车中的每一个商品。
- $product_id = $cart_item['product_id']; 获取当前商品的ID。
- $quantity = $cart_item['quantity']; 获取当前商品的数量。
-
嵌套循环计算费用 (foreach ( $settings as $key => $setting ))：
- 对于购物车中的每个商品，都会再次遍历 settings 数组中的所有费用规则。
- if ( in_array( $product_id, $settings[$key]['product_id'] ) )：使用 in_array() 函数检查当前购物车商品的 product_id 是否存在于当前费用规则的 product_id 数组中。这是判断商品是否属于某个费用类别的关键。
- $settings[$key]['total_amount'] += $setting['amount'] * $quantity;：如果商品匹配，则将该费用规则的 amount 乘以商品的 quantity，然后累加到对应费用规则的 total_amount 中。
-
添加费用到购物车 (foreach ( $settings as $setting ))：
- 在完成所有商品的遍历和费用累加后，再次遍历 settings 数组。
- if ( $setting['total_amount'] > 0 )：只有当某个费用类别的 total_amount 大于 0 时（即购物车中存在该类别的商品），才将费用添加到购物车。
- $cart->add_fee( $setting['name'], $setting['total_amount'], false );：使用 add_fee() 方法将累加后的总费用添加到购物车。第三个参数 false 表示此费用不含税；如果需要含税，可以设置为 true。
-
add_action( 'woocommerce_cart_calculate_fees', ... )：
- 将上述函数挂载到 woocommerce_cart_calculate_fees 动作钩子上，确保在 WooCommerce 计算购物车费用时执行。
5. 注意事项
- 代码放置位置： 建议将此代码添加到您当前主题的 functions.php 文件中。为了更好的可维护性，更专业的做法是创建一个自定义插件来管理此类功能。
- 产品ID的准确性： 请确保 settings 数组中的产品ID是您希望应用费用的实际产品ID。
- 商品数量处理： 提供的代码已考虑商品数量。如果您不需要根据商品数量累加费用，而只是每个匹配商品收取一次固定费用（无论数量），您可以删除 $quantity = $cart_item['quantity']; 这一行，并将 $settings[$key]['total_amount'] += $setting['amount'] * $quantity; 修改为 $settings[$key]['total_amount'] += $setting['amount'];。
- 测试： 在将代码部署到生产环境之前，务必在开发或测试环境中进行充分测试，以确保费用计算符合预期。
- 优先级： add_action 中的 10 是优先级。如果与其他修改购物车费用的代码冲突，可能需要调整此优先级。
6. 总结
通过上述代码和详细解释，您现在应该能够灵活地在 WooCommerce 购物车中实现对属于同一附加费类别的多个产品进行精确的费用累加。这种方法不仅解决了费用重复计算的问题，还通过清晰的配置和逻辑，提供了强大的可扩展性，以适应各种复杂的附加费场景。正确地管理这些费用将有助于提升您商店的运营效率和用户体验。
