WordPress函数:wp_list_categories(分类列表)实例及原理

原型:wp_list_categories( string|array $args = ” )

1、默认处境下,该函数生成无系列表,你应有运用<ul></ul>对其转移的内容开展打包。
2、wp_list_categories()和list_cats()以及wp_list_cats()的应用类似,可是后边2 个已经弃用。
3、假若你希望将这些结果作为变量的话,可以将”echo”=>0,然后按变量举行操作。
4、也可以使用get_categories(),来赢得分类变量。
5、此函数的参数,接收字符串或数组,具体请见下边实例。
6、以下例子测试环境Wordpress4.8

<?php
    $args = array(
            "title_li"=>'<h2>' . __( '金三国', 'textdomain' ) . '</h2>',
            "show_option_all"=>'首页',
            "orderby"=>'ID',
            "style"=>'list',
            "show_count"=>1,
            "hide_empty"=>0,
            "use_desc_for_title"=>1,
            "child_of"=>0,
            "exclude"=>1,
            "hierarchical"=>1,
            "echo"=>1,
            "current_category"=>1,
            "hide_title_if_empty"=>1,
            "taxonomy"=>'category'
        );

    wp_list_categories($args);
?>

  

不要被这些参数吓到,其实它很简单,你只需了解英文的大概意思即可,我们来看实例。

实例一、按字母顺序排序分类,只包括类别ID为2,4,7,9 的分类,你可以使用下面的代码:

  

<?php
wp_list_categories('orderby=name&include=2,4,7,9');
?>

  实例二、按照名称排列,显示随笔数,并且消除ID为7的归类:

<?php
wp_list_categories('orderby=name&show_count=1&exclude=7');
?>

  实例三、 展现分类名称,呈现分类所属的篇章多少

<?php
wp_list_categories('show_count=1&title_li=category');
?>

  实例四、显示分类下的子分类,包括著作多少,同时显示空的子分类

<?php
wp_list_categories('child_of=5&title_li=&show_count=1&hide_empty=0');
?>

  实例五、你可以指定分类目录的标题及体制

<?php
wp_list_categories('title_li=<h2>' . __( '金三国', 'textdomain' ) . '</h2>');
?>

  实例六、假若你不打算利用无体系表形式的归类,可以参照超链与换行情势的。

<?php
wp_list_categories('style=0');
?>

  实例七、遵照分类名称举行排序,显示小说数量,并且出示每个分类的 RSS
订阅链接

<?php
wp_list_categories('orderby=ID&show_count=1&feed=RSS'); //现在很不常用了
?>

  实例八、在分拣彰显的超链接中,使用title属性,利于SEO

<?php
wp_list_categories('use_desc_for_title=1');
?>

  接下来我们来大概的看下它的参数解释,不必顾虑,该函数你只需要精通它的存在及简单利用即可,因为有点用了。

参数 用途 参数值
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”。 传递空字符串禁用
echo 显示结果或保存在一个变量里 1,0
depth 显示分类的深度(即显示多少层的子分类) 0 – 所有分类和子分类(默认)
-1 – 所有类别显示在平面(不缩进)的形式(覆盖hierarchical)。
1 – 只显示顶级分类
n – 任意大于1的值,根据n的具体数字来显示对应等级的分类。
current_category 默认为0,在当前分类下加样式值,便于美化 为0则根据页面动图添加当前样式值,填指定分类id,则仅在指定分类中添加样式值
pad_counts 父分类的文章数是否包括子分类的链接或文章数。 1,0
taxonomy 给定分类法 默认category

乘势Wordpress版本的更新,此函数的施用效用越来越低,你只需精通以上例子功用、使用的环境,即可,比如,你相逢需要调阅分类的时候,能想起这多少个函数就可以了。