普通用法

<?PHP
	//用法1
	wp_list_categories();
 
	//用法2
	$CategoriesInfo = array();
	wp_list_categories($CategoriesInfo);
?>

参数说明：

一、和分类目录数量有关的参数
和分类目录数量有关的参数有三个，分别是 exclude、include、number。

exclude：
按照分类目录的 ID 排除分类目录。参数为1个或者多个数字，显示出来的分类目录中，如果某个或者某几个分类目录的 ID 和参数中指定的数字相等，则这些分类目录不会被显示出来。

用法

<?PHP
	//不显示Id为1的目录
	wp_list_categories('exclude=1');
 
	//不显示Id为3、4、5的分类目录
	wp_list_categories('exclude=3,4,5');
 
	//不显示Id为3、4、6的分类目录
	$CategoriesInfo = array('exclude' => '3,4,6');
	wp_list_categories($CategoriesInfo);
?>

include：
设置 include 为分类目录的 ID，则只显示经 include 指定的分类目录(不包括这个 ID 所指分类目录的下级目录)。include 的优先级大于 exclude，当参数设置为include=1&exclude=1的时候(看起来这种设置很无厘头)，则 ID 为1的分类目录被显示出来。

用法

<?PHP
	//只显示id为1的分类目录
	wp_list_categories('include=1');
 
	//只显示id为2,3的分类目录
	wp_list_categories('include=2,3');
 
	//只显示Id为3、4、6的分类目录
	$CategoriesInfo	= array('include' => '3,4,6');
	wp_list_categories($CategoriesInfo);
?>

number
所显示的分类目录的数量。为数字。默认没有限制。number 的优先级大于 include，当 include 中设置的应显示出来的分类目录的数量大于 number 中设置的值时，以 number 设置的值为准。

用法：

<?PHP
	//只显示出来3个分类目录
	wp_list_categories('number=3');
 
	//只显示出来id为1、2、3的分类目录
	//(尽管include希望显示出来7个分类目录，但number的优先级大于include)
	wp_list_categories('include=1,2,3,4,5,6,7&number=3');
 
	//只显示出来id为1、2、3、4的分类目录
	//(尽管include希望显示出来7个分类目录，但number的优先级大于include)
	$CategoriesInfo = array( 'include' => '1,2,3,4,5,6,7',
				 'number' =>  '4');
	wp_list_categories($CategoriesInfo);
?>

二、和分类目录排序有关的参数
和分类目录排序有关的参数有两个，orderby 和 order

orderby：
所列出来的分类目录排序的依据。参数可以是‘ID’、‘name’或‘count’，分别是按照分类目录的 ID、名称和文章数量来排序。其默认值是‘ID’。

order：
所列出来分类目录排序的方式，升序还是降序，参数可以是‘ASC’或‘DESC’，默认值是‘ASC’升序。

用法

<?PHP
	//按照ID的降序排列
	wp_list_categories('orderby=ID&order=DESC');
 
	//按照ID的升序排列
	wp_list_categories('orderby=ID&order=ASC');
 
	//按照分类目录名称的升序排列
	wp_list_categories('orderby=name&order=ASC');
 
	//按照文章数量的降序排列
	$CategoriesInfo = array( 'orderby' => 'count',
				 'order' =>  'DESC');
	wp_list_categories($CategoriesInfo);
?>

三、和 feed 有关的参数
和 feed 有关的参数有两个， feed 和 feed_image

feed：
是否显示分类目录的 rss 链接。为字符串，feed所指定的字符串为链接的文字，默认不显示。

feed_image：
为 rss 链接设置一个图标。为字符串，一般情况下是一个图片文件的相对或绝对地址。默认不显示。

用法

<?PHP
	//显示 rss 链接
	wp_list_categories('feed=RSS');
 
	//显示 rss 链接，并有小图标显示
	wp_list_categories('feed=RSS&feed_image=/wp-content/themes/default/images/rss.jpg');
 
	//显示 rss 链接，并有小图标显示
	$CategoriesInfo = array	( 'feed' => 'RSS',
				  'feed_image' => '/wp-content/themes/default/images/rss.jpg');
	wp_list_categories($CategoriesInfo);
?>

四、和显示样式（方式）有关的参数

style：
分类目录是以列表的方式显示出来，还是以没有任何样式的方式显示出来。参数为list或者none，默认是list，是以ui、li列表方式显示出来，如果设置为none，则没有任何样式，分类列表之间以“
”分割。

用法

