本教程将详细阐述如何在woocommerce购物车中实现复杂的动态商品价格调整，特别是针对同一商品不同数量设定不同单价的场景（例如，首件商品高价，后续商品低价）。文章将指导读者如何利用woocommerce的过滤器钩子woocommerce_before_calculate_totals，通过自定义php代码精确控制购物车中商品的最终价格，确保价格逻辑与业务需求一致，并提供了详细的代码示例和注意事项，以帮助开发者有效解决此类定制化需求。
在WooCommerce中，默认的购物车行为通常会将同一商品的多个数量合并为一个购物车项，并应用统一的单价。然而，在某些业务场景下，我们可能需要实现更为精细的定价策略，例如：某件商品的第一个单位售价为200美元，而该商品的后续每个单位售价仅为20美元。这意味着，如果顾客购买了该商品3件，总价应为200美元（首件）+ 20美元（第二件）+ 20美元（第三件）= 240美元，而非默认的3 * 200美元 = 600美元。本文将指导您如何通过自定义代码实现这种基于数量的动态价格调整。
理解WooCommerce购物车价格计算机制
WooCommerce在计算购物车总价时，会经过一系列的钩子（hooks）。其中，woocommerce_before_calculate_totals 是一个非常关键的动作钩子，它在购物车总价计算之前触发，允许我们访问和修改购物车中的每个商品项（cart item）数据，包括其价格。这是实现我们定制化价格逻辑的理想切入点。
默认情况下，当您向购物车添加同一商品时，WooCommerce会检查购物车中是否已存在该商品。如果存在，它会简单地增加现有商品项的数量，而不是创建新的商品项。因此，我们需要在总价计算前，根据商品的实际数量，重新计算该商品项的有效单价。
实现基于数量的动态价格调整
要实现上述定价逻辑，我们需要编写一个PHP函数，并将其挂载到woocommerce_before_calculate_totals钩子上。以下是实现此功能的详细步骤和代码示例：
确定目标商品与定价规则 首先，您需要明确哪些商品需要应用这种特殊的定价规则，以及具体的首件价格和后续价格。
编写自定义函数 创建一个PHP函数，该函数将接收 $cart 对象作为参数。在该函数内部，您将遍历购物车中的所有商品项，识别出需要特殊处理的商品，并根据其数量应用新的价格逻辑。
计算有效单价 对于目标商品，如果其数量大于1，则需要计算其总价（首件价格 + (数量-1) * 后续价格），然后将这个总价除以总数量，得到一个“有效单价”。这个有效单价将被设置到购物车商品项中。
以下是实现这一功能的代码示例，您可以将其添加到您的主题的 functions.php 文件中，或通过自定义插件添加：
/**
* WooCommerce 购物车中基于数量的动态商品价格调整
*
* @param WC_Cart $cart WooCommerce Cart 对象
*/
function custom_tiered_product_pricing_in_cart( $cart ) {
// 确保只在前端且非AJAX请求时执行，防止重复执行或在管理后台出错
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
return;
}
// 避免钩子被多次调用导致重复计算
if ( did_action( 'woocommerce_before_calculate_totals' ) >= 2 ) {
return;
}
// 定义需要特殊定价规则的商品ID及其价格规则
// 您可以扩展此数组以支持多个商品
$special_pricing_rules = array(
123 => array( // 替换为您的实际商品ID
'first_unit_price' => 200, // 首件商品的价格
'subsequent_unit_price' => 20, // 后续每件商品的价格
),
// 示例：如果需要为另一个商品设置规则
// 456 => array(
// 'first_unit_price' => 150,
// 'subsequent_unit_price' => 15,
// ),
);
// 遍历购物车中的所有商品项
foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
$product_id = $cart_item['product_id'];
// 检查当前商品是否在特殊定价规则列表中
if ( array_key_exists( $product_id, $special_pricing_rules ) ) {
$quantity = $cart_item['quantity'];
$rules = $special_pricing_rules[$product_id];
$first_unit_price = $rules['first_unit_price'];
$subsequent_unit_price = $rules['subsequent_unit_price'];
if ( $quantity > 0 ) {
$calculated_total_price = 0;
// 根据数量计算总价格
if ( $quantity == 1 ) {
$calculated_total_price = $first_unit_price;
} else {
$calculated_total_price = $first_unit_price + ( ( $quantity - 1 ) * $subsequent_unit_price );
}
// 计算该商品项的有效单价
// 这个单价是 WooCommerce 在购物车中显示的每个单位的价格
$effective_unit_price = $calculated_total_price / $quantity;
// 设置新的价格到购物车商品项中
// 注意：这里设置的是单价，WooCommerce会用这个单价乘以数量来计算line_total
$cart_item['data']->set_price( $effective_unit_price );
}
}
}
}
// 挂载函数到 woocommerce_before_calculate_totals 钩子
// 优先级设为10，确保在其他默认计算之前执行
add_action( 'woocommerce_before_calculate_totals', 'custom_tiered_product_pricing_in_cart', 10, 1 );代码说明
- custom_tiered_product_pricing_in_cart( $cart ) 函数： 这是我们的核心逻辑函数，它接收 WC_Cart 对象作为参数，允许我们访问和修改购物车数据。
- 管理后台和AJAX检查： if ( is_admin() && ! defined( 'DOING_AJAX' ) ) { return; } 和 if ( did_action( 'woocommerce_before_calculate_totals' ) >= 2 ) { return; } 这两行代码是为了确保函数只在前端购物车页面被调用一次，避免在后台或AJAX请求中不必要的执行或潜在的冲突。
- $special_pricing_rules 数组： 这个数组用于定义哪些商品需要应用特殊的定价规则。键是商品ID，值是一个包含 first_unit_price 和 subsequent_unit_price 的子数组。您可以根据需要添加更多的商品规则。
- 遍历购物车： foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) 循环遍历购物车中的每个商品项。
-
价格计算逻辑：
- 根据商品的数量 ($quantity)，计算出该商品项的总价格 ($calculated_total_price)。
- 如果数量为1，总价即为 first_unit_price。
- 如果数量大于1，总价为 first_unit_price 加上其余数量 ($quantity - 1) 乘以 subsequent_unit_price。
- 设置有效单价： effective_unit_price = $calculated_total_price / $quantity; 计算出该商品项的平均单价。然后通过 $cart_item['data']->set_price( $effective_unit_price ); 将这个新的单价设置到购物车商品数据中。WooCommerce会使用这个新的单价乘以商品数量来计算该商品项的最终行总价。
- add_action()： 将 custom_tiered_product_pricing_in_cart 函数挂载到 woocommerce_before_calculate_totals 钩子上。优先级 10 是默认优先级，通常在其他插件的默认行为之前执行。
注意事项
- 商品ID替换： 请务必将示例代码中的 123 替换为您实际的商品ID。您可以在WooCommerce后台编辑商品页面URL中找到商品ID。
- 代码位置： 建议将此代码放置在您的主题的 functions.php 文件中，或者创建一个自定义插件来管理此类功能。直接修改WooCommerce核心文件是不推荐的，因为更新时会被覆盖。
- 缓存： 如果您的网站使用了缓存插件，请在应用此更改后清除缓存，以确保新的价格逻辑能够正确生效。
- 兼容性： 此方法修改了购物车商品的价格，可能会与某些依赖于默认价格或有自己价格修改逻辑的第三方插件（如折扣插件、会员价格插件）产生冲突。在部署到生产环境之前，务必在测试环境中进行充分测试。
- 税费和运费： 此代码仅修改商品的基础价格。税费和运费将在此基础价格上进行计算。
- 产品页面显示： 此修改仅影响购物车中的价格显示和计算，不会改变产品详情页面的价格显示。如果您需要在产品页面也显示这种复杂的定价逻辑，可能需要额外的JavaScript或PHP代码来实现。
- 用户体验： 考虑如何向用户清晰地展示这种复杂的定价规则，例如在产品描述中说明“首件200美元，后续每件20美元”，以避免混淆。
总结
通过利用WooCommerce提供的灵活的钩子机制，我们可以轻松实现复杂的购物车价格调整逻辑，以满足特定的业务需求。woocommerce_before_calculate_totals 钩子为我们提供了一个强大的入口，可以在购物车总价计算前对商品价格进行精确控制。理解并正确运用这些钩子，是进行WooCommerce高级定制的关键。
