wp_list_categories 标签的用法与详细参数

注意，本文中所有“列表”指的是blog中所有分类名称的列表，而这个标签的作用正应用于此。

作用：（我英文实在很菜，可能翻译不准确。）
1. 不是连接到某个分类的
2. 排列分类
3. 不显示上一次更新(上次更新后,在当前类内)
4. 可以无序排列
5. 可以显示日志数量
6. 可以只显示制定某个分类
7. 可以指定分类说明or标题
8. 可设置无Feed或Feed使用图标
9. 没有任何exlude类,并包括所有类别? ('include' => is not shown above)
10. 缩进?等级?排列样式
11. 分类标题名单?
12. 没有限制的sql施加? ('number' => 0 is not shown above)

不管这些了，先举几个例子你就明白了：

1.包含或排除某分类：
意思就是把分类ID为3，5，9，16的分类按名称顺序来排序：

< ?php wp_list_categories('orderby=name&include=3,5,9,16'); ?>


按名称排列，并显示每个分类的日志总数，并不显示ID为10的分类：

< ?php wp_list_categories('orderby=name&show_count=1&exclude=10'); ?>


2.显示或隐藏列表标题：

过滤ID为4和7的分类，并且列表标题设置为“哈哈”：
< ?php wp_list_categories('exclude=4,7&title_li=哈哈'); ?>

列表中只显示ID为5、9、23的分类，并把列表标题改为<h2>Poetry</h2>（下面的格式是为了把“要显示的数据”和“标签参数区分开来”）
< ?php wp_list_categories('include=5,9,23&title_li=<h2>' . __('Poetry') . '</h2>' ); ?>

3.那啥
这个参数的意思是：按ID排序，关闭分类说明（就是鼠标移动到连接上就不显示你在后台填的分类说明了，只显示“察看XX分类下的所有文章”），并且只显示ID为8的分类下的子分类，如果没有，则参数无效，会按默认来显示。
< ?php wp_list_categories('orderby=id&show_count=1&use_desc_for_title=0&child_of=8'); ?>

4.外观是分类后面显示个（RSS），作用就不用我说了吧？
< ?php wp_list_categories('orderby=name&show_count=1&feed=RSS'); ?>

5.这个比较酷，相信大家都喜欢：
分类名称后面显示一个自己制定的小图标，作用是RSS。
< ?php wp_list_categories('orderby=name&show_count=1&feed_image=/images/rss.gif'); ?>

6.花式列表：
改变当前正在浏览的分类名字的样式。'style=list'的作用是给输出的html代码

中加一个class="current-cat"， 然后你在CSS里添一个.current-cat {color:red;}那么我浏览分类AAA时，列表中的“AAA”3个字就是红色的，浏览BBB，“BBB”就是红色的。
< ?php wp_list_categories('style=list' ); ?>

下面把所有参数和值汇总一下：

show_option_all
值：任意填。
如果你写< ?php wp_list_categories('show_option_all=那啥'); ?>，那么在列表第一个分类就显示“那啥”两字，不过连接是连接到blog首页的，正好可以利用此参数加个“首页”。

orderby
值：ID、name（默认值）、count。
作用是按这3个值来排序。

order
值：ASC（默认值）、DESC。
ASC为升序，DESC为降序。

show_last_updated
值：0（默认值）、1。
0无作用，1为最近更新的分类显示在前面。

style
值：list（默认值）、none。
例6中已经举例了。none无作用。

show_count
值：0、1（默认值）
1在每个分类后面显示日志数量，0不显示。

hide_empty
值：0、1（默认值）
1是隐藏没有发表日志的分类，0是显示所有。

use_desc_for_title
值：0、1（默认值）
0为关闭说明，1为显示说明。上面有例子。

child_of
值：数字
显示指定ID（也就是所填的这个数字）下的子分类。

feed
值：任意
假如你填“啊!”，那么在你每个分类后面都会出现“(啊!)”，连接地址是RSS地址。

feed_image
值：任意。虽然任意，但是是个图片的地址才对。
用来在分类后面显示个RSS Feed图标，上面有例子。

exclude
值：任意。但是要填分类名称或者分类ID才有效。
用来过滤（或者说隐藏）某个分类在列表中的出现。

include
值：任意。但是要填分类名称或者分类ID才有效。
作用是只显示所填的这个分类名或ID。

hierarchical
值：0、1（默认值）
说是按分类文章数目排列的，但测试无效果。

title_li
值：任意
用来改变列表标题的。

number
值：整数
设置一个显示上限。

本节完。