分类列表(wp_list_categories())函数用法详解

正如标题所说，Wordpress是用wp_list_categories这个函数来显示分类的，其用法是：< ?php wp_list_categories('arguments'); ?>。如： 优搜网

arguments即参数，默认参数设置为：

$defaults = array(
'show_option_all' => '', 不列出分类链接
'orderby' => 'name', 按照分类名排序
'order' => 'ASC', 升序排列
'show_last_update' => 0, 不显示分类中日志的最新时间戳
'style' => 'list',列表显示分类
'show_count' => 0, 不显示分类日志数量
'hide_empty' => 1, 不显示没有日志的分类
'use_desc_for_title' => 1, 显示分类描述
'child_of' => 0, 不限制子分类
'feed' => '', 不显示feed
'feed_image' => '', 不显示feed图片
'exclude' => '', 不显示该分类
'hierarchical' => true, 分层次显示父/子分类
'title_li' => __('Categories'), 用“Categories”为当前分类列表的标题
'echo' => 1, 显示(echos) 分类
'depth' => 0 不限制列表深度
);

用法举例：

1. 按照分类名排序，并只显示 ID 为1、2、3和4的分类：
   • < ?php
     wp_list_categories('orderby=name&include=1,2,3,4'); ?>
2. 按照分类名排序，并显示每个分类的日志数，但不显示 ID 为10的分类
   • < ?php
     wp_list_categories('orderby=name&show_count=1&exclude=10'); ?>
3. 显示或隐藏列表标题

   title_li 这个参数用于显示或者隐藏分类列表的标题，它的默认值为'(__('Categories')'，即显示分类列表的标题，如果不设置或设置为空，它将什么也不显示。下面的例子将不显示id为4和7的分类，并不显示list_categories列表的标题：
   

   • < ?php
     wp_list_categories('exclude=4,7&title_li='); ?>

   
   接下来的例子是仅仅只显示 ID为5、9和23的分类，并且列表标题显示为“Poetry”表：
   

   • < ?php
     wp_list_categories('include=5,9,23&title_li=' . __('Poetry') . '' ); ?>
4. 仅显示某个分类下的子分类

   下面的示例代码生成了 ID 为8的父分类下的子分类根据其 ID 进行排序的链接列表，它会显示每个分类下的文章数，并且隐藏链接的 title 标签中的分类描述，注意：如果父分类下没有任何文章，那么父分类将不会显示（读起来貌似很难理解，不过照着做就理解了）
   

   • < ?php wp_list_categories('orderby=id&show_count=1
     &use_desc_for_title=0&child_of=8'); ?>
5. 显示带有 RSS Feed 链接的分类列表

   面代码根据分类名对分类列表排序，并显示每个分类下的文章数和 RSS 的 Feed 链接：
   

   • < ?php
     wp_list_categories('orderby=name&show_count=1&feed=RSS'); ?>

   
   还可以使用 RSS 图标代替 RSS 链接
   

   • < ?php
     wp_list_categories('orderby=name&show_count=1
     &feed_image=/images/rss.gif'); ?>