wp_list_categories函数用法小结

调用方法： < ?php wp_list_categories(‘参数1=值&参数2=值&参数3=值’); ?> 参数可以任意个数。下面把所有参数和值汇总一下：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
值：整数
设置一个显示上限。

调用举例：

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