概述
在woocommerce商店运营中，经常需要根据特定产品或产品组收取额外的费用，例如服务费、包装费或特定处理费。然而，当购物车中包含多个属于同一费用类别的产品时，简单地为每个产品添加固定费用可能导致费用重复计算或无法正确累加。本教程将介绍一种健壮的方法，通过自定义代码实现购物车附加费用的智能累加，确保费用计算的准确性和灵活性。
核心问题解析
原有的问题在于尝试使用__()函数来定义多个产品ID，这是一个常见的误解。__()函数在WordPress中主要用于字符串的国际化（翻译），而非用于处理多个数据项。正确的方法是将多个产品ID作为一个数组来定义，以便在代码中进行有效匹配和处理。此外，为了实现费用的累加，我们需要一个机制来跟踪每个费用类别的总金额。
实现购物车附加费用累加
我们将通过woocommerce_cart_calculate_fees钩子来注入自定义逻辑，该钩子允许我们在购物车费用计算阶段添加或修改费用。
1. 定义费用设置
首先，我们需要一个清晰的结构来定义不同的附加费用类别。每个类别应包含：
- product_id: 一个产品ID数组，表示哪些产品属于此费用类别。
- amount: 单个产品（或每单位产品）的附加费用金额。
- name: 附加费用的显示名称。
- total_amount: 用于累积此费用类别总金额的计数器，初始值应为0。
示例设置结构：
// Settings (multiple settings arrays can be added/removed if desired)
$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,
),
);2. 遍历购物车内容并累加费用
接下来，我们需要遍历购物车中的每个商品项。对于每个商品，我们检查其ID是否属于任何已定义的费用类别。如果匹配，则根据商品的数量和设定的amount来累加到对应费用类别的total_amount中。
处理逻辑：
- 获取当前购物车商品的产品ID和数量。
- 遍历$settings数组，查找匹配的产品ID。
- 如果找到匹配项，将amount乘以商品数量，并加到该费用类别的total_amount中。
代码片段：
// Loop through cart contents
foreach ( $cart->get_cart_contents() as $cart_item ) {
// Get product id
$product_id = $cart_item['product_id'];
// Get quantity
$quantity = $cart_item['quantity']; // 考虑产品数量
// Loop trough settings array (determine total amount)
foreach ( $settings as $key => $setting ) {
// Search for the product ID
if ( in_array( $product_id, $settings[$key]['product_id'] ) ) {
// Addition: amount * quantity
$settings[$key]['total_amount'] += $setting['amount'] * $quantity;
}
}
}3. 将累加的费用添加到购物车
在所有购物车商品遍历完成后，$settings数组中的每个费用类别的total_amount将包含其应收取的总费用。最后一步是遍历更新后的$settings数组，并将所有大于零的total_amount作为附加费用添加到购物车中。
代码片段：
// Loop trough settings array (output)
foreach ( $settings as $setting ) {
// Greater than 0
if ( $setting['total_amount'] > 0 ) {
// Add fee (name, amount, taxable)
$cart->add_fee( $setting['name'], $setting['total_amount'], false );
}
}完整代码示例
将上述逻辑整合到一个WooCommerce钩子函数中，通常放置在主题的functions.php文件或自定义插件中。
/**
* 在WooCommerce购物车中为特定产品ID组累加附加费用。
*
* @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 30, 813, 815 属于“附加服务费”
'amount' => 5,
'name' => __( 'Additional service fee', 'woocommerce' ),
'total_amount' => 0,
),
array(
'product_id' => array( 817, 819, 820 ), // 例如：产品ID 817, 819, 820 属于“包装费”
'amount' => 25,
'name' => __( 'Packing fee', 'woocommerce' ),
'total_amount' => 0,
),
array(
'product_id' => array( 825 ), // 例如：产品ID 825 属于“其他费用”
'amount' => 100,
'name' => __( 'Another fee', 'woocommerce' ),
'total_amount' => 0,
),
);
// 阶段1: 遍历购物车内容，累积每个费用类别的总金额
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在某个费用类别的 product_id 数组中
if ( in_array( $product_id, $settings[$key]['product_id'] ) ) {
// 将该费用类别的总金额累加，考虑产品数量
$settings[$key]['total_amount'] += $setting['amount'] * $quantity;
}
}
}
// 阶段2: 遍历更新后的费用设置，将累积的总费用添加到购物车
foreach ( $settings as $setting ) {
// 只有当该费用类别的总金额大于0时才添加
if ( $setting['total_amount'] > 0 ) {
// 使用 add_fee 方法将费用添加到购物车
// 参数：费用名称，费用金额，是否应税 (false 表示不应税)
$cart->add_fee( $setting['name'], $setting['total_amount'], false );
}
}
}
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees', 10, 1 );
注意事项与最佳实践
- 代码放置位置： 建议将此代码添加到子主题的functions.php文件或通过自定义插件实现。直接修改父主题文件可能在主题更新时丢失更改。
- total_amount的作用： total_amount字段在$settings数组中至关重要，它充当一个累加器，用于在遍历购物车时跟踪每个费用类别的总金额。切勿修改其初始值以外的其他用途。
- 产品数量的考虑： 提供的代码已将产品数量考虑在内 ($setting['amount'] * $quantity;)。如果您的附加费用不应受产品数量影响（即无论购买多少个，费用只收一次），请将 $quantity = $cart_item['quantity']; 行删除，并将 $setting['amount'] * $quantity; 更改为 $setting['amount'];。
- 可维护性： 将费用设置集中管理，方便未来添加、修改或删除费用类别。
- 税收设置： add_fee()函数的第三个参数控制费用是否应税。在示例中设置为false，表示不应税。根据您的业务需求进行调整。
- 错误处理与调试： 在开发环境中，可以使用error_log()或var_dump()来调试变量，确保逻辑正确。
总结
通过上述教程，您现在应该能够灵活地在WooCommerce购物车中实现基于产品ID分组的累计附加费用。这种方法不仅解决了多个产品属于同一费用类别时费用累加的问题，还提供了考虑产品数量的选项，极大地增强了WooCommerce商店的费用管理能力。遵循这些步骤和最佳实践，可以确保您的自定义费用逻辑稳定且易于维护。