<?PHP
	//以列表的方式显示
	wp_list_categories('style=list');
 
	//以“<br />”分割
	wp_list_categories('style=none');
?>

depth：
参数为数字，可以是1、2、3、…n，或者是0和-1，默认值为0。当depth为正整数的时候，可以控制显示几层分类，例如depth为1，则只显示一层分类，如depth为2，则显示一层分类及这层分类之下的子分类。如果设置depth为-1时，不同级别的分类目录是在一个ul之中的同级别的li，当depth为0时，不同级别的分类是嵌套在不同ul之间的li。

用法

<?PHP
	//不同级别的分类目录在同一个ul之中同一级别的li之中显示
	wp_list_categories('depth=-1');
 
	//不同级别的分类目录在不同的ul之中同一级别的li之中显示
	wp_list_categories('depth=0');
 
	//显示两个级别的分类目录
	wp_list_categories('depth=2');
?>

hierarchical：
数字，1或者0，默认为1，为1的时候，不同级别的分类目录现在在互相嵌套的ul和li中，为0的时候，不同级别的分类目录显示在同一级别的ul和li中。hierarchical和depth有点相似，两者一起使用并且矛盾的话，分类目录总是显示在同级的ul之下。

用法

<?PHP
	//不同级别的分类目录出现在互相嵌套的ul和li中
	wp_list_categories('hierarchical=1');
 
	//不同级别的分类目录出现在同一级别的ul和li中
	$CategoriesInfo = array( 'hierarchical' => 0 );
	wp_list_categories($CategoriesInfo);
?>

show_count
是否显示出来分类目录中所包含的文章数量，参数为1或者0，默认为0，不显示文章数量，如果设置为1，则显示出来文章数量。

用法

<?PHP
	//显示出来文章数量
	wp_list_categories('show_count=1');
 
	//不显示出来文章数量
	wp_list_categories('show_count=0');
?>

show_option_all：
在wp_list_categories中使用show_option_all参数的话，在所有分类目录之前，将产生一个到博客首页的链接，链接的文字就是show_option_all所指定的值。
//用法
wp_list_categories('show_option_all=首页');
?>

五、和标题有关的参数

title_li
在分类目录之前显示标题。默认值为po文件中Categories所对应的译文，官方中文版po文件中Categories的译文是“分类目录”，也可以设置为其他的值。当style设置为none的时候，title_li不起作用。

<?PHP
	//显示“栏目”
	wp_list_categories('title_li=栏目');
 
	//显示po文件中Categories所对应的译文
	$CategoriesInfo = array( 'title_li'=> __('Categories'));
	wp_list_categories($CategoriesInfo);
?>

六、其他参数

child_of：
参数为数字，功能为显示指定父分类 ID 下的子分类，无默认值。假设某个分类的id为6，将child_of设置为6时，则只显示这个分类下的子分类。

用法

<?PHP
	//显示ID为6的分类目录的下一级分类目录
	wp_list_categories(child_of=6);
 
	//显示ID为1的分类目录的下一级分类目录
	$CategoriesInfo = array('child_of' => 1);
	wp_list_categories($CategoriesInfo);
?>

echo：
参数为数字，1或者0，默认是1。如果是1的话，wp_list_categories函数将分类目录正常显示出来。如果是0的话，使用wp_list_categories函数的结果会产生一个变量，显示这个变量的时候才显示出来分类目录。

用法

<?PHP
	//如果将echo设置为0，需要增加echo以便显示出来分类目录
	$temp = wp_list_categories('echo=0');
	echo $temp;
 
	//如果将echo设置为1，则直接可以显示出来分类目录
	wp_list_categories('echo=1');
 
	//其实echo的默认值就是1，所以可以直接用如下的写法
	wp_list_categories();
?>

hide_empty：
数字，1或者0，默认为1。控制是否显示还没有文章的分类目录。默认为1，不显示没有文章的分类目录，当设置为0的时候，显示没有文章的分类目录。

<?PHP
	//显示所有分类目录链接(不管这些分类目录是否包含文章)
	wp_list_categories('hide_empty=0');
 
	//只显示包含有文章的分类目录链接
	wp_list_categories('hide_empty=1');
?>

use_desc_for_title
分类目录的描述信息，是否加入到分类目录链接的 title 标签中。可以设置为1或者0，1为默认值，加入title标签，内容为分类目录的描述信息，0为不加入。

<?PHP
	//加入title标签
	wp_list_categories('use_desc_for_title=1');
 
	//不加入title信息
	wp_list_categories('use_desc_for_title=0');
?>

七、有疑问的参数

