本教程详细介绍了如何在woocommerce购物车页面中，通过自定义`woocommerce_cart_crosssell_ids`过滤器，实现始终显示所有关联的交叉销售商品，即使这些商品已存在于购物车中。我们将通过php代码示例，指导开发者如何覆盖woocommerce的默认行为，以提供更全面的商品推荐。
引言：理解WooCommerce交叉销售与默认行为
交叉销售（Cross-sells）是电子商务中一种常见的营销策略，旨在鼓励顾客购买与购物车中现有商品相关或互补的其他商品，从而提高订单价值。在WooCommerce中，购物车页面通常会显示基于当前购物车内容的交叉销售商品推荐。
然而，WooCommerce的默认实现，特别是其内部的get_cross_sells()函数，在生成交叉销售商品列表时，会自动移除那些已经存在于购物车中的商品。这是通过array_diff( $cross_sells, $in_cart )这行代码实现的，其目的是避免重复推荐用户已购买的商品。
尽管这一默认行为在多数情况下是合理的，但在某些特定的业务场景下，商家可能希望无论商品是否已在购物车中，都能完整地展示所有关联的交叉销售商品。例如，当商家希望强调某个系列的完整性，或者提供一个“可能您也喜欢”的全面列表时，这种需求就显得尤为重要。
核心挑战：WooCommerce交叉销售过滤机制
WooCommerce通过woocommerce_cart_crosssell_ids过滤器钩子，允许开发者自定义购物车页面上显示的交叉销售商品ID列表。默认情况下，这个过滤器会接收由get_cross_sells()函数处理过的ID列表，其中已移除了购物车中的商品。
要实现“始终显示所有交叉销售商品”的目标，我们需要利用这个过滤器，并重新构建交叉销售ID列表，但不再执行移除购物车中现有商品的操作。直接修改主题文件来硬编码商品ID（如$cross_sell_ids = [4782, 4777, 4776, 4783];）是一种不推荐的做法，因为它缺乏动态性，每次商品更新都需要手动修改代码，维护成本高且易出错。
解决方案：利用 woocommerce_cart_crosssell_ids 过滤器
为了动态且灵活地实现这一目标，我们将编写一个PHP函数，并将其挂载到woocommerce_cart_crosssell_ids过滤器上。这个函数将遍历购物车中的所有商品，收集它们各自关联的交叉销售商品ID，并将这些ID合并成一个完整的列表，而不进行任何过滤。
以下是实现此功能的代码示例：
/**
* 过滤 WooCommerce 购物车交叉销售商品 ID，以始终显示所有关联商品。
*
* @param array $cross_sells 默认的交叉销售商品 ID 数组。
* @param WC_Cart $cart 当前的 WooCommerce 购物车对象。
* @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 );
// 返回最终的交叉销售商品 ID 列表
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对象，包含购物车中的所有商品信息)。
-
初始化数组: $all_cross_sells_ids = array();
- 创建一个空数组，用于累积所有购物车商品关联的交叉销售ID。
-
遍历购物车: foreach ( $cart->get_cart() as $cart_item_key => $values )
- 循环遍历购物车中的每个商品。$values包含了每个商品的所有详细数据，包括产品对象。
-
获取并合并ID:
- if ( $values['quantity'] > 0 ): 确保只处理数量大于零的有效商品。
- $values['data']->get_cross_sell_ids(): 这是关键一步，它从当前商品的产品对象中获取所有预设的交叉销售商品ID。
- array_merge( ... ): 将当前商品的交叉销售ID与$all_cross_sells_ids合并。array_merge会自动处理数组合并，但不会去重。
-
清理与去重: $cross_sells = wp_parse_id_list( $all_cross_sells_ids );
- wp_parse_id_list()是一个WordPress函数，它会清理一个ID列表（无论是数组、逗号分隔还是空格分隔），确保所有ID都是有效的整数，并自动移除重复项。这对于最终输出一个干净、有效的ID列表至关重要。
-
返回结果: return $cross_sells;
- 函数返回最终处理过的交叉销售商品ID数组。
-
挂载过滤器: add_filter( 'woocommerce_cart_crosssell_ids', 'filter_woocommerce_cart_crosssell_ids', 10, 2 );
- 这行代码将我们的自定义函数挂载到woocommerce_cart_crosssell_ids过滤器上。
- 10 是优先级，表示在其他优先级为10的过滤器之后执行。
- 2 表示我们的函数接受两个参数 ($cross_sells 和 $cart)。
代码部署与注意事项
代码部署位置：
将上述PHP代码放置在以下位置之一：
- 子主题的 functions.php 文件: 这是最推荐的方式，可以确保代码在主题更新时不会丢失。
- 自定义插件: 如果您有多个自定义功能，或者希望此功能独立于主题，可以创建一个简单的自定义WordPress插件来包含此代码。
性能考量：
- 对于购物车中商品数量非常多，且每个商品都关联大量交叉销售商品的场景，此操作可能会对服务器性能产生轻微影响，因为需要遍历并合并所有ID。然而，在大多数标准WooCommerce商店中，这种影响通常可以忽略不计。
用户体验：
- 显示所有交叉销售商品可能会导致购物车页面上的推荐商品列表过长。请确保您的主题布局能够良好地处理这种情况，并考虑这是否会给用户带来信息过载的感觉。适度的推荐通常比过多的推荐效果更好。
兼容性与测试：
- 在将此代码部署到生产环境之前，务必在开发或测试环境中进行充分的测试。检查购物车页面是否正确显示所有交叉销售商品，以及网站的其他功能是否正常运行。
- 此代码基于WooCommerce的过滤器机制，通常具有良好的兼容性。但在WooCommerce大版本更新时，仍需留意官方文档，以防相关钩子或函数发生重大变化。
动态性优势：
- 与硬编码商品ID的方法不同，此解决方案是完全动态的。当您在WooCommerce后台为产品添加或移除交叉销售商品时，此代码将自动适应并显示最新的推荐，无需修改任何代码。
总结
通过利用woocommerce_cart_crosssell_ids过滤器，开发者可以灵活地控制WooCommerce购物车页面上交叉销售商品的显示逻辑。本教程提供的解决方案允许您覆盖WooCommerce的默认行为，实现“始终显示所有关联交叉销售商品”的需求，即使这些商品已存在于购物车中。这种方法不仅功能强大，而且具有良好的动态性和可维护性，是优化用户购物体验和促进销售的有效手段。在实施时，请务必考虑性能和用户体验，并进行充分的测试。
