本教程旨在解决 woocommerce 购物车中交叉销售商品默认行为，即隐藏已在购物车中的交叉销售商品的问题。我们将详细介绍如何利用 `woocommerce_cart_crosssell_ids` 过滤器钩子，通过编写自定义 php 代码，确保购物车中始终显示所有关联的交叉销售商品，从而优化用户体验并提升潜在销售机会。
WooCommerce 交叉销售的默认行为
WooCommerce 默认情况下会根据购物车中的商品来推荐交叉销售（Cross-sell）商品。其内置逻辑旨在避免推荐用户已经添加到购物车中的商品，这通常通过 WC_Cart 类中的 get_cross_sells() 方法实现。在该方法内部，系统会获取所有交叉销售商品 ID，然后使用 array_diff() 函数将那些已经存在于购物车中的商品 ID 从交叉销售列表中移除。这意味着，如果一个商品既是某个商品的交叉销售推荐，又被用户放进了购物车，它将不会在交叉销售区域显示。
然而，在某些业务场景下，商家可能希望无论商品是否已在购物车中，都能始终展示所有的交叉销售商品，以最大化商品的曝光度和销售潜力。
通过过滤器自定义显示逻辑
WooCommerce 提供了强大的过滤器（Filter）钩子机制，允许开发者在不修改核心文件的情况下，改变或扩展其默认功能。针对交叉销售商品列表，woocommerce_cart_crosssell_ids 过滤器正是用于此目的。这个过滤器允许我们完全重写 WooCommerce 在购物车页面展示的交叉销售商品 ID 列表。
通过利用 woocommerce_cart_crosssell_ids 过滤器，我们可以构建一个自定义函数，该函数将收集购物车中所有商品的交叉销售 ID，并返回一个包含这些 ID 的列表，而无需执行任何移除已购商品的逻辑。
代码实现与解析
以下是实现始终显示所有交叉销售商品的代码示例：
/**
* 过滤 WooCommerce 购物车交叉销售商品 ID，以显示所有关联商品。
*
* @param array $cross_sells 默认的交叉销售商品 ID 数组。
* @param WC_Cart $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 列表格式正确
// 这个函数会移除重复项，并确保所有元素都是整数
$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 );代码解析：
-
function filter_woocommerce_cart_crosssell_ids( $cross_sells, $cart ):
- 这是一个自定义函数，它将作为 woocommerce_cart_crosssell_ids 过滤器的回调函数。
- 它接收两个参数：$cross_sells（WooCommerce 默认生成的交叉销售 ID 数组，在本例中我们将其覆盖）和 $cart（当前的 WC_Cart 对象，包含了购物车的所有信息）。
-
$all_cross_sells_ids = array();:
- 初始化一个空数组 $all_cross_sells_ids，我们将用它来收集所有商品的交叉销售 ID。
-
foreach ( $cart->get_cart() as $cart_item_key => $values ):
- 遍历购物车中所有的商品项。$values 包含了每个商品的所有数据，包括产品对象 ($values['data'])。
-
if ( $values['quantity'] > 0 ):
- 确保只处理数量大于零的商品，避免处理已移除或数量为零的商品。
-
$all_cross_sells_ids = array_merge( $values['data']->get_cross_sell_ids(), $all_cross_sells_ids );:
- 这是核心逻辑。对于购物车中的每个商品，我们调用 $values['data']->get_cross_sell_ids() 来获取该商品的所有交叉销售 ID。
- 然后，使用 array_merge() 函数将这些 ID 与 $all_cross_sells_ids 数组合并。重要的是，这里我们没有执行任何 array_diff() 操作来移除已在购物车中的商品。
-
$cross_sells = wp_parse_id_list( $all_cross_sells_ids );:
- wp_parse_id_list() 是一个 WordPress 辅助函数，它会清理并标准化 ID 列表。它能确保所有元素都是有效的整数 ID，并自动移除重复项，这有助于避免在交叉销售展示中出现相同的商品。
-
return $cross_sells;:
- 返回最终的交叉销售商品 ID 列表，WooCommerce 将根据此列表在购物车页面显示交叉销售商品。
-
add_filter( 'woocommerce_cart_crosssell_ids', 'filter_woocommerce_cart_crosssell_ids', 10, 2 );:
- 将自定义函数 filter_woocommerce_cart_crosssell_ids 挂载到 woocommerce_cart_crosssell_ids 过滤器上。
- 10 是优先级（默认值），2 表示回调函数接受两个参数。
注意事项
- 代码放置位置： 强烈建议将此代码放置在您的主题的 functions.php 文件中（最好是子主题的 functions.php），或者创建一个自定义插件来管理此类功能。直接修改 WooCommerce 插件文件会在插件更新时丢失您的更改。
- 性能考量： 对于拥有大量商品和复杂交叉销售关系的大型商店，此操作可能会对性能产生轻微影响，因为它需要遍历购物车中的每个商品并获取其交叉销售 ID。然而，对于大多数标准商店而言，这种影响通常可以忽略不计。
- 用户体验： 始终显示所有交叉销售商品可能会增加购物车页面的复杂性。请确保这种行为符合您的业务目标和用户体验设计。过度推荐可能会适得其反。
- 缓存： 如果您使用了页面缓存插件，请确保购物车页面未被缓存，或者缓存逻辑能够正确处理动态内容，以保证交叉销售商品的实时更新。
总结
通过上述方法，您可以有效地自定义 WooCommerce 购物车中交叉销售商品的显示逻辑，确保所有关联的交叉销售商品都能被用户看到，无论它们是否已在购物车中。这种灵活性使得商家能够更好地控制商品推荐策略，从而潜在地提高平均订单价值和客户参与度。始终遵循最佳实践，将代码放置在子主题或自定义插件中，以确保网站的稳定性和可维护性。
