get_categories_taxonomy
云策文档标注
概述
get_categories_taxonomy 是一个 WordPress 过滤器钩子,用于在调用 get_categories() 函数时修改检索分类术语所使用的分类法。它允许开发者动态调整分类法参数,增强查询的灵活性。
关键要点
- 过滤器名称:get_categories_taxonomy
- 主要用途:过滤 get_categories() 中用于检索术语的分类法
- 参数:$taxonomy(字符串,要检索术语的分类法)和 $args(数组,传递给 get_terms() 的参数)
- 返回值:修改后的分类法字符串
- 引入版本:WordPress 2.7.0
- 相关函数:get_categories() 和 get_terms()
代码示例
$args['taxonomy'] = apply_filters( 'get_categories_taxonomy', $args['taxonomy'], $args );注意事项
参数 $args 可以包含传递给 get_terms() 的更多参数,具体可参考 WP_Term_Query::__construct() 的文档。使用此过滤器时,需确保返回有效的分类法字符串,以避免查询错误。
原文内容
Filters the taxonomy used to retrieve terms when calling get_categories() .
Parameters
$taxonomystring-
Taxonomy to retrieve terms from.
$argsarray-
An array of arguments. See get_terms() .
More Arguments from get_terms( … $args )
Array or string of arguments. See WP_Term_Query::__construct() for information on accepted arguments.
Source
$args['taxonomy'] = apply_filters( 'get_categories_taxonomy', $args['taxonomy'], $args );
Changelog
| Version | Description |
|---|---|
| 2.7.0 | Introduced. |