如何在WooCommerce中根据用户选择的地区过滤所有产品查询？

核心思路 #

要实现需求，需要同时满足两个过滤条件：

1. 产品必须包含匹配用户选中地区的变体
2. 该地区对应的变体必须有库存

下面提供两种可行方案，优先推荐第一种（SQL查询级过滤，性能更优）。

方案1：通过修改产品查询SQL实现高效过滤 #

直接在WooCommerce产品查询阶段加入关联条件，从数据库层面过滤不符合要求的产品，适合产品数量较多的场景。

add_action( 'woocommerce_product_query', 'filter_products_by_user_region' );
function filter_products_by_user_region( $query ) {
    // 仅对前台主产品查询生效，避免干扰后台管理
    if ( is_admin() || !$query->is_main_query() || !is_woocommerce() ) {
        return;
    }

    // 替换为你实际获取用户选中地区slug的逻辑（比如从session/用户元数据读取）
    $selected_region = get_user_selected_region_slug();
    if ( empty($selected_region) ) {
        return;
    }

    global $wpdb;
    // 关联变体表、属性表和库存表
    $query->query_vars['join'] .= "
        INNER JOIN {$wpdb->prefix}postmeta AS pm_var ON {$wpdb->posts}.ID = pm_var.post_parent
        INNER JOIN {$wpdb->prefix}postmeta AS pm_region ON pm_var.post_id = pm_region.post_id
        INNER JOIN {$wpdb->prefix}postmeta AS pm_stock ON pm_var.post_id = pm_stock.post_id
    ";

    // 添加过滤条件
    $query->query_vars['where'] .= $wpdb->prepare("
        AND pm_var.meta_key = '_variation_id'
        AND pm_region.meta_key = 'attribute_pa_region'  // 替换为你的地区属性slug（前缀attribute_pa_固定）
        AND pm_region.meta_value = %s
        AND pm_stock.meta_key = '_stock'
        AND pm_stock.meta_value > 0
        AND {$wpdb->posts}.post_status = 'publish'
    ", $selected_region);

    // 去重，避免同一产品因多个匹配变体重复显示
    $query->query_vars['groupby'] = "{$wpdb->posts}.ID";
}

关键注意事项 #

• 替换get_user_selected_region_slug()为你实际获取用户地区的函数（比如WC()->session->get('selected_region')）
• 替换attribute_pa_region中的pa_region为你的地区属性slug（在产品属性设置中查看，比如属性slug是area则写attribute_pa_area）

方案2：逐个产品验证（逻辑更直观，适合小体量产品库） #

通过woocommerce_product_is_visible钩子逐个检查产品是否符合条件，逻辑易懂但性能略逊于SQL级过滤。

add_filter( 'woocommerce_product_is_visible', 'check_product_region_stock_visibility', 10, 2 );
function check_product_region_stock_visibility( $is_visible, $product_id ) {
    $selected_region = get_user_selected_region_slug();
    if ( empty($selected_region) ) {
        return $is_visible;
    }

    $product = wc_get_product( $product_id );
    // 若你所有产品都是可变产品，可跳过简单产品判断
    if ( $product->is_type('simple') ) {
        return $is_visible;
    }

    $has_valid_variation = false;
    foreach ( $product->get_available_variations() as $variation ) {
        // 匹配地区属性
        if ( isset($variation['attributes']['attribute_pa_region']) && $variation['attributes']['attribute_pa_region'] === $selected_region ) {
            // 检查库存状态
            if ( $variation['is_in_stock'] ) {
                $has_valid_variation = true;
                break;
            }
        }
    }

    return $has_valid_variation ? $is_visible : false;
}

测试验证要点 #

1. 确认用户选中的地区slug与变体属性值完全匹配（大小写敏感）
2. 测试三种场景：无对应地区变体的产品、有变体但缺货的产品、符合条件的产品
3. 测试前清空网站缓存，避免旧查询结果干扰

内容的提问来源于stack exchange，提问作者LAZ