WordPress基础：常用分类列表wp_list_categories

Posted 2020-09-12 tinyphp

函数：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>

输出html结构：

<ul>
            <li class="categories">分类目录<ul>    <li class="cat-item cat-item-2"><a href="#">使用手册</a>
<ul class="children">
    <li class="cat-item cat-item-6"><a href="#">使用应用</a>
</li>
    <li class="cat-item cat-item-3"><a href="#">如何安装</a>
</li>
    <li class="cat-item cat-item-7"><a href="#">常见问题</a>
</li>
    <li class="cat-item cat-item-4"><a href="#">界面介绍</a>
</li>
    <li class="cat-item cat-item-5"><a href="#">订购应用</a>
</li>
</ul>
</li>
    <li class="cat-item cat-item-8"><a href="#">开发手册</a>
</li>
    <li class="cat-item cat-item-1"><a href="#">未分类</a>
</li>
</ul></li>        </ul>

常见参数说明：

参数	用途	参数值
show_option_all	指定站点首页的超链接
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	只显示此参数确定的分类的子分类	为8 显示ID为 8 的分类的子分类 为0则显示分类的所有子类
exclude	排除一个或多个分类。使用逗号分隔每个分类的ID，参数 include 必须为空。	4,7
exclude_tree	排除分类树。使用逗号分隔每个分类的ID，参数 include 必须为空。
include	只显示特定的分类，使用逗号分隔每个分类的ID	3,5,9,16
hierarchical	是否按层级显示分类	1,0
title_li	设置列表的标题，默认为“Categories”。
number	要显示的分类数量	默认为不限制
echo	显示结果或保存在一个变量里	1,0
depth	显示分类的深度（即显示多少层的子分类）	0 – 所有分类和子分类（默认） -1 – 所有类别显示在平面（不缩进）的形式（覆盖hierarchical）。 1 – 只显示顶级分类 n – 任意大于1的值，根据n的具体数字来显示对应等级的分类。
current_category	默认为0，在当前分类下加样式值，便于美化	为0则根据页面动图添加当前样式值，填指定分类id，则仅在指定分类中添加样式值
pad_counts	父分类的文章数是否包括子分类的链接或文章数。	1,0

 

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