详解WordPress中分类函数wp_list_categories的使用


Posted in PHP onJanuary 04, 2016

wp_list_categories 函数是 WordPress 中用来罗列系统中分类的函数,该函数拥有许多控制输出的参数,今天突然被一个朋友问到,所以就大概整理了一下。

因为 WordPress 中内置扩展的小工具功能,
所以我们不经任何函数就可以在边栏或是其他我们想要的位置显示一个分类列表,
所以wp_list_categories函数就很少有人用到,
该函数使用起来有点类似于wp_list_bookmarks,

wp_list_categories 描述
wp_list_categories 函数是 WordPress 中用来罗列系统中分类链接的函数。
英文原文就不上了,有兴趣的可以去看一下官方文档。

用法

<?php
 wp_list_categories( $args ); 
$args = array(
 'show_option_all'  => '',//是否列出分类链接
 'orderby'      => 'name',//按名称排列
 'order'       => 'ASC',//升、降序
 'style'       => 'list',//是否用列表(ul>li)
 'show_count'     => 0,//是否显示文章数量
 'hide_empty'     => 1,//是否显示无日志分类
 'use_desc_for_title' => 1,//是否显示分类描述
 'child_of'      => 0,//是否限制子分类
 'feed'        => '',//是否显示rss
 'feed_type'     => '',//rss类型
 'feed_image'     => '',//是否显示rss图片
 'exclude'      => '',//排除分类的ID,多个用',(英文逗号)'分隔
 'exclude_tree'    => '',//排除分类树,即父分类及其下的子分类
 'include'      => '',//包括的分类
 'hierarchical'    => true,//是否将子、父分类分级
 'title_li'      => __( 'Categories' ),//列表标题的名称
 'show_option_none'  => __('No categories'),//无分类时显示的标题
 'number'       => null,//显示分类的数量
 'echo'        => 1,//是否显示,显示或者返回字符串
 'depth'       => 0,//层级限制
 'current_category'  => 0,//添加一个没有的分类
 'pad_counts'     => 0,//这个我也不明白
 'taxonomy'      => 'category',//使用的分类法
 'walker'       => null//用于显示的类(很复杂的概念)
?>

关于'pad_counts',我也没搞明白这个参数是干什么用的,
如果有兴趣你可以研究一下这个参数的官方文档。
也可以对照一下wp_list_bookmarks去使用。

pad_counts
(boolean) Calculates link or post counts by including items from child categories. If show_counts and hierarchical are true this is automatically set to true. This parameter added at Version 2.9 Valid values:
1 (true)
0 (false) ? default

使用实例
显示包括ID为3,5,9,16的分类链接,且按名称排列顺序

<ul>
<?php wp_list_categories('orderby=name&include=3,5,9,16'); ?> 
</ul>

显示Poetry为标题的包括ID为5,9,23的分类列表

<ul>
<?php wp_list_categories('include=5,9,23&title_li=<h2>' . __('Poetry') . '</h2>' ); ?> 
</ul>

当然你也可以像如下这样书写参数,将参数整合为数组。

<?php 
$taxonomy   = 'genre';
$orderby   = 'name'; 
$show_count  = 0;   // 1 for yes, 0 for no
$pad_counts  = 0;   // 1 for yes, 0 for no
$hierarchical = 1;   // 1 for yes, 0 for no
$title    = '';
 
$args = array(
 'taxonomy'   => $taxonomy,
 'orderby'   => $orderby,
 'show_count'  => $show_count,
 'pad_counts'  => $pad_counts,
 'hierarchical' => $hierarchical,
 'title_li'   => $title
);
?>
 
<ul>
<?php wp_list_categories( $args ); ?>
</ul>

taxonomy分类法,是相对于标签(tag)的概念。

PHP 相关文章推荐
在数据量大(超过10万)的情况下
Jan 15 PHP
基于asp+ajax和数据库驱动的二级联动菜单
May 06 PHP
通过PHP的内置函数,通过DES算法对数据加密和解密
Jun 21 PHP
PHP提示Notice: Undefined variable的解决办法
Nov 24 PHP
PHP验证码函数代码(简单实用)
Sep 29 PHP
PHP5各个版本的新功能和新特性总结
Mar 16 PHP
php更新mysql后获取改变行数的方法
Dec 25 PHP
yii2中添加验证码的实现方法
Jan 09 PHP
自写的利用PDO对mysql数据库增删改查操作类
Feb 19 PHP
详解PHP神奇又有用的Trait
Mar 25 PHP
PHP面向对象程序设计之构造方法和析构方法详解
Jun 13 PHP
详细分析PHP 命名空间(namespace)
Jun 30 PHP
大家须知简单的php性能优化注意点
Jan 04 #PHP
weiphp微信公众平台授权设置
Jan 04 #PHP
PHP在线书签系统分享
Jan 04 #PHP
PHP数据库连接mysql与mysqli对比分析
Jan 04 #PHP
非常重要的php正则表达式详解
Jan 04 #PHP
PHP 下载文件时如何自动添加bom头及解释BOM头和去掉bom头的方法
Jan 04 #PHP
隐藏Nginx或Apache以及PHP的版本号的方法
Jan 03 #PHP
You might like
php设计模式 Decorator(装饰模式)
2011/06/26 PHP
php一维二维数组键排序方法实例总结
2014/11/13 PHP
PHP如何实现跨域
2016/05/30 PHP
详解PHP数据压缩、加解密(pack, unpack)
2016/12/17 PHP
js函数返回多个返回值的示例代码
2013/11/05 Javascript
javascript事件冒泡详解和捕获、阻止方法
2014/04/12 Javascript
Jquery 监视按键,按下回车键触发某方法的实现代码
2014/05/11 Javascript
JavaScript实现带缓冲效果的随屏滚动漂浮广告代码
2015/11/06 Javascript
全面解析Bootstrap表单使用方法(表单控件)
2015/11/24 Javascript
Jquery+ajax+JAVA(servlet)实现下拉菜单异步取值
2016/03/23 Javascript
关于Vue.js一些问题和思考学习笔记(1)
2016/12/02 Javascript
原生js实现无缝轮播图效果
2017/01/11 Javascript
JS实现AES加密并与PHP互通的方法分析
2017/04/19 Javascript
Vue实现选择城市功能
2017/05/27 Javascript
详解vue组件通信的三种方式
2017/06/30 Javascript
基于jQuery实现定位导航位置效果
2017/11/15 jQuery
JS canvas绘制五子棋的棋盘
2020/05/28 Javascript
vue2.0中set添加属性后视图不能更新的解决办法
2019/02/22 Javascript
小程序如何定位所在城市及发起周边搜索
2020/02/11 Javascript
JavaScript 引用类型实例详解【数组、对象、严格模式等】
2020/05/13 Javascript
Vuejs通过拖动改变元素宽度实现自适应
2020/09/02 Javascript
[01:02]DOTA2辉夜杯决赛日 CDEC.Y对阵VG赛前花絮
2015/12/27 DOTA
浅谈Python 的枚举 Enum
2017/06/12 Python
python操作小程序云数据库实现简单的增删改查功能
2019/06/06 Python
Pandas_cum累积计算和rolling滚动计算的用法详解
2019/07/04 Python
Python实现Mysql数据统计及numpy统计函数
2019/07/15 Python
Python3使用PySynth制作音乐的方法
2019/09/09 Python
Python基本语法之运算符功能与用法详解
2019/10/22 Python
Python常用断言函数实例汇总
2020/11/30 Python
有关HTML5中背景音乐的自动播放功能
2017/10/16 HTML / CSS
个人学习总结范文
2015/02/15 职场文书
2016优秀员工先进事迹材料
2016/02/25 职场文书
2016年社区综治宣传月活动总结
2016/03/16 职场文书
python通配符之glob模块的使用详解
2021/04/24 Python
JavaScript 中for/of,for/in 的详细介绍
2021/11/17 Javascript
MySQL高级进阶sql语句总结大全
2022/03/16 MySQL