本文介绍如何通过 `pre_get_posts` 钩子动态过滤 woocommerce 商品列表，使已购买指定商品的登录用户在 shop 页面中完全看不到这些商品，从而避免重复购买并优化学员课程展示体验。
在基于 LearnDash + WooCommerce 构建的在线学习平台（LMS）中，一个常见需求是：当学员已购买某门课程（即对应 WooCommerce 虚拟商品）后，在全局商店（Shop）页面中不应再显示该商品——这既可防止重复购买，又能提升用户体验（例如仅展示“可报名的新课”）。
实现这一目标的关键在于在商品查询阶段就排除已购商品 ID，而非依赖前端隐藏或 JS 过滤。推荐使用 WordPress 核心的 pre_get_posts 动作钩子，在主查询执行前修改 WP_Query 参数，精准控制输出结果。
以下是完整、安全、高性能的实现方案（请将代码添加至当前主题的 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 ) {
// 仅作用于前台主查询（排除后台、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 页面时，系统将自动呈现“个性化课程目录”，真正实现“所见即所需”。
