本教程详细介绍了如何通过使用 `woocommerce_cart_crosssell_ids` 过滤器，修改 WooCommerce 购物车默认的交叉销售商品显示逻辑。通过自定义函数，您可以确保购物车中始终展示与当前商品相关联的所有交叉销售商品，而不再自动排除已添加到购物车的商品，从而优化商品推荐策略。
在 WooCommerce 中，购物车页面通常会推荐与当前购物车商品相关的交叉销售（Cross-sell）商品。然而，默认情况下，WooCommerce 的核心功能会智能地从交叉销售列表中移除那些已经存在于购物车中的商品。这一逻辑由 WC_Cart 类中的 get_cross_sells() 方法控制，具体是通过 array_diff( $cross_sells, $in_cart ) 这一行代码实现，其目的是避免重复推荐用户已购买的商品。
对于某些业务场景，例如希望最大化商品曝光或提供更多购买选项，可能需要覆盖这一默认行为，让购物车页面始终显示所有关联的交叉销售商品，无论它们是否已在购物车中。本教程将指导您如何通过 WooCommerce 提供的过滤器钩子来实现这一目标。
理解 WooCommerce 交叉销售逻辑
WooCommerce 的 get_cross_sells() 方法首先会遍历购物车中的每一个商品，收集它们各自关联的交叉销售商品 ID，并将其合并到一个数组中。随后，它会移除那些已经存在于购物车中的商品 ID。我们目标是跳过或重写这一“移除”步骤。
使用 woocommerce_cart_crosssell_ids 过滤器
WooCommerce 提供了 woocommerce_cart_crosssell_ids 过滤器钩子，允许开发者完全控制最终呈现在购物车页面的交叉销售商品 ID 列表。通过这个过滤器，我们可以重新构建交叉销售商品 ID 数组，确保其中包含所有关联商品，而无需考虑它们是否已在购物车中。
实施步骤
要实现始终显示所有交叉销售商品，您需要将以下 PHP 代码添加到您子主题的 functions.php 文件中，或者通过自定义插件引入。
/**
* 过滤 woocommerce_cart_crosssell_ids，以显示所有交叉销售商品。
*
* @param array $cross_sells 当前交叉销售商品 ID 数组。
* @param WC_Cart $cart WC_Cart 实例。
* @return array 更新后的交叉销售商品 ID 数组。
*/
function filter_woocommerce_cart_crosssell_ids( $cross_sells, $cart ) {
// 初始化一个空数组，用于收集所有交叉销售商品 ID
$all_cross_sells_ids = array();
// 遍历购物车中的每一个商品
foreach ( $cart->get_cart() as $cart_item_key => $values ) {
// 确保商品数量大于0
if ( $values['quantity'] > 0 ) {
// 获取当前购物车商品的交叉销售商品 ID，并与已收集的 ID 合并
// 注意：这里我们直接合并，不进行任何移除已在购物车商品的判断
$all_cross_sells_ids = array_merge( $values['data']->get_cross_sell_ids(), $all_cross_sells_ids );
}
}
// 使用 wp_parse_id_list 清理并确保 ID 列表的唯一性
// 这将移除重复的 ID，并确保所有 ID 都是有效的整数
$cross_sells = wp_parse_id_list( $all_cross_sells_ids );
return $cross_sells;
}
add_filter( 'woocommerce_cart_crosssell_ids', 'filter_woocommerce_cart_crosssell_ids', 10, 2 );
代码解释
-
filter_woocommerce_cart_crosssell_ids( $cross_sells, $cart ) 函数定义：
- 这个函数是我们的自定义逻辑，它接收两个参数：$cross_sells（WooCommerce 默认计算出的交叉销售 ID 数组）和 $cart（当前的 WC_Cart 对象实例）。
- 虽然 $cross_sells 参数会被传入，但我们的逻辑实际上会完全重新构建这个列表，而不是基于它进行修改。
-
$all_cross_sells_ids = array();：
- 初始化一个空数组，用于存储从购物车所有商品中收集到的交叉销售商品 ID。
-
foreach ( $cart->get_cart() as $cart_item_key => $values ) 循环：
- 遍历购物车中的每个商品项。
- $values['data']->get_cross_sell_ids()：获取当前购物车商品关联的所有交叉销售商品 ID。
- array_merge( ..., $all_cross_sells_ids )：将当前商品的交叉销售 ID 与之前收集的 ID 合并到 $all_cross_sells_ids 数组中。这里的关键在于，我们只进行合并操作，不执行任何 array_diff 来排除已在购物车中的商品。
-
$cross_sells = wp_parse_id_list( $all_cross_sells_ids );：
- wp_parse_id_list() 是一个 WordPress 实用函数，它能够清理并确保 ID 列表的有效性。它会将输入的 ID 列表转换为一个唯一的整数 ID 数组，移除任何非数字或重复的项。这对于最终输出一个干净的交叉销售 ID 列表非常重要。
-
add_filter( 'woocommerce_cart_crosssell_ids', 'filter_woocommerce_cart_crosssell_ids', 10, 2 );：
- 将我们的自定义函数挂载到 woocommerce_cart_crosssell_ids 过滤器上。
- 10 是优先级，表示在默认优先级下执行。
- 2 表示我们的函数接受两个参数（$cross_sells 和 $cart）。
注意事项与最佳实践
- 代码位置：强烈建议将此类自定义代码放置在子主题的 functions.php 文件中，或者创建一个独立的自定义插件。直接修改 WooCommerce 核心文件或父主题文件会导致更新时丢失您的更改。
- 性能考量：对于包含大量商品和复杂交叉销售关系的大型商店，此操作可能会对购物车页面的加载性能产生轻微影响。在大多数情况下，这种影响可以忽略不计。
- 用户体验：虽然显示所有交叉销售商品可能增加曝光，但也需注意不要让购物车页面过于冗长或信息过载，从而影响用户体验。
- 测试：在生产环境部署之前，务必在开发或测试环境中充分测试此功能，确保其按预期工作且没有引入其他兼容性问题。
总结
通过利用 woocommerce_cart_crosssell_ids 过滤器，您可以轻松地自定义 WooCommerce 购物车中交叉销售商品的显示行为。上述教程提供的方法能够确保所有关联的交叉销售商品都得以展示，为您的客户提供更全面的商品推荐，并可能促进额外的销售。记住始终遵循最佳实践，将代码放置在正确的位置并进行充分测试。
