如何在 WooCommerce 商店页面中自动隐藏用户已购商品

本文介绍如何通过 pre_get_posts 钩子动态过滤 woocommerce 商品列表，使已购买商品对当前登录用户完全不可见，既防止重复购买，又提升 lms 类站点（如 learndash + woocommerce）的课程展示体验。

在构建基于 WooCommerce 的在线学习平台（如 LearnDash 集成场景）时，一个常见且关键的用户体验需求是：当用户已成功购买某门课程（即对应可售商品）后，该商品不应再出现在商店首页（Shop 页面）的商品网格中。这不仅能避免用户误点重复下单，还能让界面更聚焦于“待购课程”，提升导航清晰度与转化效率。

实现这一目标的核心思路是：在 WooCommerce 主商品查询执行前，动态排除当前用户已购商品的 ID 列表。相比仅拦截加购（如 woocommerce_add_to_cart_validation），此方案更彻底——商品从源头上不参与查询、不渲染、不暴露，真正实现“视觉级隐藏”。

以下是推荐使用的完整解决方案，需将代码添加至当前主题的 functions.php 文件中：

add_action( 'pre_get_posts', 'hide_product_from_shop_page_if_user_already_purchased', 20 );  function hide_product_from_shop_page_if_user_already_purchased( $query ) {     // 仅作用于前台主查询，跳过后台及非主循环     if ( ! $query->is_main_query() || is_admin() || ! is_shop() ) {         return;     }      $current_user = wp_get_current_user();     if ( $current_user->ID === 0 ) { // 未登录用户不处理         return;     }      // 查询该用户所有已完成/处理中的订单     $customer_orders = get_posts( array(         'posts_per_page' => -1,         'post_type'      => 'shop_order',         'post_status'    => array( 'wc-completed', 'wc-processing' ),         'meta_key'       => '_customer_user',         'meta_value'     => $current_user->ID,         'fields'         => 'ids', // 仅获取订单 ID，提升性能     ) );      if ( empty( $customer_orders ) ) {         return;     }      $purchased_product_ids = array();      // 遍历每个订单，提取所购商品 ID（含变体）     foreach ( $customer_orders as $order_id ) {         $order = wc_get_order( $order_id );         if ( ! $order ) {             continue;         }          foreach ( $order->get_items() as $item ) {             $product_id = $item->get_product_id();             if ( $product_id ) {                 $purchased_product_ids[] = $product_id;             }         }     }      // 去重并确保为整数数组     $purchased_product_ids = array_unique( array_map( 'absint', $purchased_product_ids ) );      if ( ! empty( $purchased_product_ids ) ) {         $query->set( 'post__not_in', $purchased_product_ids );     } }

✅ 关键优化说明：

• 使用 ‘fields’ => ‘ids’ 显著减少数据库负载；
• absint() 确保 ID 安全转为正整数，防范潜在类型异常；
• 严格限定 is_shop() 和 !is_admin()，避免影响分类页、搜索页或后台管理；
• 仅对已登录用户生效，游客仍可见全部商品。

⚠️ 注意事项：

• 此逻辑不影响商品详情页直接访问（如用户通过书签进入）。若需全局拦截，应额外结合 template_redirect 或产品模板内条件判断；
• 对于变体商品（Variable Product），$item->get_product_id() 返回的是变体 ID（而非父商品 ID），因此变体购买后，仅该变体被隐藏——如需隐藏整个父商品，请改用 $item->get_variation_id() ? $item->get_parent_id() : $product_id；
• 若使用对象缓存（如 redis、memcached），可能需清除相关查询缓存以确保实时性；
• 建议搭配前端 js 做二次校验（如禁用已购商品的“加入购物车”按钮），增强健壮性。

该方案简洁、高效、符合 wordPress/WooCommerce 最佳实践，已在 LearnDash + WooCommerce 多项目中稳定运行，是构建专业学习门户不可或缺的用户体验优化环节。