首页 > 代码库 > WordPress基础:常用分类列表wp_list_categories

WordPress基础:常用分类列表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>

输出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 只显示特定的分类,使用逗号分隔每个分类的ID3,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 个已经弃用。

WordPress基础:常用分类列表wp_list_categories