本文旨在解决woocommerce结账页上一个商品推荐区块在用户添加推荐商品后仍重复显示的问题。通过优化php逻辑，我们确保推荐区块仅在特定触发商品存在且推荐商品尚未加入购物车时显示，从而提供更智能、用户友好的购物体验，避免不必要的重复提示。
在WooCommerce的结账页面，商家通常会根据购物车中已有的商品，动态地推荐其他相关商品或变体，以期提升销售额和用户体验。然而，一个常见的问题是，当用户点击推荐按钮将商品添加到购物车后，由于页面刷新，推荐区块可能会再次出现，导致重复提示，影响用户体验。本文将详细介绍如何通过优化PHP代码，实现一个智能的商品推荐区块，确保其在推荐商品已被添加到购物车后自动隐藏。
问题分析与原始实现回顾
最初的实现逻辑可能只检查了购物车中是否存在触发推荐的特定商品变体（例如，商品ID 100的变体111）。如果存在，就显示一个包含链接的区块，引导用户添加另一个变体（例如，商品ID 100的变体112）。以下是这种基本逻辑的示例代码：
add_action('woocommerce_review_order_before_submit', 'displays_cart_products_feature_image');
function displays_cart_products_feature_image() {
// 定义需要监控的商品ID
$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->get_id(), $product_ids ) && ($cart_item['variation_id'] == 111) ) {
$bool = true; // 如果找到触发变体，则可能需要显示推荐
}
}
// 如果满足条件，则显示推荐区块
if ($bool) {
echo '
';
}
}这种方法的问题在于，当用户点击“Add new item”按钮后，页面会重新加载，购物车内容更新。但上述代码在重新加载后，仍然会检测到变体111的存在，而没有检查变体112是否已经存在于购物车中，因此推荐区块会再次显示。尝试使用JavaScript隐藏区块是不可行的，因为页面刷新会重置JavaScript的状态。因此，解决方案必须在服务器端，即PHP中实现。
解决方案：基于购物车内容的双重校验
要解决这个问题，我们需要修改PHP逻辑，使其在显示推荐区块之前，进行双重校验：
- 首先，确认购物车中存在触发推荐的商品变体（例如，变体111）。
- 其次，确认购物车中不存在推荐的商品变体（例如，变体112）。
只有当这两个条件都满足时，推荐区块才应该显示。我们将通过在现有逻辑中增加一个额外的检查步骤来解决此问题。具体来说，在确认触发变体存在后，我们需要再检查推荐变体是否已存在。如果推荐变体已存在，则应将显示标志设置为 false。
实现步骤与优化代码
以下是修改后的 functions.php 代码示例，它通过两次遍历购物车来精确控制推荐区块的显示：
add_action('woocommerce_review_order_before_submit', 'displays_cart_products_feature_image');
function displays_cart_products_feature_image() {
// 定义需要监控的商品ID
$product_ids = array(100);
$display_recommendation = false; // 初始化显示推荐区块的标志
// 第一次遍历购物车：检查是否存在触发推荐的变体 (ID 100, 变体 111)
foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
$item = $cart_item['data'];
if ( in_array( $item->get_id(), $product_ids ) && ($cart_item['variation_id'] == 111) ) {
$display_recommendation = true; // 如果找到触发变体，则可能需要显示推荐
// 找到后可以不立即break，以确保遍历完所有商品，但对于本例，即使找到多个111也只设置一次true
}
}
// 第二次遍历购物车：如果已确定可能需要显示推荐，则检查推荐变体是否已在购物车中 (ID 100, 变体 112)
// 这一步是关键，它会覆盖第一次循环的结果，确保如果推荐商品已在购物车中，则最终不显示推荐
if ( $display_recommendation ) { // 只有当第一次遍历发现触发条件时才进行第二次检查，优化性能
foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
$item = $cart_item['data'];
if ( in_array( $item->get_id(), $product_ids ) && ($cart_item['variation_id'] == 112) ) {
$display_recommendation = false; // 如果推荐变体已在购物车中，则不显示推荐
break; // 找到即停止，提高效率
}
}
}
// 根据最终的标志位决定是否显示推荐区块
if ( $display_recommendation ) {
echo '
';
}
}代码解析
- add_action('woocommerce_review_order_before_submit', 'displays_cart_products_feature_image'); 这个WordPress和WooCommerce的钩子确保我们的 displays_cart_products_feature_image 函数在WooCommerce结账页的订单总览（Review Order）部分提交按钮之前执行。这是显示推荐内容的一个合适位置。
- $product_ids = array(100); 定义了一个数组，包含我们关注的商品ID。这使得代码更容易扩展到其他商品，只需在此数组中添加更多ID即可。
- $display_recommendation = false; 初始化一个布尔变量，作为是否显示推荐区块的标志。默认情况下，我们假设不需要显示推荐。
- 第一次循环（检测触发条件）： 第一个 foreach 循环遍历购物车中的所有商品项。它检查购物车中是否存在商品ID为100且变体ID为111的商品。如果找到，就将 $display_recommendation 设置为 true，表示满足了显示推荐的初步条件。
- 第二次循环（检测排除条件）： 在第一次循环结束后，如果 $display_recommendation 仍然为 true（意味着触发条件已满足），则进入第二个 foreach 循环。此循环再次遍历购物车，检查购物车中是否已存在商品ID为100且变体ID为112的商品（即我们推荐的商品）。如果找到，则将 $display_recommendation 重新设置为 false。这一步是整个解决方案的关键，它覆盖了第一次循环的结果，确保如果推荐商品已在购物车中，则最终不显示推荐。break 语句用于一旦找到目标商品就立即退出循环，提高效率。
- 条件显示： 最后，根据 $display_recommendation 的最终值，决定是否 echo 输出包含推荐链接的HTML区块。只有当 $display_recommendation 为 true 时，区块才会被渲染到页面上。
注意事项与最佳实践
- 代码位置: 将上述代码添加到主题的 functions.php 文件中。更推荐的做法是创建一个自定义插件来管理此类功能，以确保主题更新时代码不会丢失。
- 商品ID与变体ID: 确保 $product_ids 和 $cart_item['variation_id'] 的值与您的实际商品和变体ID匹配。这些ID可以在WooCommerce后台的产品编辑页面找到。
- $item->get_id(): 在WooCommerce中，推荐使用 $item->get_id() 方法来获取产品ID，而不是直接访问 $item->id，因为后者可能在未来的版本中被弃用或移除。
- 可扩展性: 如果需要推荐多个商品或基于更复杂的逻辑，可以扩展 $product_ids 数组，并调整循环内部的条件判断。例如，可以维护一个推荐商品与触发商品之间的映射关系。
- 用户体验: 这种服务器端控制方式确保了推荐区块的智能显示，避免了用户在添加商品后仍看到重复提示的困扰，从而提升了整体购物体验。
总结
通过在PHP中实现双重校验逻辑，我们成功解决了WooCommerce结账页推荐区块重复显示的问题。这种方法确保了推荐只在用户真正需要时出现，避免了不必要的干扰，提供了一个更加智能和用户友好的电商体验。这种服务器端控制的模式对于处理页面刷新后状态保持的问题至关重要，是构建健壮的电商功能不可或缺的一部分。
