wordpress检索分类法函数：get_terms

wordpress检索分类法函数：get_terms

说明

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

用法

1. get_terms($taxonomies, $args = )

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

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

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

1. $args = array(
2. 'orderby' => 'name',
3. 'order' => 'ASC',
4. 'hide_empty' => true,
5. 'exclude' => array(),
6. 'exclude_tree' => array(),
7. 'include' => array(),
8. 'number' => ,
9. 'fields' => 'all',
10. 'slug' => ,
11. 'parent' => ,
12. 'hierarchical' => true,
13. 'child_of' => 0,
14. 'get' => ,
15. 'name__like' => ,
16. 'pad_counts' => false,
17. 'offset' => ,
18. 'search' => ,
19. 'cache_domain' => 'core'
20. );

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）。

应用

获取所有分类按‘count’排序

字符串参数格式

1. $categories = get_terms( 'category', 'orderby=count&hide_empty=0' );

数组参数格式:

1. $categories = get_terms( 'category', array(
2. 'orderby' => 'count',
3. 'hide_empty' => 0
4. ) );

获取所有友情链接的分类:

1. $mylinks_categories = get_terms('link_category', 'orderby=count&hide_empty=0');

列出所有不带链接的自定义分类：

1. $terms = get_terms("my_taxonomy");
2. $count = count($terms);
3. if ( $count > 0 ){
4. echo "<ul>";
5. foreach ( $terms as $term ) {
6. echo "<li>" . $term->name . "</li>";
7.  
8. }
9. echo "</ul>";
10. }

列出所有带上链接的自定义分类：

1. $args = array( 'taxonomy' => 'my_term' );
2.  
3. $terms = get_terms('my_term', $args);
4.  
5. $count = count($terms); $i=0;
6. if ($count > 0) {
7. $cape_list = '<p class="my_term-archive">';
8. foreach ($terms as $term) {
9. $i++;
10. $term_list .= '<a href="/term-base/' . $term->slug . '" title="' . sprintf(__('View all post filed under %s', 'my_localization_domain'), $term->name) . '">' . $term->name . '</a>';
11. if ($count != $i) $term_list .= ' &middot; '; else $term_list .= '</p>';
12. }
13. echo $term_list;
14. }

源代码

get_terms() 位于 wp-includes/taxonomy.php