get_categories()函数 获得分类所有信息 返回数组

admin

get_categories()函数可以获得分类所有信息，返回与查询参数相匹配的类别对象数组。变量与wp_list_categories()函数基本一致，且变量可被作为数组传递，也可在查询句法中被传递。

语法结构

1. <?php $categories = get_categories( $args ); ?>
   
2. 
   
3. <?php
   
4. $args = array(
   
5.     'type'  => 'post',
   
6.     'child_of' => 0,
   
7.     'parent'  => '',
   
8.     'orderby'  => 'name',
   
9.     'order' => 'ASC',
   
10.     'hide_empty'  => 1,
    
11.     'hierarchical' => 1,
    
12.     'exclude' => '',
    
13.     'include' => '',
    
14.     'number'  => '',
    
15.     'taxonomy' => 'category',
    
16.     'pad_counts'  => false );
    
17. ?>

复制代码

参数

type（字符） post
child_of（整数）仅显示标注了编号的分类的子类。该参数无默认值。使用该参数时应将hide_empty参数设为false
parent（整数）只显示某个父级分类以及下面的子分类(注：子分类只显示一个层级)。
orderby（字符）将分类按字母顺序或独有分类编号进行排序。默认为按分类 编号排序包括ID(默认)和Name
order（字符）为类别排序（升序或降序）。默认升序。可能的值包括asc(默认)和desc
hide_empty（布尔值）触发显示没有文章的分类。默认值为true（隐藏空类别）。有效的值包括:1(true)和0(false)。
hierarchical（布尔值）将子类作为内部列表项目(父列表项下)的层级关系。默认为true（显示父列表项下的子类）。有效值包括1 (true)和0(false)
exclude（字符）除去分类列表中一个或多个分类，多个可以用逗号分开，用分类ID号表示。
include（字符）只包含指定分类ID编号的分类。多个可以用逗号分开，用分类ID号表示。
pad_counts(布尔值)通过子类中的项来计算链接或文章。有效值包括1(true)和0(false)，0为默认。
number（字符）将要返回的类别数量。
taxonomy（字符）)返回一个分类法，这个是wordpress3.0版本后新添加的一个参数。返回的值包括category(默认)和taxonomy(一些新定义的分类名称)。

实例

不使用wordpress默认的wp_list_categories()分类列表来实现分类列表，而使用get_categories自定义分类列表，而且还能在分类列表中加上图标。

1. <?php
   
2. $args=array(
   
3.     'orderby' => 'name',
   
4.     'order' => 'aSC'
   
5. );
   
6. $categories = get_categories($args);
   
7. foreach($categories as $category) {
   
8.     echo ' <li class="cat-'. $category-> slug .'">';
   
9.     echo ' <a href="' . get_category_link( $category->term_id ) . '" title="' . sprintf( __( "View all posts in %s" ), $category->name ) . '" ' . '>' . $category->name.' </a>';
   
10.     echo ' </li>';
    
11. }
    
12. ?>

复制代码

输出html代码：

1. <li class="cat-photo"><a href="#">Photo</a></li>
   
2. <li class="cat-design"><a href="#">Design</a></li>

复制代码