本教程详细阐述了如何在WooCommerce结账页面上，根据购物车内容动态地显示或隐藏一个推荐区块。核心问题在于，当用户点击推荐并添加商品后，页面刷新会导致区块重新出现。通过优化PHP逻辑，我们确保当推荐的商品变体已存在于购物车中时，该推荐区块能够持久地被隐藏，从而提供更智能、用户友好的购物体验，避免重复推荐。
在电子商务网站中，尤其是在结账流程中，向用户推荐相关或升级商品是一种常见的营销策略。WooCommerce允许开发者通过钩子（hooks）在结账页面的特定位置插入自定义内容。然而，当这些内容是基于购物车状态的动态推荐时，需要特别注意其显示逻辑，以避免重复和不必要的提示。本教程将指导您如何精确控制一个推荐区块的显示，确保在用户已经采纳推荐后，该区块能够正确地隐藏。
问题描述：动态推荐区块的持久化隐藏
设想这样一个场景：您的WooCommerce商店在结账页面上显示一个推荐区块，例如，当购物车中包含产品ID为100的变体111时，系统会建议用户添加产品ID为100的变体112。最初的实现可能通过检查购物车中是否存在变体111来决定是否显示这个推荐。
add_action('woocommerce_review_order_before_submit', 'displays_cart_products_feature_image');
function displays_cart_products_feature_image() {
$product_ids = array(100);
$bool = false; // 标记是否需要显示推荐
// 检查购物车中是否存在触发推荐的商品变体 (ID 100, 变体 111)
foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
$item = $cart_item['data'];
if ( in_array( $item->id, $product_ids ) && ($cart_item['variation_id'] == 111) ) {
$bool = true;
break; // 找到即退出循环
}
}
// 如果需要显示推荐，则输出HTML区块
if ($bool) {
echo '
<div id="u-1">
<a href="/?add-to-cart=100&variation_id=112">Add new item</a>
</div>';
}
}上述代码能够实现在特定条件下显示推荐区块。然而，核心挑战在于，当用户点击“Add new item”按钮并成功将变体112添加到购物车后，页面会重新加载。由于页面重新加载，JavaScript隐藏区块的方法将失效，导致推荐区块再次出现，这会给用户带来不佳的体验，因为它重复推荐了一个已经添加的商品。为了解决这个问题，我们需要在服务器端（PHP）实现更智能的逻辑，确保区块在变体112已存在于购物车时不再显示。
解决方案：基于PHP的持久化条件判断
解决此问题的关键在于扩展PHP的条件判断逻辑。除了检查触发推荐的变体111是否存在外，我们还需要检查被推荐的变体112是否已经存在于购物车中。如果变体112已经存在，那么即使变体111也存在，推荐区块也不应再显示。
以下是优化后的PHP代码实现：
add_action('woocommerce_review_order_before_submit', 'displays_cart_products_feature_image');
function displays_cart_products_feature_image() {
// 定义我们关注的产品ID
$product_ids = array(100);
// 初始化一个布尔值，用于标记是否应该显示推荐区块
$should_display_recommendation = false;
// 第一次遍历购物车：检查是否存在触发推荐的变体 (ID 100, 变体 111)
foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
$item = $cart_item['data'];
// 如果找到产品ID 100 且变体ID为 111，则标记为需要显示推荐
if ( in_array( $item->id, $product_ids ) && ($cart_item['variation_id'] == 111) ) {
$should_display_recommendation = true;
break; // 找到即退出，无需继续遍历
}
}
// 第二次遍历购物车（或在第一次遍历中扩展逻辑）：检查推荐的变体是否已存在
// 这一步至关重要，它决定了推荐是否应该被取消
if ($should_display_recommendation) { // 只有在需要显示推荐时才进行此检查
foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
$item = $cart_item['data'];
// 如果购物车中已经存在产品ID 100 且变体ID为 112（即已添加推荐商品）
if ( in_array( $item->id, $product_ids ) && ($cart_item['variation_id'] == 112) ) {
$should_display_recommendation = false; // 将标记设置为false，取消显示推荐
break; // 找到即退出
}
}
}
// 根据最终的布尔值决定是否输出推荐区块
if ($should_display_recommendation) {
echo '
<div id="u-1">
<a href="/?add-to-cart=100&variation_id=112">Add new item</a>
</div>';
}
}代码解析与注意事项
- 钩子 (woocommerce_review_order_before_submit): 此钩子确保我们的自定义内容在结账页面的订单总览（review order）部分提交按钮之前显示。这是一个常见的放置推荐或优惠信息的理想位置。
- 初始化 $should_display_recommendation: 我们使用一个布尔变量 $should_display_recommendation 来跟踪是否应该显示推荐区块。它首先被设置为 false。
-
第一次购物车遍历:
- 此循环的目的是检查购物车中是否存在触发推荐的条件（本例中是产品ID 100 的变体 111）。
- 如果找到，$should_display_recommendation 被设置为 true，并立即 break 退出循环，提高效率。
-
第二次购物车遍历（取消推荐逻辑）:
- 关键: 只有当 $should_display_recommendation 仍为 true 时，才执行此检查。这避免了不必要的遍历。
- 此循环检查购物车中是否已经包含被推荐的商品变体（产品ID 100 的变体 112）。
- 如果找到变体 112，这意味着用户已经采纳了推荐，此时应将 $should_display_recommendation 重新设置为 false，并 break 退出循环。
- 最终条件判断: 最后，代码根据 $should_display_recommendation 的最终值来决定是否输出推荐区块的HTML。
总结
通过在PHP层面对购物车内容进行更全面的检查，我们成功地解决了页面刷新导致动态推荐区块重复显示的问题。这种方法确保了推荐逻辑的持久性和一致性，无论用户何时刷新页面，推荐区块的显示状态都将准确反映购物车中的实际商品。这种服务器端（PHP）的解决方案比客户端（JavaScript）方案更健壮，因为它直接处理了数据状态，而不是依赖于页面的瞬时状态。在开发WooCommerce插件或自定义功能时，理解并运用这种基于PHP的条件逻辑对于创建流畅、用户友好的购物体验至关重要。
