WordPress自定义文章类型关联自定义字段搜索功能异常求解

现有代码问题 #

• 查询逻辑错误：默认WordPress搜索的标题/内容匹配规则 和 你添加的自定义字段匹配规则是AND关系，必须同时满足才会返回结果，所以仅存在于自定义字段的ISBN、作者名搜索自然无返回
• 模糊匹配缺失：meta_query使用LIKE对比时，WordPress不会自动为搜索词添加前后%，相当于精确匹配，会漏掉包含搜索词的结果
• 多余的嵌套逻辑：两层OR的relation没有实际作用，属于冗余代码

修复后完整代码 #

class Search {
    // 缓存转义后的搜索词，避免重复处理
    private $safe_search_key = '';

    public function __construct() {
        add_action( 'pre_get_posts', array( $this, 'customize_search_query' ) );
    }

    public function customize_search_query( $query ) {
        // 仅处理前台主搜索查询
        if ( is_admin() || ! $query->is_main_query() || ! is_search() ) {
            return $query;
        }

        $this->safe_search_key = esc_sql( get_search_query() );
        // 设置搜索的文章类型
        $query->set( 'post_type', 'book' );

        // 配置自定义字段搜索规则
        $meta_query = array(
            'relation' => 'OR',
            array(
                'key'     => 'book_writer',
                'value'   => $this->safe_search_key,
                'compare' => 'LIKE',
            ),
            array(
                'key'     => 'book_isbn',
                'value'   => $this->safe_search_key,
                'compare' => 'LIKE',
            ),
        );
        $query->set( 'meta_query', $meta_query );

        // 挂载钩子修改查询逻辑，将自定义字段匹配和默认搜索规则改为OR关系
        add_filter( 'posts_where', array( $this, 'modify_search_where_clause' ) );
        // 查询完成后自动移除钩子，避免污染其他查询
        add_action( 'posts_selection', array( $this, 'clear_custom_hooks' ) );

        return $query;
    }

    public function modify_search_where_clause( $where ) {
        global $wpdb;
        // 把默认搜索和自定义字段查询的AND关系改为OR
        $where = str_replace(
            "AND ({$wpdb->postmeta}.meta_key = 'book_writer'",
            "OR ({$wpdb->postmeta}.meta_key = 'book_writer'",
            $where
        );
        // 为LIKE匹配添加前后%实现模糊搜索
        $where = str_replace(
            "'{$this->safe_search_key}'",
            "%{$this->safe_search_key}%",
            $where
        );
        return $where;
    }

    public function clear_custom_hooks() {
        remove_filter( 'posts_where', array( $this, 'modify_search_where_clause' ) );
        remove_action( 'posts_selection', array( $this, 'clear_custom_hooks' ) );
    }
}

// 初始化搜索类即可生效
new Search();

效果说明 #

修改后搜索逻辑变为：搜索词匹配文章标题/内容 或者 匹配book_writer字段 或者 匹配book_isbn字段，满足任意一个条件就会返回对应book类型的文章，不需要安装额外插件。

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