如何让Search & Filter插件搜索返回ACF元键对应值的产品结果

我用Search & Filter插件做产品的搜索筛选功能，但当前搜不到关联ACF元键/值的结果。比如用户搜“artsy”时页面显示“无结果”，但明明有元值为“Artsy”的产品，我希望这类产品能被搜索到。注：该插件用_sf_s作为查询参数。

以下是我尝试的代码：

function filter_search_by_acf_meta_keys($query) {
    if (is_admin() || !$query->is_main_query()) {
        return;
    }

    // 检查Search & Filter Pro插件是否激活
    if (isset($_GET['_sf_s']) && !empty($_GET['_sf_s'])) {
        $search_query = sanitize_text_field($_GET['_sf_s']);

        $meta_query = array(
            'relation' => 'OR',
            array(
                'key'     => 'keywords_tags', 
                'value'   => $search_query,
                'compare' => 'LIKE'
            ),
            array(
                'key'     => 'region_field',
                'value'   => $search_query,
                'compare' => 'LIKE'
            )
            // 按需添加更多ACF元键
        );

        $query->set('meta_query', $meta_query);
        $query->set('s', $search_query);
    }

    $query->set('post_type', array('products', 'listings'));
}
add_action('pre_get_posts', 'filter_search_by_acf_meta_keys');

你的代码有几个关键问题导致无法匹配ACF元值，以下是修正方案：

问题点分析 #

1. 大小写匹配限制：MySQL默认LIKE查询区分大小写，导致小写的“artsy”匹配不到大写开头的“Artsy”。
2. 查询关系冲突：同时设置s（原生搜索）和meta_query时，WP默认是AND关系，要求文章同时满足原生搜索（标题/内容）和元值匹配，过滤掉了仅元值符合的结果。
3. 钩子优先级不足：Search & Filter插件自身会修改查询，你的代码优先级不够，可能被插件覆盖。

修正后的代码 #

function filter_search_by_acf_meta_keys($query) {
    // 只处理前台主查询，且是Search & Filter的搜索请求
    if (is_admin() || !$query->is_main_query() || !isset($_GET['_sf_s']) || empty($_GET['_sf_s'])) {
        return;
    }

    $search_query = sanitize_text_field($_GET['_sf_s']);
    
    // 构建不区分大小写的元查询
    $meta_query = array(
        'relation' => 'OR',
        array(
            'key'     => 'keywords_tags',
            'value'   => $search_query,
            'compare' => 'REGEXP', // REGEXP默认不区分大小写
            'type'    => 'CHAR'
        ),
        array(
            'key'     => 'region_field',
            'value'   => $search_query,
            'compare' => 'REGEXP',
            'type'    => 'CHAR'
        )
        // 可继续添加需要搜索的ACF元键
    );

    // 合并插件原有元查询，保持OR关系
    $original_meta = $query->get('meta_query', array());
    if (!empty($original_meta)) {
        $meta_query = array(
            'relation' => 'OR',
            $original_meta,
            $meta_query
        );
    }

    $query->set('meta_query', $meta_query);
    
    // 如果不需要原生搜索（只搜ACF元值），可以注释掉下面这行
    // $query->set('s', $search_query);
    
    // 指定要搜索的文章类型
    $query->set('post_type', array('products', 'listings'));
}
// 提高钩子优先级，确保在插件之后执行
add_action('pre_get_posts', 'filter_search_by_acf_meta_keys', 20);

备选方案：直接修改SQL实现混合搜索 #

如果需要同时匹配文章标题/内容和ACF元值，用下面的代码更可靠：

function add_acf_meta_to_search($where) {
    if (is_admin() || !is_search() || !isset($_GET['_sf_s']) || empty($_GET['_sf_s'])) {
        return $where;
    }

    global $wpdb;
    $search_term = '%' . $wpdb->esc_like(sanitize_text_field($_GET['_sf_s'])) . '%';

    // 把ACF元值匹配加入搜索条件，和原生搜索为OR关系
    $where .= " OR ({$wpdb->postmeta}.meta_key = 'keywords_tags' AND {$wpdb->postmeta}.meta_value LIKE '{$search_term}')";
    $where .= " OR ({$wpdb->postmeta}.meta_key = 'region_field' AND {$wpdb->postmeta}.meta_value LIKE '{$search_term}')";

    return $where;
}
add_filter('posts_where', 'add_acf_meta_to_search');

function join_postmeta_table($join) {
    if (is_admin() || !is_search() || !isset($_GET['_sf_s']) || empty($_GET['_sf_s'])) {
        return $join;
    }

    global $wpdb;
    // 连接postmeta表，避免重复连接
    if (strpos($join, $wpdb->postmeta) === false) {
        $join .= " LEFT JOIN {$wpdb->postmeta} ON {$wpdb->posts}.ID = {$wpdb->postmeta}.post_id";
    }

    return $join;
}
add_filter('posts_join', 'join_postmeta_table');

function distinct_search_results($distinct) {
    if (is_admin() || !is_search() || !isset($_GET['_sf_s']) || empty($_GET['_sf_s'])) {
        return $distinct;
    }

    // 去重，避免同一文章因多个元值匹配重复显示
    return 'DISTINCT';
}
add_filter('posts_distinct', 'distinct_search_results');

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