本教程详细指导如何在 woocommerce 中修改购物车页面交叉销售商品的默认行为，使其始终显示所有关联的交叉销售商品，包括那些已添加到购物车中的商品。通过利用 `woocommerce_cart_crosssell_ids` 过滤器钩子，开发者可以动态地重写交叉销售商品的获取逻辑，从而提供更全面的商品推荐。
理解 WooCommerce 交叉销售的默认行为
WooCommerce 默认的购物车交叉销售功能旨在推荐与用户购物车中商品相关的其他商品。然而，其内置逻辑会主动排除那些已经存在于购物车中的交叉销售商品。这是通过 class-wc-cart.php 文件中的 get_cross_sells() 方法实现的。在该方法内部，有一行关键代码 $cross_sells = array_diff( $cross_sells, $in_cart );，它负责将已在购物车中的商品从交叉销售列表中移除。
对于某些商业场景，商家可能希望无论商品是否已在购物车中，都能完整地展示所有关联的交叉销售商品，以最大化商品曝光和销售机会。直接修改 WooCommerce 核心文件是不可取的，因为它会导致更新问题并增加维护成本。正确的做法是利用 WooCommerce 提供的过滤器钩子来扩展或修改其功能。
利用 woocommerce_cart_crosssell_ids 过滤器
WooCommerce 提供了一个名为 woocommerce_cart_crosssell_ids 的过滤器钩子，它允许开发者在交叉销售商品 ID 列表返回给系统之前对其进行完全控制。这意味着我们可以通过这个过滤器来重写默认的过滤逻辑，确保所有关联的交叉销售商品都被包含在内。
该过滤器接收两个参数：
- $cross_sells：默认生成的交叉销售商品 ID 数组。
- $cart：当前的 WC_Cart 对象实例。
通过这两个参数，我们可以重新构建一个包含所有交叉销售商品 ID 的列表，而无需执行移除已购商品的步骤。
实现步骤与示例代码
要实现始终显示所有交叉销售商品的功能，您需要将以下代码添加到您的子主题的 functions.php 文件中，或者通过自定义插件来管理。
/**
* 过滤 WooCommerce 购物车交叉销售商品 ID，使其显示所有商品。
*
* @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数组
$cross_sells = wp_parse_id_list( $all_cross_sells_ids );
return $cross_sells;
}
// 添加过滤器钩子，优先级为10，接受2个参数
add_filter( 'woocommerce_cart_crosssell_ids', 'filter_woocommerce_cart_crosssell_ids', 10, 2 );代码解析
-
filter_woocommerce_cart_crosssell_ids( $cross_sells, $cart ) 函数定义：
- 此函数是我们的核心逻辑，它将取代 WooCommerce 默认的交叉销售 ID 生成过程。
- $cross_sells 参数是 WooCommerce 默认生成的交叉销售 ID 数组，但在此实现中我们不会直接使用它，而是重新构建。
- $cart 参数提供了对当前购物车对象的访问，我们可以通过它获取购物车中的商品信息。
-
$all_cross_sells_ids = array();：
- 初始化一个空数组，用于累积所有购物车商品关联的交叉销售商品 ID。
-
foreach ( $cart->get_cart() as $cart_item_key => $values ) 循环：
- 遍历购物车中的每个商品项。
- $values['data'] 包含了当前购物车商品的产品对象，我们可以通过它调用 get_cross_sell_ids() 方法。
-
$all_cross_sells_ids = array_merge( $values['data']->get_cross_sell_ids(), $all_cross_sells_ids );：
- 对于购物车中的每个商品，调用其产品对象的 get_cross_sell_ids() 方法来获取其所有关联的交叉销售商品 ID。
- 使用 array_merge() 将这些 ID 添加到 all_cross_sells_ids 数组中。这个操作会收集所有购物车商品的所有交叉销售 ID，而不会像默认逻辑那样进行 array_diff 操作。
-
$cross_sells = wp_parse_id_list( $all_cross_sells_ids );：
- wp_parse_id_list() 是一个 WordPress 实用函数，它会清理并确保 ID 列表是一个有效的、去重且只包含数字的数组。这是为了确保输出的 ID 列表是规范且可靠的。
-
return $cross_sells;：
- 返回最终处理过的交叉销售商品 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 文件中（强烈建议使用子主题，以避免主题更新时代码丢失），或者在一个自定义插件中。
- 性能考量：对于大多数标准商店，此修改的性能影响微乎其微。如果您的商店有极多的商品且每个商品都有大量的交叉销售，或者购物车中经常有几十个商品，理论上可能会有轻微的性能开销，但通常情况下无需担心。
- 动态性：这种方法是完全动态的，您无需在代码中硬编码任何商品 ID。当您在 WooCommerce 后台为商品添加或移除交叉销售商品时，前端的显示会自动更新。
- 用户体验：通过显示所有交叉销售商品，即使是购物车中已有的商品，也能为用户提供更全面的商品发现体验，这在某些营销策略中非常有用，例如强调套装购买或提醒用户相关配件。
通过上述方法，您可以有效地修改 WooCommerce 购物车中交叉销售商品的显示逻辑，以满足特定的业务需求，同时保持代码的健壮性和可维护性。
