wp_list_categories函数用法详解

来源:互联网 发布:windows bash 下载 编辑:程序博客网 时间:2024/05/21 03:54

正如标题所说,Wordpress是用wp_list_categories这个函数来显示分类的,其用法是:
< ?php wp_list_categories('arguments'); ?>
arguments即参数,默认参数设置为:


$defaults = array(
'show_option_all' => '', 不列出分类链接
'orderby' => 'name', 按照分类名排序
'order' => 'ASC', 升序排列
'show_last_update' => 0, 不显示分类中日志的最新时间戳
'style' => 'list',列表显示分类
'show_count' => 0, 不显示分类日志数量
'hide_empty' => 1, 不显示没有日志的分类
'use_desc_for_title' => 1, 显示分类描述
'child_of' => 0, 不限制子分类
'feed' => '', 不显示feed
'feed_image' => '', 不显示feed图片
'exclude' => '', 不显示该分类
'hierarchical' => true, 分层次显示父/子分类
'title_li' => __('Categories'), 用“Categories”为当前分类列表的标题
'echo' => 1, 显示(echos) 分类
'depth' => 0 不限制列表深度
);

用法举例:

按照分类名排序,并只显示 ID 为1、2、3和4的分类:

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

按照分类名排序,并显示每个分类的日志数,但不显示 ID 为10的分类

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

显示或隐藏列表标题
title_li 这个参数用于显示或者隐藏分类列表的标题,它的默认值为'(__('Categories')',即显示分类列表的标题,如果不设置或设置为空,它将什么也不显示。下面的例子将不显示id为4和7的分类,并不显示list_categories列表的标题:


< ?php
wp_list_categories('exclude=4,7&title_li='); ?>

接下来的例子是仅仅只显示 ID为5、9和23的分类,并且列表标题显示为“Poetry”表:


< ?php
wp_list_categories('include=5,9,23&title_li=

' . __('Poetry') . '' ); ?>

仅显示某个分类下的子分类
下面的示例代码生成了 ID 为8的父分类下的子分类根据其 ID 进行排序的链接列表,它会显示每个分类下的文章数,并且隐藏链接的 title 标签中的分类描述,注意:如果父分类下没有任何文章,那么父分类将不会显示(读起来貌似很难理解,不过照着做就理解了)


< ?php wp_list_categories('orderby=id&show_count=1
&use_desc_for_title=0&child_of=8'); ?>

显示带有 RSS Feed 链接的分类列表
面代码根据分类名对分类列表排序,并显示每个分类下的文章数和 RSS 的 Feed 链接:


< ?php
wp_list_categories('orderby=name&show_count=1&feed=RSS'); ?>

还可以使用 RSS 图标代替 RSS 链接


< ?php
wp_list_categories('orderby=name&show_count=1
&feed_image=/images/rss.gif'); ?>

欢迎大家去我的独立博客作客:http://www.chenguangblog.com

除非注明,晨光博客文章均为晨光原创,转载请以链接形式标明本文地址

来自: http://hi.baidu.com/%B3%BF%B9%E2%B2%A9%BF%CD/blog/item/c3f3602ac88a0fb14723e8a7.html
wordpress官方文档:http://codex.wordpress.org/Template_Tags/wp_list_categories#Display_or_Hide_the_List_Heading