钩子文档

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.