首页 > 代码库 > 常用函数wp_list_categories()

常用函数wp_list_categories()

使用:

<ul>    <?php     $args= array(        ‘depth‘=>1,        ‘orderby‘=>id,        ‘style‘=>none        );    wp_list_categories( $args ); ?></ul>

<ul>            <?php wp_list_categories(‘depth=10‘); ?></ul>

常见参数说明:

参数用途参数值
show_option_all 以分类名称、分类ID或文章数量等为排列依据。有效值:ID、name – 默认、slug、count、term_group
order 升序或降序ASC升序(默认)、DESC降序
style分类列表显示的样式list 输出li, none 使用<br >标签分隔列表项
show_count 是否显示文章数量1,0
hide_empty是否隐藏没有文章的分类1,0
use_desc_for_title 是否将分类描述作为分类链接中的 title 属性1,0
child_of 只显示此参数确定的分类的子分类child_of=8 显示ID为 8 的分类的子分类
exclude 排除一个或多个分类。使用逗号分隔每个分类的ID,参数 include 必须为空。 exclude=4,7
exclude_tree 排除分类树。使用逗号分隔每个分类的ID,参数 include 必须为空。 
include 只显示特定的分类,使用逗号分隔每个分类的IDinclude=3,5,9,16
hierarchical以层级来显示分类的子分类1,0
title_li 设置列表的标题,默认为“Categories”。 
number设置显示的分类数量默认为不限制
echo显示结果或保存在一个变量里1,0
depth 显示分类的深度(即显示多少层的子分类)

0 – 所有分类和子分类(默认)
-1 – 所有类别显示在平面(不缩进)的形式(覆盖hierarchical)。
1 – 只显示顶级分类
n – 根据n的具体数字来显示对应等级的分类。

current_category 后跟分类ID号,对此ID分类加入名为current-cat的CSS控制,用户自定义current-cat样式后,可用于突出显示。 
pad_counts是否计算包括子分类的链接或文章数。1,0

 

注意: wp_list_categories() 和 list_cats() 以及 wp_list_cats() 的使用类似,但是后面 2 个已经弃用。

常用函数wp_list_categories()