WordPress基础:常用分类列表wp_list_categories

函数:wp_list_categories($args)

作用:列出某个分类下的分类项目

用法:

<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
title_li 列表的标题  

 

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

posted @ 2017-04-20 23:15  tinyphp  Views(2541)  Comments(0Edit  收藏  举报