本教程旨在解决WooCommerce购物车中，同一商品在不同数量下如何实现动态价格调整的问题。我们将探讨WooCommerce默认的购物车商品合并机制，并提供一种高级解决方案，通过阻止商品合并并利用钩子函数，实现对同一商品不同购买批次的独立定价，例如首个商品高价，后续商品低价的场景。
理解WooCommerce购物车商品合并机制
WooCommerce为了简化购物车管理和结账流程，默认会将同一产品ID的商品合并为一个购物车项，并更新其数量。例如，当用户将一个售价200美元的商品添加到购物车后，如果再次添加同一商品，购物车不会新增一个商品项，而是将现有商品项的数量从1增加到2。在这种默认行为下，对“第一个商品200美元，后续商品20美元”这样的需求，直接在单个合并的购物车项上实现精细到“每单位”的价格差异化变得复杂。因为一个购物车项通常只有一个基础价格，乘以数量得到总价。
要实现对同一商品不同购买批次的独立定价，我们需要突破WooCommerce的默认合并机制，让每一次“添加到购物车”操作都生成一个独立的购物车项，即使是同一个产品。
解决方案：阻止商品合并并动态调整价格
实现这一目标的核心思路是：
- 在商品添加到购物车时，为其添加一个唯一的标识符，从而阻止WooCommerce将其与购物车中已存在的同ID商品合并。
- 在购物车总价计算之前，遍历所有购物车项，根据其在购物车中的“顺序”或“批次”来动态调整其价格。
步骤一：阻止WooCommerce合并相同产品
我们可以使用 woocommerce_add_cart_item_data 过滤器钩子来为每个添加到购物车的商品项注入一个唯一的自定义数据。这将使WooCommerce认为每次添加的商品都是“不同”的，即使它们的产品ID相同。
/**
* 阻止WooCommerce合并相同产品，并为每个商品项添加唯一标识符
*
* @param array $cart_item_data 购物车项的自定义数据
* @param int $product_id 产品ID
* @param int $variation_id 变体ID (如果适用)
* @return array 包含唯一标识符的购物车项数据
*/
function custom_add_unique_cart_item_data( $cart_item_data, $product_id, $variation_id ) {
// 为每个添加到购物车的商品项生成一个唯一的ID
$unique_key = md5( microtime() . rand() );
$cart_item_data['unique_id'] = $unique_key;
// 确保每次添加都生成新的唯一ID，而不是重复使用
if ( isset( $_POST['add-to-cart'] ) && intval( $_POST['add-to-cart'] ) === $product_id ) {
// 如果是变体产品，也需要考虑 variation_id
if ( $variation_id ) {
$cart_item_data['unique_id'] = md5( microtime() . rand() . $variation_id );
} else {
$cart_item_data['unique_id'] = md5( microtime() . rand() . $product_id );
}
}
return $cart_item_data;
}
add_filter( 'woocommerce_add_cart_item_data', 'custom_add_unique_cart_item_data', 10, 3 );
/**
* 确保即使是同一个产品，每次添加到购物车时也作为独立项处理
*
* @param string $cart_item_key 购物车项的键
* @param int $product_id 产品ID
* @param int $quantity 数量
* @param int $variation_id 变体ID (如果适用)
* @param array $cart_item_data 购物车项的自定义数据
* @return string 唯一的购物车项键，防止合并
*/
function custom_get_cart_item_from_session( $cart_item_key, $product_id, $quantity, $variation_id, $cart_item_data ) {
if ( isset( $cart_item_data['unique_id'] ) ) {
// 返回基于唯一ID的键，从而阻止WooCommerce合并
return md5( $product_id . $variation_id . serialize( $cart_item_data ) );
}
return $cart_item_key;
}
add_filter( 'woocommerce_get_cart_item_from_session', 'custom_get_cart_item_from_session', 10, 5 );代码解释：
- custom_add_unique_cart_item_data 钩子会在商品添加到购物车时执行。我们在这里为 $cart_item_data 数组添加一个名为 unique_id 的键，其值是一个基于时间戳和随机数的MD5哈希值，确保其唯一性。
- custom_get_cart_item_from_session 钩子在WooCommerce尝试从会话中检索购物车项时触发。通过返回一个包含 unique_id 的新哈希值作为购物车项的键，我们强制WooCommerce将每个带有不同 unique_id 的商品视为一个独立的购物车项，即使它们的产品ID相同。
步骤二：根据商品在购物车中的“批次”调整价格
现在，每个添加到购物车的商品（即使是同一个产品）都将作为独立的购物车项存在。接下来，我们可以使用 woocommerce_before_calculate_totals 钩子在计算购物车总价之前，遍历这些独立的购物车项并调整它们的价格。
假设需求是：某个特定产品（例如ID为 123 的产品），首次添加到购物车时价格为200美元，后续每次添加的价格为20美元。
/**
* 在计算购物车总价之前，根据商品在购物车中的批次调整价格
*
* @param WC_Cart $cart_object WooCommerce购物车对象
*/
function custom_adjust_product_price_in_cart( $cart_object ) {
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
return; // 后台不执行此逻辑
}
// 定义目标产品ID和对应的价格规则
$target_product_id = 123; // 替换为你的目标产品ID
$first_unit_price = 200.00; // 第一个单位的价格
$subsequent_unit_price = 20.00; // 后续单位的价格
$product_count = 0; // 用于跟踪目标产品在购物车中的出现次数
foreach ( $cart_object->get_cart() as $cart_item_key => $cart_item ) {
// 检查当前购物车项是否为目标产品
if ( $cart_item['product_id'] == $target_product_id ) {
$product_count++; // 目标产品计数器加一
// 根据计数器设置价格
if ( $product_count === 1 ) {
// 第一个单位使用特殊价格
$cart_item['data']->set_price( $first_unit_price );
} else {
// 后续单位使用不同价格
$cart_item['data']->set_price( $subsequent_unit_price );
}
}
}
}
add_action( 'woocommerce_before_calculate_totals', 'custom_adjust_product_price_in_cart', 10, 1 );代码解释：
- custom_adjust_product_price_in_cart 钩子在WooCommerce计算购物车总价之前触发。
- 我们首先定义了目标产品ID和相应的价格规则。
- $product_count 变量用于跟踪特定产品在购物车中出现的次数。由于我们已经阻止了商品合并，每次添加到购物车的同一产品都会是一个独立的购物车项。
- 遍历购物车中的每个商品项，如果它是目标产品，我们就根据 $product_count 的值来设置其价格：
- $product_count === 1 表示这是该产品在购物车中的第一个实例，应用 first_unit_price。
- 否则，应用 subsequent_unit_price。
- $cart_item['data']-youjiankuohaophpcnset_price() 方法用于修改当前购物车项的价格。
示例场景演示
假设产品ID为 123 的商品，默认价格为50美元。
- 用户第一次点击“添加到购物车”：购物车中会有一个产品ID 123 的项，价格被设置为200美元。
- 用户第二次点击“添加到购物车”：购物车中会新增一个产品ID 123 的项（因为 unique_id 不同），价格被设置为20美元。
- 用户第三次点击“添加到购物车”：购物车中会再次新增一个产品ID 123 的项，价格被设置为20美元。
最终购物车中会有三个独立的商品项，都对应产品ID 123，但价格分别为200美元、20美元和20美元。
注意事项
- 库存管理： 这种方法会使购物车中出现多个相同产品ID的项。WooCommerce的库存管理通常是基于产品ID的。请确保这种行为不会对你的库存同步和管理造成混淆或问题。
- 购物车显示： 在购物车页面，用户可能会看到多个名称完全相同的商品项，这可能会引起用户的困惑。你可能需要进一步定制购物车模板，例如在商品名称旁添加一些提示（如“（首个）”或“（追加）”），或者通过 woocommerce_cart_item_name 过滤器修改显示名称。
- 兼容性： 这种修改购物车核心行为的方法可能与其他依赖WooCommerce默认购物车合并逻辑的插件产生冲突。在生产环境部署前，务必进行彻底的测试。
- 性能： 对于包含大量商品的购物车，频繁遍历和修改购物车项可能会对性能产生轻微影响。
- 用户体验： 考虑这种定价策略是否符合用户的预期。如果用户期望的是“买一赠一”或“批量折扣”，那么可能有更直接的WooCommerce插件或方法来实现。本教程的方法更适用于严格区分“第一次购买”和“后续购买”的场景。
- 代码位置： 将上述代码添加到你的主题的 functions.php 文件中，或者更推荐的做法是创建一个自定义插件来管理这些功能。
总结
通过阻止WooCommerce默认的购物车商品合并行为，并结合 woocommerce_before_calculate_totals 钩子动态调整每个独立商品项的价格，我们可以实现对同一产品在不同购买批次下应用差异化价格的需求。这种方法提供了极大的灵活性，但也需要仔细考虑其对库存、用户体验和插件兼容性的影响。在实施前，务必进行充分的测试，并根据具体业务需求进行调整。
