常用函数-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。
分类:中文手册