本文介绍如何通过 `pre_get_posts` 钩子动态过滤 woocommerce 商品列表，使已购买指定商品的登录用户在 shop 页面中完全看不到这些商品，从而避免重复购买并优化学员课程展示体验。

在基于 LearnDash + WooCommerce 构建的在线学习平台（LMS）中，一个常见需求是：当学员已购买某门课程（即对应 WooCommerce 虚拟商品）后，在全局商店（Shop）页面中不应再显示该商品——这既可防止重复购买，又能提升用户体验（例如仅展示“可报名的新课”）。

实现这一目标的关键在于在商品查询阶段就排除已购商品 ID，而非依赖前端隐藏或 JS 过滤。推荐使用 WordPress 核心的 pre_get_posts 动作钩子，在主查询执行前修改 WP_Query 参数，精准控制输出结果。

以下是完整、安全、高性能的实现方案（请将代码添加至当前主题的 functions.php 文件中）：

名品购物网店系统

适合品牌专卖店专用，从前台的美工设计就开始强调视觉形象，有助于提升商品的档次，打造网店品牌!后台及程序核心比较简洁，着重在线购物，去掉了繁琐的代码及垃圾程式，在结构上更适合一些中高档的时尚品牌商品展示. 率先引入语言包机制，可在1小时内制作出任何语言版本，程序所有应用文字皆引自LANG目录下的语言包文件，独特的套图更换功能，三级物品分类，购物车帖心设计，在国内率先将购物车与商品显示页面完美结合，完

下载

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 ) {
    // 仅作用于前台主查询（排除后台、Ajax、其他自定义查询）
    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(
        '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;
    }

    // 提取所有已购商品 ID（含变体父级与子级）
    $product_ids = array();
    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 ) {
                $product_ids[] = $product_id;
            }
        }
    }

    // 去重并设置查询排除项
    $product_ids = array_unique( $product_ids );
    if ( ! empty( $product_ids ) ) {
        $query->set( 'post__not_in', $product_ids );
    }
}

✅ 关键说明与注意事项：

• 性能优化：使用 ‘fields’ => ‘ids’ 减少数据库负载；遍历订单时跳过无效 $order 对象；array_unique() 防止重复 ID 影响查询。
• 兼容变体商品：$item->get_product_id() 自动返回变体的实际商品 ID（非变体 ID），确保父商品和所有变体均被正确隐藏。
• 状态可控：当前仅排除 wc-completed 和 wc-processing 订单，如需包含 wc-on-hold 或其他状态，可按需扩展 ‘post_status’ 数组。
• 不影响其他页面：is_shop() 确保仅作用于默认商店首页；如需扩展至分类页（is_product_category()）或搜索页（is_search()），可调整条件判断。
• 不干扰原验证逻辑：本方案与您原有的 woocommerce_add_to_cart_validation 钩子互补——前者前置隐藏，后者实时拦截，双重保障更稳健。

? 进阶建议：
若站点商品量极大（>5k），可考虑将已购商品 ID 缓存至用户元字段（如 user_meta），并通过 wp_cache_set() 实现对象缓存，进一步降低每次请求的查询开销。

通过以上方案，您的学员访问 Shop 页面时，系统将自动呈现“个性化课程目录”，真正实现“所见即所需”。

https://www.php.cn/faq/1964283.html