本教程旨在解决WooCommerce中根据购物车内商品数量动态调整价格的复杂需求。默认情况下，WooCommerce会将相同商品合并并统一计价。我们将通过利用`woocommerce_before_calculate_totals`钩子，实现当商品数量达到特定阈值时，自动修改商品单价的逻辑，从而实现灵活的阶梯或条件定价策略，提升商城个性化定价能力。
理解WooCommerce购物车价格机制
WooCommerce在处理购物车中的商品时，其默认行为是将相同的产品合并为一个购物车项，并根据该项的总数量来计算价格。这意味着，无论用户是首次添加商品，还是通过增加数量输入框或再次点击“添加到购物车”按钮来增加现有商品的数量，系统都会简单地将数量累加，并使用商品的基础单价进行总价计算。例如，如果一个商品售价200美元，无论购物车中有1个还是10个，每个商品的单价都保持200美元，总价即为单价乘以数量。
这种机制在大多数情况下是高效且合理的，但当业务需求需要更精细的定价策略时，例如根据购买数量提供不同的单价（如首件原价，续件优惠价），默认机制就无法满足。
动态调整购物车商品价格的需求
许多电商场景需要根据商品的购买数量来实施动态定价。例如，商家可能希望实现以下定价逻辑：
- 当特定商品数量为1时，其单价为200美元。
- 当该商品数量大于1时，购物车中所有该商品的单位单价都变为20美元。
这种需求无法通过WooCommerce的常规设置实现，因为它涉及到在购物车层面，根据特定条件（商品数量）实时修改商品的单价。为了实现这种复杂的逻辑，我们需要深入利用WooCommerce提供的钩子（Hooks）机制。
实现方案：利用WooCommerce钩子
WooCommerce提供了丰富的动作和过滤器钩子，允许开发者在核心流程的不同阶段插入自定义逻辑。对于购物车价格的动态调整，woocommerce_before_calculate_totals 是一个非常关键的钩子。这个动作在购物车总价计算之前触发，允许我们在计算总价前修改购物车中每个商品的单价。
通过在这个钩子中编写自定义代码，我们可以遍历购物车中的每个商品项，检查其ID和数量，然后根据预设的逻辑来修改其价格。
示例代码：根据数量动态定价
以下是一个PHP代码示例，演示如何实现“当特定商品数量为1时价格为200美元，数量大于1时所有单位单价变为20美元”的逻辑。
将以下代码添加到您的主题的 functions.php 文件，或者创建一个自定义插件来管理它。
<?php
/**
* 根据购物车中特定商品的数量动态调整价格。
*
* @param WC_Cart $cart 购物车对象。
*/
function custom_dynamic_price_based_on_quantity( $cart ) {
// 确保只在前端执行，并且购物车已加载
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
return;
}
// 避免重复计算，确保价格只被修改一次
// 在某些WooCommerce版本或特定场景下，此钩子可能会被触发多次。
if ( did_action( 'woocommerce_before_calculate_totals' ) >= 2 ) {
return;
}
// 定义目标商品ID和对应的价格规则
$target_product_id = 123; // 替换为你要应用规则的商品ID
$price_for_single_unit = 200; // 数量为1时的价格
$price_for_multiple_units = 20; // 数量大于1时每个单位的价格
// 遍历购物车中的每个商品项
foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
// 检查当前商品是否为目标商品
if ( $cart_item['product_id'] == $target_product_id ) {
$current_quantity = $cart_item['quantity'];
// 根据数量应用不同的价格
if ( $current_quantity == 1 ) {
// 设置数量为1时的价格
$cart_item['data']->set_price( $price_for_single_unit );
} else {
// 设置数量大于1时每个单位的价格
$cart_item['data']->set_price( $price_for_multiple_units );
}
}
}
}
add_action( 'woocommerce_before_calculate_totals', 'custom_dynamic_price_based_on_quantity', 10, 1 );
代码解析：
- custom_dynamic_price_based_on_quantity( $cart ) 函数： 这是我们的核心逻辑函数，它接收一个 WC_Cart 对象作为参数，通过这个对象我们可以访问和修改购物车中的商品数据。
- 环境检查： is_admin() && ! defined( 'DOING_AJAX' ) 确保此逻辑仅在前端（非后台）或AJAX请求中执行，防止影响后台管理界面。did_action( 'woocommerce_before_calculate_totals' ) >= 2 用于防止在某些情况下钩子被多次触发而导致重复计算或错误。
-
定义规则：
- $target_product_id = 123;：非常重要！您需要将 123 替换为实际需要应用此定价规则的商品ID。 您可以在WooCommerce后台编辑商品页面URL中找到商品ID。
- $price_for_single_unit = 200;：定义当商品数量为1时的单价。
- $price_for_multiple_units = 20;：定义当商品数量大于1时，每个商品的单价。
- 遍历购物车： `foreach ( $cart->get_cart() as $cart
