首页 > 代码库 > wp_list_categories函数用法详解

wp_list_categories函数用法详解

本以为写完新手教程之后,可以不写新手应用方面的文章了的,可今天又有朋友在群里问如何显示每个分类下文章数量这个基础性问题,看来Wordpress中文化还有很长的一段路要走,我们任重而道远啊!好,解决你的问题先:
正如标题所说,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 不限制列表深度
);

用法举例:

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

 

        < ?php

 

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

 

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

 

        < ?php

 

        wp_list_categories(‘orderby=name&show_count=1&exclude=10‘); ?>

 

    1. 显示或隐藏列表标题

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‘) . ‘‘ ); ?>

 

    1. 仅显示某个分类下的子分类

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

        < ?php wp_list_categories(‘orderby=id&show_count=1

 

        &use_desc_for_title=0&child_of=8‘); ?>

 

    1. 显示带有 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‘); ?>