钩子文档

list_terms_exclusions

💡 云策文档标注

概述

list_terms_exclusions 是一个 WordPress 过滤器钩子,用于在查询术语时排除特定术语。它允许开发者自定义查询中的 NOT IN 子句。

关键要点

  • 过滤器名称:list_terms_exclusions
  • 主要功能:过滤术语查询中要排除的术语,通过修改 $exclusions 参数实现
  • 参数:$exclusions(字符串,表示 NOT IN 子句)、$args(数组,查询参数)、$taxonomies(字符串数组,分类法名称)
  • 用法:在 WP_Term_Query::get_terms() 中调用,用于检索查询结果
  • 引入版本:WordPress 2.3.0

📄 原文内容

Filters the terms to exclude from the terms query.

Parameters

$exclusionsstring
NOT IN clause of the terms query.
$argsarray
An array of terms query arguments.
$taxonomiesstring[]
An array of taxonomy names.

Source

$exclusions = apply_filters( 'list_terms_exclusions', $exclusions, $args, $taxonomies );

Changelog

Version Description
2.3.0 Introduced.