11 May 2009

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的分类按名称顺序来排序：

按名称排列，并显示每个分类的日志总数，并不显示ID为10的分类：

2.显示或隐藏列表标题：
过滤ID为4和7的分类，并且列表标题设置为“哈哈”：

列表中只显示ID为5、9、23的分类，并把列表标题改为

;Poetry（下面的格式是为了把“要显示的数据”和“标签参数区分开来”）

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

3.这个参数的意思是：按ID排序，关闭分类说明（就是鼠标移动到连接上就不显示你在后台填的分类说明了，只显示“察看XX分类下的所有文章”），并且只显示ID为8的分类下的子分类，如果没有，则参数无效，会按默认来显示。

4.外观是分类后面显示个（RSS），作用就不用我说了吧？

5.这个比较酷，相信大家都喜欢：
分类名称后面显示一个自己制定的小图标，作用是RSS。

6.花式列表：
改变当前正在浏览的分类名字的样式。’style=list’的作用是给输出的html代码

• 中加一个class=”current-cat”， 然后你在CSS里添一个.current-cat {color:red;}那么我浏览分类AAA时，列表中的“AAA”3个字就是红色的，浏览BBB，“BBB”就是红色的。</p> >

  **下面把所有参数和值汇总一下：</p>

  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

Til next time,
Jason at 00:00