钩子文档

wp_query_search_exclusion_prefix

💡 云策文档标注

概述

本文档介绍了 WordPress 中的 wp_query_search_exclusion_prefix 过滤器,用于控制搜索查询中排除术语的前缀。默认前缀为 '-',开发者可通过此过滤器自定义或禁用排除功能。

关键要点

  • wp_query_search_exclusion_prefix 过滤器允许修改指示搜索术语应从结果中排除的前缀。
  • 默认前缀是 '-',返回空值可以禁用排除功能。
  • 此过滤器在 WP_Query::parse_search() 方法中使用,用于生成 WHERE 子句的 SQL。
  • 从 WordPress 4.7.0 版本开始引入。

📄 原文内容

Filters the prefix that indicates that a search term should be excluded from results.

Parameters

$exclusion_prefixstring
The prefix. Default '-'. Returning an empty value disables exclusions.

Source

$exclusion_prefix = apply_filters( 'wp_query_search_exclusion_prefix', '-' );

Changelog

Version Description
4.7.0 Introduced.