wp_list_categories
<?php
/*
* wp_list_categories( $args )
* 作用：
* 列出某个分类方式下的分类项目(term)
* 默认是获取分类目录下的分类项目
*/
wp_list_categories( array(
/*
@成员参数：show_option_all
@参数作用：如果此参数的值不为空的话，则作为一个超链接的文本，而且该超链接指定的是站点的首页。
*/
'show_option_all' => '',
/*
@成员参数：orderby
@参数作用：列出分类目录项目时的排序方式
@可选的值：
ID 按照分类目录项目的编号排序
name 按照分类目录项目的名称排序 【默认】
slug 按照分类目录项目的别名排序
count 按照分类目录项目下的文章数量排序
term_group 按照分类目录项目的排序编号排序 【不常用】
*/
'orderby' => 'name',
/*
@成员参数：order
@参数作用：列出分类项目时按照哪种方式排序，升序？还是降序？
@可选的值：
ASC 升序 【默认】
DESC 降序
*/
'order' => 'ASC',
/*
@成员参数：style
@参数作用：分类项目的显示的格式
@可选的值：
list 用li元素包围分类目录项目，如<li>分类目录项目</li> 【默认】
none 不用li元素包围，分类目录项目之间用<br />隔开
*/
'style' => 'list',
/*
@成员参数：show_count
@参数作用：在显示分类目录项目时是否显示分类目录下的文章数量
@可选的值：
1 显示分类目录项目所包含的文章数量
0 不显示分类目录项目所包含的文章数量 【默认】
*/
'show_count' => 0,
/*
@成员参数：hide_empty
@参数作用：是否隐藏没有任何文章的分类项目
@可选的值：
1 隐藏 【默认】
0 不隐藏
*/
'hide_empty' => 1,
/*
@成员参数：use_desc_for_title
@参数作用：是否将分类项目的描述添加到分类项目的a元素的title属性中
@可选的值：
1 添加 【默认】
0 不添加
*/
'use_desc_for_title' => 1,
/*
@成员参数：child_of
@参数作用：仅显示某个分类项目所包含的子分类项目
@可选的值：父分类项目的ID编号 或者 0【显示所有分类项目】
*/
'child_of' => 0,
/*
@成员参数：feed
@参数作用：给每条分类项目添加一个超链接，指向对应的分类项目的feed地址。此参数设置的值为超链接的文本。
@可选的值：无限制
*/
'feed' => '',
/*
@成员参数：feed_type
@参数作用：设置feed的方式
@可选的值：rss2, atom, rdf
*/
'feed_type' => '',
/*
@成员参数：feed_image
@参数作用：替换feed参数中设置的文本为一个图片
*/
'feed_image' => '',
/*
@成员参数：exclude
@参数作用：在显示分类项目时排除某些分类项目（填写分类项目的ID）。排除多个分类项目时，要在两个分类项目的ID之间加上逗号（英文输入环境）。
@特别说明：如果想要这个参数正常发挥作用，成员参数include的值必须为空。
@可选的值：分类项目的ID编号
*/
'exclude' => '',
/*
@成员参数：exclude_tree
@参数作用：排除某个分类项目以及其下的子分类项目
@特别说明：如果想要这个参数正常发挥作用，成员参数include的值必须为空。而且成员参数hierarchical的值必须为0（即，不分层级显示子分类项目）
*/
'exclude_tree' => '',
/*
@成员参数：include
@参数作用：仅显示该参数指定的分类项目，多个分类项目的编号之间要用逗号隔开(英文输入环境)
*/
'include' => '',
/*
@成员参数：hierarchical
@参数作用：是否分层级显示分类项目？如果是的话，子分类项目用另外一个ul元素包围；如果否的话，子分类项目和父级分类项目在同一个层级显示
@可选的值：
1 以层级的方式显示分类项目 【默认】
0 不以层级的方式显示分类项目
*/
'hierarchical' => 1,
/*
@成员参数：title_li
@参数作用：此信息模块的标题，在至少存在一个分类项目时有效
*/
'title_li' => __( 'Categories' ),
/*
@成员参数：show_option_none
@参数作用：当没有任何分类项目时所要显示的内容
*/
'show_option_none' => __( 'No categories' ),
/*
@成员参数：number
@参数作用：要显示多少条分类项目？
@默认的值：null（即，无限制）
*/
'number' => null,
/*
@成员参数：echo
@参数作用：是否直接将获取到的分类项目显示出来。
@可选的值：
1 直接显示 【默认】
0 不显示，将结果返回
*/
'echo' => 1,
/*
@成员参数：depth
@参数作用：当按照层级显示分类项目时，要显示到哪个层级？
@特别提醒：当成员参数hierarchical的值取为0时（即，不按层级显示），则此参数无效
@可选的值：
0 显示所有层级 【默认】
-1 显示所有层级，但都以平级显示（和不分级的效果相同）。
1 仅显示顶级的分类项目，不显示子孙分类项目。
n 显示到n级，n代表大于1的数字。
*/
'depth' => 0,
/*
@成员参数：current_category
@参数作用：决定是自动给分类项目的包围元素(li元素)添加一个class属性值(current-cat)，还是指定添加。
@可选的值：
0 访问哪个分类归档页，就在对应的分类项目的包围元素(li元素)添加一个class属性值current-cat【默认】
n n代指的是一个数字，这个数字是分类项目的编号。例如n取值为1，代表的是在编号为1的分类项目的li元素中添加一个class属性值current-cat
*/
'current_category' => 0,
/*
@成员参数：pad_counts
@参数作用：在计算分类项目下的文章数量时，是否包含子分类项目下的文章信息
@可选的值：
1 包含
0 不包含
*/
'pad_counts' => 0,
/*
@成员参数：taxonomy
@参数作用：该参数的作用是设定显示哪个分类方式下的分类项目
@可选的值：
category 分类目录 【默认】
post_tag 标签
XXX 自定义的分类方式的名称
*/
'taxonomy' => 'category',
/*
@成员参数：walker
@特别说明：此成员参数是属于高级功能，不常用。而且理解起来比较困难，所以不讲解
*/
'walker' => null
) );
?>
相关文章
搜索文章：
联系方式：
近期文章