WordPress 分类函数 wp_list_categories 使用详解

　　今天正好要用到 WordPress 分类（Categories）显示函数，百度搜了半天没找到满意的使用说明，用 Google 一搜就搞定了。说明很详细，这里留个笔记。用到的主要函数：wp_list_categories。

　　wp_list_categories 标签负责的是存档的调用，在模板archives.php文件中添加 wp_list_categories 标签可以调用 WordPress 程序的存档。用法如下：

//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。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 值：整数 设置一个显示上限。

wp_list_categories　函数应用举例：

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的分类，并把列表标题改为Poetry
//（下面的格式是为了把“要显示的数据”和“标签参数区分开来”）
<?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' ); ?>