常用函数-get_terms()

常用函数-get_terms()

警告

这是一篇新发布文章，因此内容中可能出现问题。如果有疑惑可以在/wp-includes/taxonomy.php中查询相关信息。

说明

检索分类法或分类法列表中的term。

用法

get_terms($taxonomies, $args = )   

有效变量

传递变量按 wp_parse_args() 等函数所用的格式。

$myterms = get_terms("orderby=count&hide_empty=false");

未指定值的变量使用以下默认值（下文中有说明）。下面的列表中含有$args，将改写默认值。

• orderby — 默认值为'name'，可以是名称，计数或空（使用term_id）
• order — 默认值为ASC。有效值也包括DESC。
• hide_empty — 默认值为true。不返回空$terms。
• fields — 默认值为all。
• slug — 任何含有slug的term都可以作为该变量的值。默认为空字符串。
• hierarchical — 是否返回层级分类法。默认值为true。
• name_like — 默认值为空字符串。
• pad_counts — 默认值为FALSE。值为true时将计算包括$terms在内的所有子辈。
• get — 默认值为空。可通过为'all'赋值来改写'hide_empty'和'child_of'。
• child_of — 默认值为0。获取该term的所有后代。
• parent — 默认值为0。获取该term的直系子辈（即上辈明确为该值的term）。

详细介绍

在查询被送出前可自定义查询，也可用过滤器控制输出结果。

缓存具有该term，若要将已成立的term及$taxonomies、$args数组一同传递时，'get_terms'过滤器将被调用。

传递term数组前，若要将term数组和$taxonomies、$args一同传递，'get_terms'过滤器也将被调用。

'list_terms_exclusions'过滤器传递编译的Exclusion和$args。