返回列表 发帖

wp_list_categories 标签的用法

wp_list_categories  标签的用法


注意,本文中所有“列表”指的是你blog中所有分类名称的列表,而这个标签的作用正应用于此。

作用:(我英文实在很菜,可能翻译不准确。)
·不是连接到某个分类的
·排列分类
·不显示上一次更新(上次更新后,在当前类内)
·可以无序排列
·可以显示日志数量
·可以只显示制定某个分类
·可以指定分类说明or标题
·可设置无Feed或Feed使用图标
·没有任何exlude类,并包括所有类别? ('include' => is not shown above)
·缩进?等级?排列样式
·分类标题名单?
·没有限制的sql施加? ('number' => 0 is not shown above)


不管这些了,先举几个例子你就明白了:

1.包含或排除某分类:
意思就是把分类ID为3,5,9,16的分类按名称顺序来排序:
  1. <?php wp_list_categories('orderby=name&include=3,5,9,16'); ?>
复制代码
按名称排列,并显示每个分类的日志总数,并不显示ID为10的分类:
  1. <?php wp_list_categories('orderby=name&show_count=1&exclude=10'); ?>
复制代码

2.显示或隐藏列表标题:
过滤ID为4和7的分类,并且列表标题设置为“哈哈”:
  1. <?php wp_list_categories('exclude=4,7&title_li=哈哈'); ?>
复制代码
列表中只显示ID为5、9、23的分类,并把列表标题改为<h2>;Poetry</h2>(下面的格式是为了把“要显示的数据”和“标签参数区分开来”)
  1. <?php wp_list_categories('include=5,9,23&title_li=<h2>' . __('Poetry') . '</h2>' ); ?>
复制代码

3.那啥
这个参数的意思是:按ID排序,关闭分类说明(就是鼠标移动到连接上就不显示你在后台填的分类说明了,只显示“察看XX分类下的所有文章”),并且只显示ID为8的分类下的子分类,如果没有,则参数无效,会按默认来显示。
  1. <?php wp_list_categories('orderby=id&show_count=1&use_desc_for_title=0&child_of=8'); ?>
复制代码

4.外观是分类后面显示个(RSS),作用就不用我说了吧?
  1. <?php wp_list_categories('orderby=name&show_count=1&feed=RSS'); ?>
复制代码

5.这个比较酷,相信大家都喜欢:
分类名称后面显示一个自己制定的小图标,作用是RSS。
  1. <?php wp_list_categories('orderby=name&show_count=1&feed_image=/images/rss.gif'); ?>
复制代码

6.花式列表:
改变当前正在浏览的分类名字的样式。'style=list'的作用是给输出的html代码<li>中加一个class="current-cat", 然后你在CSS里添一个.current-cat {color:red;}那么我浏览分类AAA时,列表中的“AAA”3个字就是红色的,浏览BBB,“BBB”就是红色的。
  1. <?php wp_list_categories('style=list' ); ?>
复制代码



下面把所有参数和值汇总一下:

show_option_all
值:任意填。
如果你写<?php wp_list_categories('show_option_all=那啥'); ?>,那么在列表第一个分类就显示“那啥”两字,不过连接是连接到blog首页的,正好可以利用此参数加个“首页”。

orderby
值:ID、name(默认值)、count。
作用是按这3个值来排序。

order
值:ASC(默认值)、DESC。
ASC为升序,DESC为降序。

show_last_updated
值:0(默认值)、1。
0无作用,1为最近更新的分类显示在前面。

style
值:list(默认值)、none。
例6中已经举例了。none无作用。

show_count
值:0、1(默认值)
1在每个分类后面显示日志数量,0不显示。

hide_empty
值:0、1(默认值)
1是隐藏没有发表日志的分类,0是显示所有。

use_desc_for_title
值:0、1(默认值)
0为关闭说明,1为显示说明。上面有例子。

child_of
值:数字
显示指定ID(也就是所填的这个数字)下的子分类。

feed
值:任意
假如你填“啊!”,那么在你每个分类后面都会出现“(啊!)”,连接地址是RSS地址。

feed_image
值:任意。虽然任意,但是是个图片的地址才对。
用来在分类后面显示个RSS Feed图标,上面有例子。

exclude
值:任意。但是要填分类名称或者分类ID才有效。
用来过滤(或者说隐藏)某个分类在列表中的出现。

include
值:任意。但是要填分类名称或者分类ID才有效。
作用是只显示所填的这个分类名或ID。

hierarchical
值:0、1(默认值)
说是按分类文章数目排列的,但测试无效果。

title_li
值:任意
用来改变列表标题的。

number
值:整数
设置一个显示上限。




本节完。

英文原文:http://codex.wordpress.org/Template_Tags/wp_list_categories
译文:http://cirye.com/t/?p=14
转载请ping:http://cirye.com/t/wp-trackback.php?p=14

欢迎常来我的麦田坐坐:http://cirye.com/t







[ 本帖最后由 Tigerkin 于 2007-8-17 11:31 AM 编辑 ]
1

评分人数

很好的总结
提个意见,最好把原文出处标出来

TOP

呃……原文就是官方的wiki,codex
http://codex.wordpress.org/Template_Tags/wp_list_categories

TOP

LZ很不错,但我建议你把这个也写到
http://codex.wordpress.org.cn/

TOP

cqcrz, 好久不来,你都换头像了啊。

TOP

原帖由 Tigerkin 于 2007-8-1 18:09 发表
cqcrz, 好久不来,你都换头像了啊。

被人打击了
有说我的头像吓着他了,有说看着我头像,认为我不正经了
你说我能不换吗?

TOP

回复 #7 cqcrz 的帖子

哈哈~我觉得倒没那么夸张,你以前那个头像顶多给人顽皮、搞怪、大不咧咧的印象,不过这和真人又没关系……哈哈,那你说我头像是什么样

中文版的codex我很早前就去了,这次总结的这个文章我睡醒再加进去吧,因为我已经从昨天中午1点到现在没睡了,就快30小时了哦,而且其中的11个小时我都是骑在自行车上,狂奔230KM。
我现在编辑照片,写日记发blog……

TOP

很详细的介绍啊,支持下

TOP

原帖由 Tigerkin 于 2007-8-1 18:46 发表
哈哈~我觉得倒没那么夸张,你以前那个头像顶多给人顽皮、搞怪、大不咧咧的印象,不过这和真人又没关系……哈哈,那你说我头像是什么样

中文版的codex我很早前就去了,这次总结的这个文章我睡醒再加进去吧,因 ...

你还真能挺。

看了你的头像,我立马就去吃了个“绿色心情”

TOP

返回列表