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)的概念。
本文向大家介绍详解WordPress开发中get_current_screen()函数的使用,包括了详解WordPress开发中get_current_screen()函数的使用的使用技巧和注意事项,需要的朋友参考一下 get_current_screen() 函数是一个我们很少用到,但却超级实用的一个函数,如果你正着手于制作一个主题,却不知道文档应该放在哪里的话,那你应该看一下这个从 WordP
本文向大家介绍详解WordPress中用于合成数组的wp_parse_args()函数,包括了详解WordPress中用于合成数组的wp_parse_args()函数的使用技巧和注意事项,需要的朋友参考一下 wp_parse_args() 函数是 WordPress 核心经常用到的函数,它的用途很多,但最主要用来给一个数组参数(args)绑定默认值。 因为 wp_parse_args() 函数返回
本文向大家介绍详解WordPress开发中用于获取分类及子页面的函数用法,包括了详解WordPress开发中用于获取分类及子页面的函数用法的使用技巧和注意事项,需要的朋友参考一下 get_category get_category 可能我们平时接触的不多,但却是很有用,网上这个函数介绍的貌似不多,所以今天只针对官方 WordPress 英文文档做一下翻译。 函数描述 获得指定分类,以数组或是对象的
本文向大家介绍Python函数参数分类原理详解,包括了Python函数参数分类原理详解的使用技巧和注意事项,需要的朋友参考一下 一、参数的定义 1、函数的参数在哪里定义 在python中定义函数的时候,函数名后面的括号里就是用来定义参数的,如果有多个参数的话,那么参数之间直接用逗号,隔开 案列: 2、带参数的函数调用: 函数定义了参数,那么调用函数的时候就需要传入参数 add_num(11,22)
本文向大家介绍详解JavaScript中常用的函数类型,包括了详解JavaScript中常用的函数类型的使用技巧和注意事项,需要的朋友参考一下 网页中的java代码需要写在JavaScript中,里面部分少不了函数,介绍一下JavaScript中常用的函数类型。 1、可变函数 综上的例子,Js当中的函数是不存在重载的。一定就通配所有的了,函数虽然定义时是声明若干变量,但调用时却是可以传入任意个。每
本文向大家介绍Python中的getopt函数使用详解,包括了Python中的getopt函数使用详解的使用技巧和注意事项,需要的朋友参考一下 函数原型: 参数解释: args:args为需要解析的参数列表。一般使用sys.argv[1:],这样可以过滤掉第一个参数(ps:第一个参数是脚本的名称,它不应该作为参数进行解析) shortopts:简写参数列表 longopts