<?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 ) ); ?>