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

本文介绍如何通过 pre_get_posts 钩子动态过滤 woocommerce 商店页（shop）的产品列表，使已购买过某商品的登录用户无法再次看到该商品，从而避免重复购买并优化学员课程展示体验。

在构建基于 LearnDash + WooCommerce 的在线学习平台（LMS）时，一个常见需求是：当学员已完成某门付费课程的购买后，该课程商品不应再出现在商店首页或分类页中——既防止重复下单，也提升页面相关性与用户体验。上述目标无法仅靠 woocommerce_add_to_cart_validation 钩子实现（它仅拦截加购行为），而需从查询源头进行干预。

核心思路是：在 WooCommerce 主产品查询执行前，获取当前用户所有已完成/待处理订单中的商品 ID，并通过 post__not_in 参数将其从主循环中排除。以下是推荐的完整实现方案：

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 ( 0 === $current_user->ID ) {         return; // 未登录用户不处理     }      // 查询该用户所有有效订单（已完成、已付款等）     $customer_orders = get_posts( array(         'numberposts' => -1,         'meta_key'    => '_customer_user',         'meta_value'  => $current_user->ID,         'post_type'   => 'shop_order',         'post_status' => array( 'wc-processing', 'wc-completed', 'wc-on-hold' ), // 可按需扩展状态         'fields'      => 'ids', // 仅获取ID，提升性能     ) );      if ( empty( $customer_orders ) ) {         return;     }      $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_variation_id() ?: $item->get_product_id();             if ( $product_id ) {                 $product_ids[] = $product_id;             }         }     }      // 去重并设置查询过滤     $product_ids = array_unique( array_filter( $product_ids ) );     if ( ! empty( $product_ids ) ) {         $query->set( 'post__not_in', $product_ids );     } }

✅ 关键优化说明：

• 使用 ‘fields’ => ‘ids’ 显著减少数据库负载；
• 支持变体商品（通过 get_variation_id() 优先获取变体ID）；
• 包含 wc-on-hold 状态，确保支付待确认订单也被识别；
• 严格校验 is_main_query() 和 is_shop()，避免影响搜索页、分类页或后台查询（如需扩展至分类页，可将 is_shop() 替换为 is_post_type_archive(‘product’) || is_tax(‘product_cat’) || is_tax(‘product_tag’)）。

⚠️ 注意事项：

• 此代码需添加至当前启用主题的 functions.php 文件中（建议使用子主题）；
• 若使用对象缓存（如 redis），可能需配合 wp_cache_flush() 或缓存键策略以保证实时性；
• 对于高并发站点，可考虑引入用户级 transient 缓存已购商品 ID（例如 set_transient( “user_{$user_id}_purchased_products”, $product_ids, DAY_IN_SECONDS )），进一步降低查询压力。

该方案与您原有的 woocommerce_add_to_cart_validation 钩子互为补充：前者负责「前端可见性控制」，后者负责「加购环节二次校验」，二者结合即可实现健壮、友好的课程购买体验。