本文介绍如何通过 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 );
}
}
✅ 关键优化说明：
PHP168 行业B2B
解决问题如下：只列举最近用户提交问题，其余问题前面几次补丁已经解决，不在复述。1、解决搜索问题。以前搜索一定要确定到省下面的某个市，这个不符合用户体验。 现在改为，省–所有城市（默认为所有城市，也可以自己选择某个市）。2、解决首页推荐产品部显示问题。（以前没有考虑多个其他浏览器）3、解决供应、求购 今日产品显示问题。（理由同上）4、解决收藏商家、供应、求购问题。 （链接错误）5、解决后台分类过
- 使用 ‘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 钩子互为补充：前者负责「前端可见性控制」，后者负责「加购环节二次校验」，二者结合即可实现健壮、友好的课程购买体验。