show_last_update
官方的文档中说这个参数是显示分类中日志的最新时间戳，可以是1或者0。但是我没有试验出来这个参数的效果。并且发现官方文档中也有一些BUG。官方文档的示例中写的是：

    'show_last_update'   => 0,

但同一页面的下边解释这个参数的时候，却是：
show_last_updated
(boolean) Should the last updated timestamp for posts be displayed (TRUE) or not (FALSE). Defaults to FALSE.

* 1 (True)
* 0 (False) – Default

能够看到，show_last_update变成了show_last_updated，不过这两个我都没有试出来效果。有知道的朋友可以给我留言，谢谢。

2009年11月13日，WordPress发布了2.8.6英文版。中文版暂时没有发布。WordPress用户也可以通过自动升级的功能将现有版本升级为2.8.6。

更改css文件：
编辑wp-content\themes\default目录下的style.css文件，修改如下几个地方，

42
43
44
45
46

#headerimg 	{
	margin: 7px 9px 0;
	height: 192px;
	width: 740px;
	}

将 #headerimg中的width由740px改为940px；

237
238
239
240
241
242
243
244
245
246
247
248
249
250
251

#page {
	background-color: white;
	margin: 20px auto;
	padding: 0;
	width: 760px;
	border: 1px solid #959596;
	}
 
#header {
	background-color: #73a0c5;
	margin: 0 0 0 1px;
	padding: 0;
	height: 200px;
	width: 758px;
	}

将#page中width由760px改为960px，将#header中width由758px改为958px；

259
260
261
262
263
264
265
266
267
268
269
270

.narrowcolumn {
	float: left;
	padding: 0 0 20px 45px;
	margin: 0px 0 0;
	width: 450px;
	}
 
.widecolumn {
	padding: 10px 0 20px 0;
	margin: 5px 0 0 150px;
	width: 450px;
	}

将 .narrowcolumn和.widecolumn中的width由450px改为650px，这个操作直接让文章内容区域变宽；

313
314
315
316
317
318

#footer {
	padding: 0;
	margin: 0 auto;
	width: 760px;
	clear: both;
	}

将 #footer中的width由760px改为960px，这是在操作页尾；

574
575
576
577
578
579

#sidebar
{
	padding: 20px 0 10px 0;
	margin-left: 545px;
	width: 190px;
	}

将#sidebar中的margin-left由545px改为745px，这一行是侧边栏距页面左边的距离，因为页面左边的宽度增加了200，所以这里也要增加200，否则侧边栏就会和内容区域离得很近。

更改图片：
编辑wp-content\themes\default\images目录下kubrickbg-ltr.jpg、kubrickbg-rtl.jpg、kubrickbgwide.jpg，kubrickfooter.jpg和kubrickheader.jpg文件，将其宽度由760改为960。

更改header-img.php：
有人认为wp-content\themes\default\images中header-img.php文件也要做出适当修改，我认为在没有改动过“外观”-“头部图像和颜色”设置的模板，是不用修改header-img.php文件的。

我将已经完成上述更改的css和图片文件打包放上来，有需要的朋友可以直接下载：
已经做好上述修改的css文件 (10KB)
已经做好上述修改的图片文件 (17KB)

3

<div id="content" class="widecolumn">

修改成

3

<div id="content" class="narrowcolumn">

之后在single.php文件的62和64行之间

62
63
64

	</div>
 
<?php get_footer(); ?>

增加一行，修改成：

62
63
64

	</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

将此文件上传到服务器。覆盖以前的文件。因为我启用了cos-html-cache插件，所以还要在插件的设置页面，删掉以前所有的缓存页面。然后回到首页，点开任何一个文章页，会发现文章页中已经出现了侧边栏。

这么做，其实还有另外一个目的，就是准备把默认模板的宽度从760px（适应800*600的分辨率）改成960px（适应1024*768的分辨率）。

ps：五天之后，我做了上述修改。

wordpress.org上有一些插件有这样的功能，就是可以把发表文章时候写的标签(tags)，自动转成keywords，出现在html页面中，同时把文章的标题，自动转成description，也出现在html页面中。经过搜索，找到了两个类似功能的插件。Tags 2 Meta Generator和Tags To Meta Keywords。后者我使用了一年多，插件稳定可靠，小巧简单。不过插件作者在2007年10月26日发布了Tags To Meta Keywords 0.31之后，就再也没有更新过了，当时WordPress的版本是2.3。 相比之下Tags 2 Meta Generator的最后一个版本0.1的发布时间2008年10月27日，不过值得一提的是，Tags 2 Meta Generator的最后版本，明确表示，支持的WordPress的版本是2.6.3。

