详解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 相关文章推荐
非常好的php目录导航文件代码
Oct 09 PHP
相对路径转化成绝对路径
Apr 10 PHP
php自动获取目录下的模板的代码
Aug 08 PHP
php函数的常用方法及注意之处小结
Jul 10 PHP
用PHP+MySQL搭建聊天室功能实例代码
Aug 20 PHP
PHP转换IP地址到真实地址的方法详解
Jun 09 PHP
php生成二维码
Aug 10 PHP
PHP开发中csrf攻击的简单演示和防范
May 07 PHP
PHP使用redis消息队列发布微博的方法示例
Jun 22 PHP
PHP空值检测函数与方法汇总
Nov 19 PHP
PHP中PCRE正则解析代码详解
Apr 26 PHP
php生成HTML文件的类方法
Oct 11 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
MySql中正则表达式的使用方法描述
2008/07/30 PHP
php调整服务器时间的方法
2015/04/03 PHP
两款万能的php分页类
2015/11/12 PHP
详解yii2实现分库分表的方案与思路
2017/02/03 PHP
使用laravel和ECharts实现折线图效果的例子
2019/10/09 PHP
Laravel相关的一些故障解决
2020/08/19 PHP
cookie丢失问题(认证失效) Authentication (用户验证信息)也会丢失
2009/06/04 Javascript
JavaScript高级程序设计(第3版)学习笔记2 js基础语法
2012/10/11 Javascript
Jquery实现三层遍历删除功能代码
2013/04/23 Javascript
JavaScript解析json格式数据简单示例
2014/12/09 Javascript
jQuery对象的selector属性用法实例
2014/12/27 Javascript
浅谈JavaScript的函数及作用域
2016/12/30 Javascript
纯javaScript、jQuery实现个性化图片轮播【推荐】
2017/01/08 Javascript
微信小程序实现tab和swiper切换结合效果
2020/07/17 Javascript
移动web开发之touch事件实例详解
2018/01/17 Javascript
Vue+Jwt+SpringBoot+Ldap完成登录认证的示例代码
2018/05/21 Javascript
使用Vue开发自己的Chrome扩展程序过程详解
2019/06/21 Javascript
关于vue的列表图片选中打钩操作
2020/09/09 Javascript
Python标准库内置函数complex介绍
2014/11/25 Python
Python 3中的yield from语法详解
2017/01/18 Python
Python实现字符串格式化输出的方法详解
2017/09/20 Python
深入理解Django中内置的用户认证
2017/10/06 Python
Python生成器的使用方法和示例代码
2019/03/04 Python
Python实现时间序列可视化的方法
2019/08/06 Python
django fernet fields字段加密实践详解
2019/08/12 Python
Python 利用邮件系统完成远程控制电脑的实现(关机、重启等)
2019/11/19 Python
Python实现将元组中的元素作为参数传入函数的操作
2020/06/05 Python
python 获取字典键值对的实现
2020/11/12 Python
番木瓜健康和保健产品第一大制造商:Herbal Papaya
2017/04/25 全球购物
英国最大的纸工艺品商店:CraftStash
2018/12/01 全球购物
财务会计毕业生个人求职信
2014/02/03 职场文书
自考毕业自我鉴定
2014/03/18 职场文书
老公保证书
2015/01/17 职场文书
求职信格式范文
2015/03/19 职场文书
2015年领导班子工作总结
2015/05/23 职场文书
sql注入教程之类型以及提交注入
2021/08/02 MySQL