动态添加 WooCommerce 购物车附加费用的挑战
在 woocommerce 商店运营中，经常需要根据特定商品收取额外的费用，例如包装费、服务费或特殊处理费。然而，传统的做法往往难以实现为不同商品设定不同金额的附加费。直接复制粘贴代码段为每个商品添加费用不仅效率低下，容易出错，还会导致购物车多次循环计算，严重影响网站性能。本文将介绍两种基于 woocommerce_cart_calculate_fees 动作钩子的解决方案，利用 php 数组的强大功能，实现灵活、高效且可维护的差异化费用添加。
解决方案一：合并显示不同商品的附加总费用
此方法适用于您希望为购物车中多个特定商品添加费用，但最终将这些费用合并显示为一笔总附加费用的场景。它通过一个简单的键值对数组来定义商品ID及其对应的附加费用。
核心原理：
- 定义一个关联数组，其中键是附加费用金额，值是对应的商品ID。
- 遍历购物车中的所有商品。
- 检查购物车商品ID是否存在于预设的数组中。
- 如果存在，则将对应的费用累加到一个总变量中。
- 最后，将累加的总费用作为一笔附加费添加到购物车。
示例代码：
/**
* 为购物车中特定商品添加合并的附加费用。
*
* @param WC_Cart $cart WooCommerce 购物车对象。
*/
function action_woocommerce_cart_calculate_fees_summed( $cart ) {
// 确保只在前端执行，避免管理后台或 AJAX 请求的干扰
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
return;
}
// 定义商品ID及其对应的附加费用。
// 格式：附加费用金额 => 商品ID
$settings = array(
10 => 1234, // 商品ID 1234 对应 10 单位的费用
20 => 5678, // 商品ID 5678 对应 20 单位的费用
5 => 30, // 商品ID 30 对应 5 单位的费用
2 => 815, // 商品ID 815 对应 2 单位的费用
);
// 初始化附加费用总额
$additional_fee_total = 0;
// 遍历购物车中的所有商品
foreach ( $cart->get_cart_contents() as $cart_item ) {
$product_id = $cart_item['product_id'];
// 在设置数组中查找商品ID，并获取对应的费用（即数组的键）
if ( false !== $key = array_search( $product_id, $settings ) ) {
$additional_fee_total += $key; // 累加费用
}
}
// 如果存在匹配的商品ID且总费用大于0，则添加附加费用
if ( $additional_fee_total > 0 ) {
// 添加附加费用到购物车，'Additional fee' 是费用名称，false 表示不含税
$cart->add_fee( __( 'Additional fee', 'woocommerce' ), $additional_fee_total, false );
}
}
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees_summed', 10, 1 );注意事项：
- is_admin() && ! defined( 'DOING_AJAX' ) 检查是必要的，以防止在管理后台或 AJAX 请求期间意外触发费用计算，这可能导致不一致的行为或错误。
- __( 'Additional fee', 'woocommerce' ) 用于国际化，确保费用名称可以被翻译。
- 第三个参数 false 表示该费用不含税。如果需要含税，请根据您的税收设置将其改为 true。
解决方案二：按商品明细显示差异化附加费用
如果您希望客户清楚地看到每笔附加费用对应哪个商品或服务，并为每笔费用提供自定义名称，则可以使用多维数组来实现。这种方法允许您为每个特定商品定义独立的费用名称和金额。
核心原理：
- 定义一个多维数组，每个子数组包含 product_id、amount 和 name 字段。
- 遍历购物车中的所有商品。
- 对于购物车中的每个商品，再次遍历预设的设置数组。
- 如果找到匹配的商品ID，则根据设置数组中的 name 和 amount 字段将该费用单独添加到购物车。
示例代码：
/**
* 为购物车中特定商品添加明细的差异化附加费用。
*
* @param WC_Cart $cart WooCommerce 购物车对象。
*/
function action_woocommerce_cart_calculate_fees_detailed( $cart ) {
// 确保只在前端执行
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
return;
}
// 定义详细的附加费用设置
// 每个数组元素代表一个商品的费用设置，包含商品ID、金额和费用名称
$settings = array(
array(
'product_id' => 30,
'amount' => 5,
'name' => __( 'Additional service fee', 'woocommerce' ), // 商品ID 30 的服务费
),
array(
'product_id' => 813,
'amount' => 10,
'name' => __( 'Packing fee', 'woocommerce' ), // 商品ID 813 的包装费
),
array(
'product_id' => 815,
'amount' => 15,
'name' => __( 'Another fee', 'woocommerce' ), // 商品ID 815 的其他费用
),
);
// 遍历购物车中的所有商品
foreach ( $cart->get_cart_contents() as $cart_item ) {
$product_id = $cart_item['product_id'];
// 遍历设置数组，查找匹配的商品ID
foreach ( $settings as $setting ) {
// 如果找到匹配的商品ID
if ( $setting['product_id'] == $product_id ) {
// 添加单独的附加费用到购物车
// 参数：费用名称，费用金额，是否含税
$cart->add_fee( $setting['name'], $setting['amount'], false );
}
}
}
}
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees_detailed', 10, 1 );注意事项：
- 此方法会在购物车总览中为每个匹配的商品单独列出其附加费用，提供更高的透明度。
- $setting['name'] 字段允许您为每种费用指定一个描述性名称，这对于客户理解费用构成非常有帮助。
- 与前一个解决方案类似，false 参数控制费用是否含税。
实施与最佳实践
- 代码放置位置： 将上述代码片段添加到您主题的 functions.php 文件中，或者更推荐的做法是创建一个自定义插件来管理这些功能。使用自定义插件可以确保在主题更新时代码不会丢失，并提供更好的模块化管理。
- 商品ID获取： 您可以在 WooCommerce 后台编辑商品时，在商品详情页的 URL 中找到商品ID，或者在商品列表页将鼠标悬停在商品名称上查看。
- 测试： 在将代码部署到生产环境之前，务必在开发环境中进行彻底测试。测试不同商品组合、数量以及其他可能影响购物车计算的插件。
- 性能： 这两种方法都通过单次遍历购物车和设置数组来实现，相比多次循环添加费用，效率更高，对网站性能的影响最小。
- 扩展性： 随着商品数量的增加，您只需更新 $settings 数组即可，无需修改核心逻辑，维护起来非常方便。
总结
通过利用 woocommerce_cart_calculate_fees 动作钩子和结构化的 PHP 数组，我们可以高效且灵活地在 WooCommerce 购物车中为不同商品添加差异化的附加费用。无论是需要将所有费用合并显示为一笔总额，还是希望清晰地展示每笔费用的明细，上述两种解决方案都能满足您的需求，同时避免了常见的性能陷阱和维护难题。采用这些专业级的实现方式，将显著提升您的 WooCommerce 商店功能性和用户体验。
