基于自定义分类法隐藏自定义文章类型的搜索结果

当然可以通过functions.php添加过滤器实现这个需求，我之前做过类似的功能，给你一步步拆解实现方案：

1. 先确认自定义分类法与「hidden」术语的设置 #

首先要确保你的自定义文章类型（比如假设叫custom_post_type）已经关联了对应的自定义分类法，并且已经创建了hidden这个术语。如果还没注册分类法，可以先在functions.php里添加这段代码：

// 注册自定义分类法（用于标记内容是否隐藏）
function register_post_visibility_taxonomy() {
    $args = array(
        'label' => '内容可见性',
        'public' => true,
        'hierarchical' => true,
        'show_ui' => true,
        'show_in_rest' => true, // 适配古腾堡编辑器
        'rewrite' => array('slug' => 'post-visibility'),
    );
    // 把第二个参数换成你的自定义文章类型slug
    register_taxonomy('post_visibility', 'custom_post_type', $args);
}
add_action('init', 'register_post_visibility_taxonomy');

执行这段代码后，去后台的自定义文章类型编辑页，就能看到新增的「内容可见性」分类框，直接创建hidden术语即可。

2. 添加搜索结果过滤钩子 #

接下来用pre_get_posts钩子，在搜索查询执行前，自动排除带有hidden术语的内容：

// 过滤搜索结果，隐藏标记为hidden的自定义文章类型内容
function exclude_hidden_posts_from_search($query) {
    // 只针对前台的主搜索查询生效，避免干扰后台操作
    if (!is_admin() && $query->is_search && $query->is_main_query()) {
        // 获取hidden术语的ID
        $hidden_term = get_term_by('slug', 'hidden', 'post_visibility');
        if ($hidden_term && !is_wp_error($hidden_term)) {
            // 构建tax_query排除该术语的内容
            $tax_query = $query->get('tax_query');
            $tax_query = is_array($tax_query) ? $tax_query : array();
            
            $tax_query[] = array(
                'taxonomy' => 'post_visibility',
                'field' => 'term_id',
                'terms' => $hidden_term->term_id,
                'operator' => 'NOT IN'
            );
            
            $query->set('tax_query', $tax_query);
            
            // 可选：如果只想让搜索结果包含你的自定义文章类型，添加下面这行
            // $query->set('post_type', 'custom_post_type');
        }
    }
    return $query;
}
add_action('pre_get_posts', 'exclude_hidden_posts_from_search');

代码说明： #

• pre_get_posts是WordPress修改查询逻辑的核心钩子，能在查询数据库前调整参数
• 我们限制只对前台搜索查询生效，避免后台编辑时看不到标记为hidden的内容
• 通过tax_query精准排除带有hidden术语的自定义文章类型内容

3. 扩展：在存档页也隐藏标记内容（可选） #

如果你希望自定义文章类型的存档页也隐藏这些内容，可以修改上面的条件，把存档页也纳入过滤范围：

// 扩展：在搜索结果和自定义文章类型存档页都隐藏hidden内容
function exclude_hidden_posts_from_queries($query) {
    if (!is_admin() && ($query->is_search || $query->is_post_type_archive('custom_post_type')) && $query->is_main_query()) {
        $hidden_term = get_term_by('slug', 'hidden', 'post_visibility');
        if ($hidden_term && !is_wp_error($hidden_term)) {
            $tax_query = $query->get('tax_query');
            $tax_query = is_array($tax_query) ? $tax_query : array();
            
            $tax_query[] = array(
                'taxonomy' => 'post_visibility',
                'field' => 'term_id',
                'terms' => $hidden_term->term_id,
                'operator' => 'NOT IN'
            );
            
            $query->set('tax_query', $tax_query);
        }
    }
    return $query;
}
add_action('pre_get_posts', 'exclude_hidden_posts_from_queries');

注意事项 #

• 替换代码中所有的custom_post_type为你实际的自定义文章类型slug
• 如果自定义分类法的slug不是post_visibility，也要对应替换
• 测试前记得清除WordPress缓存和浏览器缓存，避免旧查询结果干扰
• 如果使用了缓存插件，也要同步清除插件缓存

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