WooCommerce购物车：强制显示所有交叉销售商品教程

本教程详细讲解如何在WooCommerce购物车中修改默认行为，实现始终显示所有与购物车商品相关的交叉销售（Cross-sell）商品，即使这些商品已存在于购物车中。通过利用 `woocommerce_cart_crosssell_ids` 过滤器钩子，开发者可以覆盖WooCommerce的内部逻辑，动态地展示全部推荐商品，从而提升用户的购物体验和潜在销售额。

在WooCommerce电子商务平台中，交叉销售（Cross-sell）是一种常用的营销策略，旨在向顾客推荐与购物车内商品相关或互补的产品，以期增加订单价值。然而，WooCommerce默认的购物车交叉销售逻辑具有一个特定行为：它会自动过滤掉那些已经被添加到购物车的交叉销售商品。这意味着，如果一个商品既被定义为交叉销售商品，又恰好已被顾客加入购物车，它将不会再次显示在交叉销售列表中。

理解WooCommerce的默认交叉销售逻辑

WooCommerce通过 WC_Cart 类中的 get_cross_sells() 方法来获取并显示购物车中的交叉销售商品。该方法的核心流程是遍历购物车中的每个商品，收集其关联的交叉销售商品ID，然后执行一个关键的过滤步骤：移除那些已存在于购物车中的交叉销售商品ID。这一过滤通常通过 $cross_sells = array_diff( $cross_sells, $in_cart ); 这行代码实现，旨在避免重复推荐顾客已购买或已在购物车中的商品。

尽管这种默认行为在许多场景下是合理且有益的，但有时商家可能希望无论商品是否已在购物车中，都能始终显示所有相关的交叉销售商品。例如，当商家希望强调某个特定系列的产品，或者希望提供一个更全面的“您可能还喜欢”列表时，就需要调整这一默认行为。

利用 woocommerce_cart_crosssell_ids 过滤器钩子

为了实现“始终显示所有交叉销售商品”的目标，我们需要修改WooCommerce获取交叉销售ID的默认行为。WooCommerce为此提供了一个名为 woocommerce_cart_crosssell_ids 的过滤器钩子。这个钩子允许开发者在交叉销售ID列表返回之前对其进行修改，是实现我们目标的首选方法，因为它允许我们完全重写或调整 get_cross_sells() 方法的输出，而无需直接修改WooCommerce的核心文件。

笔魂AI

笔魂AI绘画-在线AI绘画、AI画图、AI设计工具软件

403

查看详情

woocommerce_cart_crosssell_ids 过滤器接收两个参数：当前的交叉销售ID数组（$cross_sells）和购物车对象实例（$cart）。通过这两个参数，我们可以构建一个自定义的交叉销售商品ID列表。

实现自定义交叉销售逻辑

核心实现思路是：遍历购物车中的所有商品，收集每个商品关联的所有交叉销售商品ID，并将它们合并到一个新的列表中。关键在于，我们不再执行WooCommerce默认的 array_diff 操作来移除已在购物车中的商品。

以下是实现这一功能的PHP代码：

/**
 * 过滤 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();

    // 检查购物车是否为空，并遍历购物车中的每个商品项
    if ( ! $cart->is_empty() ) {
        foreach ( $cart->get_cart() as $cart_item_key => $values ) {
            // 确保商品数量大于0，以处理有效的购物车项
            if ( $values['quantity'] > 0 ) {
                // 获取当前购物车商品的交叉销售ID，并合并到总列表中
                // get_cross_sell_ids() 方法返回与当前商品关联的交叉销售商品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 );

代码解析：

1. filter_woocommerce_cart_crosssell_ids( $cross_sells, $cart ): 这是我们自定义的回调函数，它将被挂载到 woocommerce_cart_crosssell_ids 过滤器上。函数接收WooCommerce提供的默认交叉销售ID数组（$cross_sells）和当前的购物车对象（$cart）。
2. $all_cross_sells_ids = array();: 初始化一个空数组，用于累积所有从购物车商品中提取的交叉销售商品ID。
3. foreach ( $cart-youjiankuohaophpcnget_cart() as $cart_item_key => $values ): 遍历购物车中的每一个商品项。$values['data'] 包含了当前商品的产品对象。
4. $values['data']->get_cross_sell_ids(): 对于购物车中的每个商品，调用其产品对象的方法来获取与该商品关联的所有交叉销售商品ID。
5. $all_cross_sells_ids = array_merge( ..., $all_cross_sells_ids );: 将当前商品的交叉销售ID数组合并到 $all_cross_sells_ids 数组中。array_merge 会将所有ID累积起来。
6. $cross_sells = wp_parse_id_list( $all_cross_sells_ids );: 这是一个WordPress辅助函数，用于清理一个ID列表。它会确保列表中的ID是有效的整数，并且会自动去除重复的ID，最终返回一个干净、唯一的ID数组。这一步对于避免重复显示同一个交叉销售商品至关重要。
7. return $cross_sells;: 返回最终生成的交叉销售商品ID数组，这个数组将替代WooCommerce默认生成的列表。
8. 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商店中，这种影响可以忽略不计。
• 用户体验: 强制显示所有交叉销售商品可能会导致购物车页面上显示更多的推荐商品。请确保这符合您的用户体验设计和营销策略。过多或不相关的推荐可能会分散用户的注意力，反而降低转化率。
• 去重: wp_parse_id_list() 函数会自动处理ID的去重，确保每个交叉销售商品只显示一次，即使它被多个购物车商品关联。

总结

通过灵活利用 woocommerce_cart_crosssell_ids 过滤器，我们能够精确控制WooCommerce购物车中交叉销售商品的显示逻辑。上述方法提供了一种强大且非侵入性的方式，确保所有相关的交叉销售商品都能被展示给顾客，无论它们是否已存在于购物车中。这为商家提供了更大的营销自由度，有助于提升潜在的销售额和用户参与度，同时保持了代码的可维护性和兼容性。

以上就是WooCommerce购物车：强制显示所有交叉销售商品教程的详细内容，更多请关注php中文网其它相关文章！