本教程将指导您如何使用PHP在WooCommerce结账页面动态管理一个推荐商品块的显示。我们将解决一个常见问题：当用户将特定变体商品添加到购物车后，如何确保推荐块即使在页面刷新后也能持久地被移除，避免依赖客户端JavaScript带来的瞬时性问题。
引言
在电子商务网站中，根据用户购物车内容动态显示或隐藏某些信息或推荐是提升用户体验的常见做法。例如，当购物车中包含某个特定商品变体时，您可能希望推荐另一个相关的商品变体。然而，一个常见的挑战是，当用户点击推荐并添加到购物车后，页面通常会重新加载，导致任何客户端（JavaScript）实现的隐藏效果失效，推荐块再次出现。为了实现持久化的UI变更，我们需要依赖服务器端逻辑，即PHP。
问题描述
假设您在WooCommerce结账页面上有一个自定义的HTML块（例如，一个ID为u-1的div），它在购物车包含特定产品ID（例如100）的变体111时显示，并建议用户添加该产品ID100的另一个变体112。当用户点击“添加新商品”按钮并将变体112添加到购物车后，页面会刷新。此时，我们希望这个推荐块不再显示。仅仅使用JavaScript来隐藏该块是不可行的，因为页面刷新会导致其重新出现。因此，我们需要一种PHP解决方案来根据购物车内容的实时状态来控制其显示。
PHP解决方案：基于购物车内容的条件判断
核心思想是利用WooCommerce的购物车数据，在渲染结账页面之前，通过PHP判断购物车中是否已经包含了我们不希望推荐块显示的特定变体。
立即学习“PHP免费学习笔记（深入）”；
我们将使用woocommerce_review_order_before_submit这个WooCommerce动作钩子，它允许我们在结账页面的“提交订单”按钮之前插入自定义内容。在这个钩子中，我们将编写一个函数来检查购物车中的商品。
解决方案代码
将以下代码添加到您的WordPress主题的functions.php文件或通过自定义插件添加：
add_action('woocommerce_review_order_before_submit', 'displays_cart_products_feature_image_conditional');
/**
* 根据购物车内容动态显示或隐藏推荐块。
*/
function displays_cart_products_feature_image_conditional() {
// 定义需要检查的产品ID
$target_product_id = 100;
// 定义触发推荐块显示的变体ID
$trigger_variation_id = 111;
// 定义一旦添加到购物车就应隐藏推荐块的变体ID
$hide_variation_id = 112;
$display_block = false; // 默认不显示推荐块
// 第一次遍历购物车：检查是否包含触发推荐块显示的变体
foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
$item_data = $cart_item['data']; // 获取产品数据对象
// 检查产品ID和变体ID是否匹配触发条件
if ( $item_data->get_id() == $target_product_id && $cart_item['variation_id'] == $trigger_variation_id ) {
$display_block = true; // 如果找到触发变体，则标记为显示
break; // 找到即停止遍历，提高效率
}
}
// 第二次遍历购物车：检查是否包含应隐藏推荐块的变体
// 这一步是关键，它会覆盖第一次遍历的结果，实现持久化隐藏
if ( $display_block ) { // 只有在第一次遍历标记为显示时才需要进行第二次检查
foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
$item_data = $cart_item['data'];
// 检查产品ID和变体ID是否匹配隐藏条件
if ( $item_data->get_id() == $target_product_id && $cart_item['variation_id'] == $hide_variation_id ) {
$display_block = false; // 如果找到隐藏变体，则标记为不显示
break; // 找到即停止遍历
}
}
}
// 根据最终的 $display_block 状态决定是否输出HTML块
if ( $display_block ) {
echo '
<div id="u-1">
<a href="/?add-to-cart=' . esc_attr($target_product_id) . '&variation_id=' . esc_attr($hide_variation_id) . '">添加新商品</a>
</div>';
}
}代码解析
-
add_action('woocommerce_review_order_before_submit', 'displays_cart_products_feature_image_conditional');:
- 这是一个WordPress/WooCommerce钩子，确保我们的函数在结账页面“提交订单”按钮之前执行。
-
变量定义:
- $target_product_id: 目标产品的ID，例如100。
- $trigger_variation_id: 触发推荐块显示的变体ID，例如111。
- $hide_variation_id: 一旦添加到购物车就应隐藏推荐块的变体ID，例如112。
- $display_block = false;: 初始化一个布尔变量，用于控制最终是否显示推荐块。默认设置为false。
-
第一次购物车遍历 (检查触发条件):
- foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ): 遍历当前购物车中的所有商品。
- $item_data = $cart_item['data'];: 获取购物车商品项的产品数据对象。
- $item_data->get_id() == $target_product_id && $cart_item['variation_id'] == $trigger_variation_id: 检查当前商品是否是目标产品，并且其变体ID是否与$trigger_variation_id匹配。
- 如果匹配，$display_block被设置为true，表示我们应该显示推荐块。break语句用于优化，一旦找到匹配项就停止遍历。
-
第二次购物车遍历 (检查隐藏条件):
- if ( $display_block ): 这一步非常关键。只有当第一次遍历已经确定应该显示推荐块时，我们才需要进行第二次检查。这避免了不必要的遍历。
- 再次遍历购物车，检查是否存在$target_product_id且变体ID为$hide_variation_id的商品。
- 如果找到这样的商品，意味着用户已经添加了推荐的变体，此时将$display_block设置为false，从而覆盖第一次遍历的结果，确保推荐块不会显示。break语句同样用于优化。
-
条件输出HTML:
- if ( $display_block ): 最后，根据$display_block的最终值，决定是否输出包含推荐链接的HTML块。
- esc_attr(): 用于对URL参数进行转义，提高安全性。
注意事项与最佳实践
- 代码位置: 建议将此代码放入子主题的functions.php文件，或者创建一个自定义插件。直接修改父主题的functions.php会在主题更新时丢失更改。
- 产品ID和变体ID: 确保您代码中使用的产品ID和变体ID是正确的。您可以在WooCommerce后台编辑产品时找到这些ID。
- 可扩展性: 如果您有多个类似的需求，可以考虑将产品ID和变体ID存储在数组中，并通过更通用的循环逻辑来处理，而不是为每个产品硬编码。
- 用户体验: 确保推荐链接的文案清晰明了，引导用户进行操作。
- 缓存: 如果您使用了页面缓存插件，请确保结账页面没有被过度缓存，或者配置缓存规则以允许动态内容正确显示。
总结
通过在woocommerce_review_order_before_submit钩子中利用PHP对购物车内容进行两次条件判断，我们成功实现了一个持久化的解决方案，用于动态管理WooCommerce结账页面的推荐块。这种方法确保了推荐块的显示状态完全基于服务器端的购物车实际内容，即使在页面刷新后也能保持一致，从而提供了更稳定和用户友好的体验。这种服务器端逻辑的应用是处理动态电子商务UI元素时，尤其是在涉及页面重载的情况下，不可或缺的关键技术。
