翻译自wordpress.org, 详细介绍wp_list_categories()的使用方法等。
1. 描述
作为超链接显示一列目录。当一个目录被点击的时候，所有在这个目录内的文章将被显示在一个使用目录模板的目录页面内。
注意：wp_list_categories()的工作原理，与两个在wordpress2.1中所代替的list_cats()和wp_list_cats()是相同的。
用法：
<?php wp_list_categories( $args ); ?>
默认使用方法：
<?php $args = 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_type' => ,
'feed_image' => ,
'exclude' => ,
'exclude_tree' => ,
'include' => ,
'hierarchical' => true,
'title_li' => __( 'Categories' ),
'number' => NULL,
'echo' => 1,
'depth' => 0,
'current_category' => 0,
'pad_counts' => 0,
'taxonomy' => 'category',
'walker' => 'Walker_Category' ); ?>
默认使用方法具体如下：
- 目录中没有超链接。
- 按照目录名的升序排列。
- 不显示最新的更新（在每个目录中的最新更新）
- 不显示文章的点击。
- 只显示有文章的目录。
- 把文章标题设为目录描述。
- 不限制子目录。
- 不适用feed或者feed image。
- 不排除任何目录，包括所有目录。
- 按照分层缩进的形式显示目录。
- 显示带CSS Class-fuffix”current-cat”有效目录。
- 作为标题显示目录。
- 无SQL限制No SQL LIMIT (‘number’ => 0 不显示）。
- 显示（可调取）目录。
- 不限制深度。
- 所有目录。
- 列表用于Walker_Category。
3. 参数
3.1 show_option_all :（字符）如果所有目录作为列表显示，则不为空的值将所有目录作为超链接，默认不作为超链接。
3.2 Orderby： 排列
- ID: 按照目录ID排序
- name: 默认按照目录名字排序。
- slug:
- count: 按照目录内文章数量排序
- term_group:
3.3 order 目录按照升序或者降序排列，默认是升序。 分别两个值：ASC 和 DESC.
3.4 show_last update: 是否显示最新跟新时间， 分别两个值： TRUE 和 FALSE，默认是FALSE.
3.5 style: 目录显示风格。两个值： list 是按照 列表显示； none 是特殊的显示方式（用<br>分开）；默认是list.
3.6 show_count: 是否显示每个目录文章的数量。1/0，默认是false,不显示。
3.7 hide_empty： 是否显示空目录，默认是true（隐藏空目录）， 1/0；
3.8 use_desc_for_title: 是否设置目录描述为超链接属性(i.e. <a title=”<em>Category Description</em>” href=”…)， 默认值是true，（目录描述被设置）； 1/0。
3.9 child_of： （整数）只显示定义的子目录层数。无默认值。
3.10 feed: （字符）显示目录rss-2的超链接，默认值是no textand no feed displayed.
3.11 feed_type: 字符
3.12 feed_image: （字符）设置一个URI到图片（通常为一个rss feed图标）。
3.13 exclude:（字符）从结果中排除一个或几个目录。用逗号分隔目录ID，按照升序排列；同时child_of参数自动设为false。
3.14 exclude_tree: 排除目录分支。 2.7.1版本增加的参数。
3.15 include：只包括某个目录，用逗号分隔目录ID，升序排列。
3.16 hierarchical: 显示二级目录的形式，是按照内缩还是不内缩； 默认参数是true（低于母目录形式显示）。1/0
3.17 title_li: 列表字体形式。
3.18 number
3.19 echo
3.20 depth 该参数控制显示多少级别的子目录。
- 0- 所有目录和子目录（默认）
- -1 所有目录都同意显示。
- 1 只显示最顶级目录。
- n 具体显示几级目录。
3.21 current_category： 2.6版本出现的参数。
3.22 pad_counts： 2.9版本出现的参数
3.23 taxonomy： 3.0版本参数。
3.24 walker
原文链接：http://codex.wordpress.org/Template_Tags/wp_list_categories
最后面的未能详细翻译，实在没有精力。转载请注明出处，原创请尊重。再次感谢。