所以，我决定使用Tags 2 Meta Generator。安装和启用的过程很简单，且没有需要设置的地方。之后，发表测试文章，果然，查看源文件之后，出现了keywords和description，并且正是取自于标签和文章标题。

感谢Tags 2 Meta Generator的作者制作出如此优秀之插件供人们使用。

到现在为止，明泉已经安装并使用了如下的插件:历史文章归档，页面静态化，标题翻译成英文和禁用自动保存，WordPress的最佳翻页插件。你的博客都安装了哪些插件呢？

WP-PageNavi能够显示出来总共有多少页以及访客当前在第几页，当然也包括“上一页”和“下一页”，还有从1开始的，可以自定义数量的，到某个页面的链接。以上提及的这些文字，在插件的设置页面中都可以进行设置，也可以自定义css。据明泉观察，相当多的WordPress站点使用了这个插件。WP-PageNavi的作者Lester ‘GaMerZ’ Chan也很勤奋，最后一次更新这个插件是2008年12月12日。

在Wp-PageNavi的设置页面，可以看到如下的变量：%CURRENT_PAGE%：当前页。如果在首页，这个数字会显示为1，如果向后翻了一页，这个数字就变成2。%TOTAL_PAGES%： 总共有多少个页面。这两个变量可以设置在“Text For Number Of Pages”里边，如果是中文的博客，写成“第 %CURRENT_PAGE% 页 总 %TOTAL_PAGES% 页”是个不错的选择。WP-PageNavi还有很多的设置，用文字叙述不如用图片说明，俗称，有图有真相。注意一下翻页功能的上下两条虚线，很插件本身没有关系，是其他的css造成的。(点小图看大图)

设置WP-PageNavi

设置完成之后还不够，还需要把一段代码插入到希望显示出来翻页功能的位置，

1

<?php if(function_exists('wp_pagenavi')) { wp_pagenavi(); } ?>

这样才算大功告成。

感谢插件作者Lester ‘GaMerZ’ Chan写出如此之好的插件供我们使用。

反对者想出了一些办法来试图屏蔽掉自动保存的功能，例如，直接修改源代码，注释掉包含”autosave”的行，这样做有几点不好的地方，一是如果WordPress升级，这样做的效果就消失了，二是，在编辑文章的时候，浏览器左下角会报一个javascripts的错误。所以我没有使用这种方法，而是用了一个插件，Disable autosave。在安装并启用这个插件之后，插件就可以直接禁用掉WordPress的自动保存功能。

如果你也像我一样不喜欢WordPress的自动保存功能，也赶紧用一下Disable autosave吧！

使用插件的前提条件是WordPress的固定链接设置是“自定义结构”，并且设置成必须要包含“%postname%”。之后安装并启用插件。则以后发文章的时候，插件会调用Google 翻译，把中文的标题翻译成英文，并用“-”隔开每个单词，这样的好处是有利于SEO。

感谢插件的作者写出这么优秀的插件供别人使用。

其实在去年，我已经知道并开始使用cos-html-cache，这个插件安装和配置的难度会大于Clean Archives Reloaded，最大的问题是，所有操作都按照插件作者在文档中描述的进行，每个步骤都是正确的，但得不到正确的结果，就是无法生成静态页面。碰到这种情况，恐怕只能换其他类似的插件了。我曾经有一个Blog百般测试之后，还无法使用cos-html-cache，无奈只能换成了另外一个类似功能的插件：WP-Super-Cache。

在国外的一些虚拟主机上，PHP中的函数$_SERVER取得的值，比较神秘，这种情况下，cos-html-cache生成的静态页面，不会保存在你指定的目录下，有可能会保存在空间的根目录下。插件作者对于这种情况给出了一个解决方案。修改cos-html-cache.php文件 将$path = $_SERVER['DOCUMENT_ROOT'].”/”;替换为$path = ABSPATH ; 如果目录依然错乱，继续修改 $path = ABSPATH.”/youblogdir”,直到正常为止。我和我的朋友都碰到过这个问题，修改之后得以解决。

页面静态化以后，对服务器和数据库的压力将会减少。相对于从数据库中读出并显示出来，浏览者会感觉到页面完全加载的时间很变短，同时服务器资源超标的可能性也会降低。很感谢作者能写出如此优秀的WordPress插件。

使用插件之后的具体效果，可以参见 http://liumingquan.net/archive

感谢插件的作者，写出这么优秀的插件供别人使用。