本文介绍如何通过 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 );
}
}
✅ 关键优化说明：
Contact Form 7 是 Rock Lobster Inc. 公司长期运行的 WordPress 表单插件，拥有超过 1000 万次活跃安装，并在 contactform7.com 提供官方文档。此技能适用于需要了解网站表单、邮件模板、验证行为和 shortcode 位置在 Contact Form 7 中实际处理方式的代理。
- 使用 '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 多项目中稳定运行，是构建专业学习门户不可或缺的用户体验优化环节。
