在wordpress网站运营中，有时我们希望某些特定分类下的文章不出现在站内搜索结果中。例如，您可能有一些内部文章、特定产品档案或不希望被公开搜索到的内容。通过精确控制搜索结果，可以有效提升用户搜索体验，确保用户找到最相关的信息，同时也能更好地管理网站内容的可见性。
传统的排除方法，如手动列出文章ID或使用简单的-ID参数，往往不够灵活或存在局限性。本文将介绍一种更为健壮和推荐的方法，即利用WordPress的pre_get_posts动作钩子和tax_query参数来实现这一目标。
理解 pre_get_posts 钩子
pre_get_posts 是WordPress中最强大的查询修改钩子之一。它在WordPress执行任何查询（包括主查询、搜索查询、归档查询等）之前触发，允许开发者在查询执行前修改查询参数。这意味着我们可以在查询数据库之前，告诉WordPress我们希望如何筛选文章，例如排除特定分类。
使用 tax_query 排除分类
要从搜索结果中排除特定分类，我们需要在pre_get_posts钩子中设置一个tax_query参数。tax_query是一个强大的数组，用于构建复杂的分类法查询。
以下是实现此功能的完整代码示例，您需要将其添加到当前活动主题的functions.php文件中。强烈建议使用子主题来避免主题更新时代码被覆盖。
<?php
/**
* 从WordPress搜索结果中排除特定分类
*
* @param WP_Query $query WordPress查询对象
* @return WP_Query 修改后的WordPress查询对象
*/
function exclude_categories_from_search($query) {
// 确保只在搜索页面且非后台管理页面时执行此逻辑
// 并且只针对主查询进行操作，避免影响其他自定义查询
if ( $query->is_search && !is_admin() && $query->is_main_query() ) {
// 定义需要排除的分类ID数组
// 请将以下示例ID替换为您实际需要排除的分类ID
// 例如：array(19, 18, 214)
$term_ids_to_exclude = array( 21, 35, 42 ); // 示例分类ID
// 构建分类法查询数组
$taxquery = array(
array(
'taxonomy' => 'category', // 指定分类法，这里是WordPress的默认分类'category'
'field' => 'id', // 指定查询字段，这里是分类ID
'terms' => $term_ids_to_exclude, // 需要排除的分类ID数组
'operator' => 'NOT IN' // 操作符，'NOT IN'表示排除这些ID
)
);
// 将构建好的分类法查询参数设置到当前查询对象中
$query->set( 'tax_query', $taxquery );
}
return $query;
}
add_action( 'pre_get_posts', 'exclude_categories_from_search' );
?>代码解析
- function exclude_categories_from_search($query): 定义了一个名为exclude_categories_from_search的函数，它接收当前的WP_Query对象作为参数。
-
if ( $query->is_search && !is_admin() && $query->is_main_query() ): 这是一个关键的条件判断。
- $query->is_search: 确保只有在执行搜索查询时才应用此逻辑。
- !is_admin(): 避免影响WordPress后台的查询，例如后台搜索或文章列表。
- $query->is_main_query(): 确保只修改页面上的主查询，避免影响由插件或主题可能发起的其他自定义查询。
- $term_ids_to_exclude = array( 21, 35, 42 );: 在这里，您需要替换为实际要排除的分类ID。如何找到分类ID将在下一节中说明。
-
$taxquery = array(...): 这是核心的tax_query结构。
- 'taxonomy' => 'category': 指定我们要查询的分类法是WordPress的默认分类（category）。如果您想排除自定义分类法（例如product_cat），则需要相应更改。
- 'field' => 'id': 表示我们通过分类的ID来指定要排除的项。也可以是slug（别名）。
- 'terms' => $term_ids_to_exclude: 传入包含所有要排除分类ID的数组。
- 'operator' => 'NOT IN': 这是关键操作符。它告诉WordPress，查询结果中不应包含属于这些terms的任何文章。如果您想只显示某些分类的文章，可以将其改为IN。
- $query->set( 'tax_query', $taxquery );: 将构建好的tax_query数组设置到当前的WP_Query对象中，从而修改查询行为。
- add_action( 'pre_get_posts', 'exclude_categories_from_search' );: 将我们的函数挂载到pre_get_posts钩子上，确保在WordPress执行查询前调用它。
如何获取分类ID
要获取WordPress分类的ID，您可以按照以下步骤操作：
- 登录WordPress后台。
- 导航到“文章” -> “分类”。
- 将鼠标悬停在您想要获取ID的分类名称上，浏览器左下角会显示一个链接，其中包含tag_ID=的参数，后面的数字就是该分类的ID。
- 或者，点击进入该分类的编辑页面，在浏览器地址栏中，您会看到类似.../wp-admin/term.php?taxonomy=category&tag_ID=21&post_type=post的URL，tag_ID=后面的数字即为分类ID。
注意事项
- 使用子主题： 强烈建议将此代码添加到子主题的functions.php文件中。如果直接修改父主题，主题更新时您的更改将会丢失。
- 备份： 在修改functions.php文件之前，务必备份您的网站文件和数据库，以防出现意外问题。
- 清除缓存： 添加或修改代码后，如果您的网站使用了缓存插件（如WP Super Cache, W3 Total Cache, LiteSpeed Cache等），请务必清除所有缓存，以确保更改立即生效。
- 调试： 如果代码没有按预期工作，可以暂时移除!is_admin()条件并在后台测试，或者使用var_dump($query->query_vars);来检查$query对象是否被正确修改。
总结
通过利用pre_get_posts钩子和tax_query参数，您可以灵活且高效地控制WordPress搜索结果中分类文章的可见性。这种方法比手动排除文章ID或使用不稳定的set('cat', '-ID')更为强大和可维护，是优化WordPress搜索功能和提升用户体验的专业实践。
