在woocommerce商店运营中，为特定产品或产品组添加附加费是一项常见需求。然而，当同一费用类别下的多个产品被添加到购物车时，如果附加费不能正确累加，则可能导致计算错误。本文将提供一个专业的解决方案，确保附加费能够根据购物车中相关产品的数量和类别进行准确汇总。
问题分析
许多开发者在尝试为一组产品添加附加费时，可能会错误地使用WordPress的__()函数来定义多个产品ID，例如__(123, 456, 789)。__()函数主要用于获取翻译字符串，与处理多个产品ID的功能无关。这种误用会导致系统无法正确识别产品组，从而使得当购物车中包含同一费用类别的多个产品时，附加费仅计算一次，而不是累加。
正确的做法是，将属于同一费用类别的所有产品ID作为一个数组进行管理，并在购物车计算过程中遍历这些产品，将对应的附加费进行累加。
解决方案概述
核心思路是创建一个包含所有费用设置的数组，每个设置项不仅包含产品ID（以数组形式）、金额和名称，还包含一个用于累加当前类别总费用的计数器（total_amount）。然后，通过两次循环实现费用计算：
- 遍历购物车商品：检查每个商品是否属于某个费用类别，并根据商品数量累加该类别的总费用。
- 遍历费用设置：将累加后的总费用作为新的附加费添加到购物车。
代码实现
以下是实现WooCommerce购物车多产品附加费累加功能的PHP代码：
function action_woocommerce_cart_calculate_fees( $cart ) {
// 如果在后台或非AJAX请求中，则不执行此操作
if ( is_admin() && ! defined( 'DOING_AJAX' ) )
return;
// 费用设置数组：可以根据需要添加或删除多个设置项
$settings = array(
array(
'product_id' => array( 30, 813, 815 ), // 产品ID数组
'amount' => 5, // 单个产品附加费金额
'name' => __( 'Additional service fee', 'woocommerce' ), // 费用名称
'total_amount' => 0, // 该类别总费用计数器，初始为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 ) {
$product_id = $cart_item['product_id']; // 获取商品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 );
}
}
}
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees', 10, 1 );代码详解
-
action_woocommerce_cart_calculate_fees( $cart ) 函数：
- 这是一个WooCommerce钩子函数，用于在购物车计算费用时执行自定义逻辑。
- if ( is_admin() && ! defined( 'DOING_AJAX' ) ) return;：此条件判断确保代码仅在前端购物车页面或AJAX请求时执行，避免在后台或不必要的情况下运行。
-
$settings 数组：
- 这是一个核心配置数组，定义了所有附加费规则。
- 'product_id' => array( 30, 813, 815 )：关键点，这里使用一个数组来存储属于同一费用类别的所有产品ID。这是解决多产品累加问题的核心。
- 'amount' => 5：单个符合条件的产品所产生的附加费金额。
- 'name' => __( 'Additional service fee', 'woocommerce' )：在购物车中显示的费用名称。
- 'total_amount' => 0：这是一个临时计数器，用于在遍历购物车时累加当前费用类别的总金额。注意：此字段在初始化时必须为0，且不应在外部修改，它仅用于内部累加。
-
第一个 foreach ( $cart->get_cart_contents() as $cart_item ) 循环：
- 此循环遍历购物车中的每一个商品。
- $product_id = $cart_item['product_id']; 获取当前商品的ID。
- $quantity = $cart_item['quantity']; 获取当前商品的数量。
- 处理商品数量：如果您的附加费不依赖于商品数量，可以删除 $quantity = $cart_item['quantity']; 这一行，并将 $settings[$key]['total_amount'] += $setting['amount'] * $quantity; 修改为 $settings[$key]['total_amount'] += $setting['amount'];。
-
嵌套的 foreach ( $settings as $key => $setting ) 循环：
- 对于购物车中的每个商品，此循环会检查它是否属于任何一个定义的费用类别。
- if ( in_array( $product_id, $settings[$key]['product_id'] ) )：使用 in_array() 函数判断当前商品ID是否存在于某个费用设置的 product_id 数组中。
- $settings[$key]['total_amount'] += $setting['amount'] * $quantity;：如果商品匹配，则将该商品的附加费（金额乘以数量）累加到对应费用设置的 total_amount 计数器中。
-
第二个 foreach ( $settings as $setting ) 循环：
- 在所有购物车商品遍历完成后，此循环负责将最终计算出的附加费添加到购物车。
- if ( $setting['total_amount'] > 0 )：只有当某个费用类别的总金额大于0时，才将其添加到购物车，避免显示0金额的费用。
- $cart->add_fee( $setting['name'], $setting['total_amount'], false );：这是WooCommerce提供的添加费用函数。
- $setting['name']：费用名称。
- $setting['total_amount']：该类别的总附加费金额。
- false：表示该费用不可税。如果需要征税，可以将其设置为 true。
注意事项与最佳实践
- 代码放置位置：将上述PHP代码添加到您的WordPress主题的 functions.php 文件中，或通过自定义插件引入。推荐使用自定义插件，以避免主题更新时代码丢失。
- total_amount 字段：务必理解 total_amount 的作用是一个累加器，它在 $settings 数组初始化时应始终为 0。它会在购物车计算过程中动态更新，但不会影响到下一个购物车会话的初始值。
- 商品数量考虑：根据您的业务需求，选择是否将商品数量纳入附加费计算。代码中默认是考虑数量的。
- 测试：在生产环境部署前，务必在开发或测试环境中进行充分测试，确保所有费用计算逻辑符合预期。测试不同组合的产品（同一类别多个、不同类别多个、单一产品等）。
- 费用名称：确保费用名称清晰明了，方便用户理解。__('...', 'woocommerce') 函数用于国际化，方便多语言支持。
总结
通过上述优化方案，您可以为WooCommerce商店中的特定产品组实现灵活且准确的附加费累加功能。此方法解决了传统实现中费用不累加的问题，并提供了对商品数量的考虑，极大地增强了购物车费用管理的灵活性和准确性，为您的客户提供了更清晰的费用明细。
