常用函数wp_list_categories()

Posted 2020-08-09 tinyphp

使用：

<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	只显示特定的分类，使用逗号分隔每个分类的ID	include=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 个已经弃用。