通过函数 get_categories() 就可以输出 WordPress 获取所有分类列表,大致写法:
- <?php $categories = get_categories( $args ); ?>
$args 参数及默认值:
- <?php
- $args = array(
- 'type' => 'post',
- 'child_of' => 0,
- 'parent' => ''* v J O C [ n I,
- 'orderby' => 'name': 3 ^ \ \ ] J R,
- 'orde/ _ [ { . { % s mr' =&3 V v U D Ogt; 'ASC',
- 'hide_empty' => 1,
- 'hierarchical' => 1,
- 'exclude' => '',
- 'include' => '',
- 'numX f tber' => '',
- 'taxonomy' => 'ca. @ S H + S 4 /tegory',
- 'pad_counts' => fals / q : y S ; ; Ose
- );
- ?>
参数说明! 1 ? ]:
type
(字符)J O X L D 1post 和 link 其中 link 在新版 3.0 以后已被弃用。
child_of
(整数)仅显示标注了编号的分类的子类。该参数无默认值。使用该参数时应将 hide_empty 参数设为 false
parent
(整数)只显示某个D V Z )父级分类以及下面的子分类(注$ _ C 0 ^ u !:子分类只显示一个层级)。
orderby
(V ] 1 g字符)将分类按字母顺序或独有分类编号进行排序。默认为按分类 编号排序包括 ID(默认)和 Name
order
(字符)为类别排序4 , M(升序或降序)。默认升序。可能的值包括 asc(默认)和 desc
hide_eq F ! H g pmpty
(布尔值)触发显示没有文章的分类。默认值为 true(隐藏空类别)。有效的值包括:1(true)和 0(false)
hierarchical
(布尔值)
将子类作为内部列表项目(父列表项下)的层级关系。默z ^ y &认为 true(显示父列p \ 1 ( / ?表项下的子类)。有效值包括 1 (true)和 0(false)
exclud, [ m & m $e
(字符)除去分类列表中一个或多个分类,多个可以用逗I \ ? R U } 0 )号分开,用分类 ID 号表示
includR ] i m - ae
(字符)只/ F a + 5 N c M =包含指定分类 ID 编号的分类。多个可以用逗号分开,用分L O \ 3 q H a h类 ID 号表示
number
(字符)将要返回的类别数量
pad_counts
(布尔值)= X 4 }通过子类中的y p g 0项来计算链接或文章。有效值包括 1(true)和 0(false),0 为默认
taxonomy
(字符)返回一个分类法,这个# k H ^ ^ , @ Q ]是 wordpress3.0 版本后新添加的一个参数。返回的值包括 category(默认)和 taxonomy(一些新定义的分类名称)
示例:显示分类列表和分类描述以及包含的文章数目
- <?php
- $args=array(
- 'ordew \ o G O q U r Srby' => '% N ! z jname',
- 'order' => 'ASC'
- &4 R Z Z#41;;
- $categories=get_categories($args);
- foreach($categories asj n p D k K $category) {
- echoO / d '<p>Category: <a href="' . get_category_link( $cK P X xategory->term_id ) . '" title="' . sprintf( __( "View all posJ I h \ A B . i Nts in %s" ), $category->name )& j N ) a ( i; . '" ' . '>' . $ca= 7 D !tegory->name.'</a> </p> ';
- echo '<p> Descript1 8 (ion:'. $category->description . '&lS U Q & * {t;/p>';
- echo '&N | R x q N , ! Glt;p> Post Counf y P 6 ? m k C Tt: '. $category->count . '</p>';
- }
- ?>