首页    >    中文手册    >   常用函数-get_terms()

常用函数-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。

分类:中文手册

* 版权声明:作者WordPress啦! 转载请注明出处。