问题背景与分析
在woocommerce商店中，有时需要根据特定产品id或产品组添加额外的费用（例如服务费、包装费等）。然而，在使用某些现有代码实现时，可能会遇到一个常见问题：当购物车中包含多个属于同一附加费类别的产品时，该类别对应的费用却只计算一次，而不是根据相关产品数量进行累加。此外，一个常见的误区是将wordpress的翻译函数__()错误地用于列举多个产品id。__()函数的作用是检索翻译字符串，与处理多个产品id列表无关。
为了解决上述问题，我们需要对费用计算逻辑进行优化，使其能够正确识别并累加同一费用类别下所有相关产品的附加费，同时考虑产品的数量。
解决方案：优化WooCommerce附加费计算逻辑
核心解决方案在于以下两点：
- 正确定义多个产品ID： 将属于同一费用类别的产品ID以数组形式存储，而不是错误地使用__()函数。
- 引入费用累加机制： 在每个费用设置中添加一个total_amount字段作为计数器，并在遍历购物车商品时，将符合条件的产品费用累加到对应的total_amount中。
以下是实现这一功能的完整PHP代码：
/**
* 为WooCommerce购物车中的特定产品组计算并添加累加的附加费。
*
* 此函数通过遍历购物车内容，根据预设的产品ID和费用规则，
* 计算每个费用类别的总附加费，并将其添加到购物车中。
*/
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 ) {
// 获取购物车商品的产品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 );
代码详解与注意事项
-
action_woocommerce_cart_calculate_fees 钩子：
- 这是WooCommerce提供的一个核心钩子，用于在计算购物车费用时执行自定义逻辑。所有自定义费用的添加都应在此钩子中进行。
-
费用设置 $settings 数组：
- product_id：关键改动点。现在它是一个数组，允许您指定多个产品ID，这些产品ID都将触发同一个附加费。例如 array( 30, 813, 815 )。
- amount：单个产品对应的附加费金额。
- name：附加费在购物车中显示的名称。
- total_amount：关键改动点。这是一个累加器，用于存储该费用类别的总金额。务必将其初始值设置为 0，它会在后续的循环中根据购物车内容动态更新。
-
第一个循环：计算 total_amount
- foreach ( $cart->get_cart_contents() as $cart_item ): 遍历购物车中的每一个商品项。
- $product_id = $cart_item['product_id'];: 获取当前商品的产品ID。
- $quantity = $cart_item['quantity'];: 获取当前商品的数量。
- 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;: 如果找到匹配，则将该费用设置的 amount 乘以商品数量，累加到该费用设置的 total_amount 中。
-
第二个循环：添加费用到购物车
- foreach ( $settings as $setting ): 遍历更新后的费用设置数组。
- if ( $setting['total_amount'] > 0 ): 只有当某个费用类别的总金额大于0时，才将其添加到购物车，避免添加零费用。
- $cart->add_fee( $setting['name'], $setting['total_amount'], false );: 使用 add_fee 方法将计算出的总费用添加到购物车。第三个参数 false 表示该费用不含税；如果需要含税，请改为 true。
-
关于产品数量的考虑：
- 上述代码默认会考虑购物车中商品的数量。如果一个产品有2个数量，那么它的附加费将计算两次。
- 如果您不希望附加费受数量影响，而是每个产品ID无论数量多少只计算一次固定费用，可以进行如下修改：
- 删除 $quantity = $cart_item['quantity']; 这一行。
- 将 $settings[$key]['total_amount'] += $setting['amount'] * $quantity; 修改为 $settings[$key]['total_amount'] += $setting['amount'];。
部署与测试
将上述PHP代码添加到您WordPress主题的 functions.php 文件中，或者更推荐的做法是创建一个自定义插件来管理此类功能。保存文件后，清空WooCommerce缓存（如果使用），然后将设置中指定的产品添加到购物车中，观察附加费是否按预期累加。
总结
通过上述优化方案，我们成功解决了WooCommerce购物车中多产品同类附加费无法正确累加的问题。关键在于利用数组来定义多个产品ID，并引入一个动态的 total_amount 计数器来汇总每个费用类别的总金额。这种方法不仅解决了特定场景下的费用计算难题，也为WooCommerce商店提供了更灵活、更专业的附加费管理能力。
