wordpress 模板标签——分类标签

the_category

描述 ：显示一个链接，连接到一个类别或者一篇文章所属的类别。必须在The Loop内部使用这个标签。

用法：<?php the_category('separator', 'parents' );?>

例子：有一个Bullet分开

显示链接，连接到类别，用一个bullet (?)将类别分开。

Post Categories: <?php the_category(' &bull; ');?>

Post Categories: WordPress ? 电脑 ? 写博客

参数

separator：(string)每个类别链接之间显示的文本或者字符。默认是将链接放入一个无序的列表中。

parents：(string)怎样显示子（子）类别中的链接。选项有：

· 'multiple(多个)' -先母子类别分开显示链接，展示"母/子"关系。

· 'single(单一的)' -只显示链接到子类别的链接，用链接文本展示"母/子"关系。

注：默认情况是一个链接连接到子类别，没有显示关系。

the_category_rss

描述 ：在RSS格式中，显示类别名称或者一篇文章所属的类别的名称。必须在The Loop内部使用这个标签。

用法：<?php the_category_rss('type')?>

例子：一个RSS2 feed网页的部分。 <?php the_category_rss()?>

<guid><?php the_permalink($id);?></guid>

参数：type：(string) 显示的feed的类型。有效的参数值:

· 'rss' (默认)

· 'rdf'

single_cat_title

描述：为当前网页显示或者返回一个类别标题。对于显示WordPress标签而不是类别的网页（例如"/tag/geek"），标签名称而不是类别得到显示。只能够在The Loop外部使用。

用法：<?php single_cat_title('prefix', 'display');?>

例子：这个例子在类别标题的后面显示了文本"当前浏览"。
<p><?php single_cat_title('Currently browsing ');?>.</p>

当前浏览WordPress。
这个例子将当前类别标题分配给变数variable $current_category，在PHP中使用。

<?php $current_category = single_cat_title("", false);?>

参数

prefix

(string) 在类别标签前的文本。默认'' (没有文本)。

display

(boolean)显示类别的标题 (TRUE) 或者将其返回，在PHP 中使用 (FALSE)。默认TRUE。

category_description

描述：返回类别描述。

用法：<?php category_description(category);?>

例子：默认用法

显示ID为3的类别描述，echoing标签的返回值。

<p><?php echo category_description(3);?></p>

WordPress 是我最喜爱的一个写博客的工具，我在这里分享使用WordPress的小贴士和方法技巧。

用类别标题

<p><strong><?php single_cat_title('当期浏览');?>

</strong>: <?php echo category_description();?></p>

当前浏览 WordPress: WordPress 是我最喜爱的一个写博客的工具，我在这里分享使用WordPress的小贴士和方法技巧。

参数

类别

(整数) 标签需要返回描述的类别的ID数。如果没有设置，默认为当前的类别。

wp_dropdown_categories

描述：在一个没有提交按钮的选择框（如下拉列表）上显示类别的一个列表。

用法：<?php wp_dropdown_categories('arguments');?>

例子：默认用法

$defaults = array('show_option_all' => '', 'show_option_none' => '', 'orderby' => 'ID',

'order' => 'ASC', 'show_last_update' => 0, 'show_count' => 0, 'hide_empty' => 1,

'child_of' => 0, 'exclude' => '', 'echo' => 1, 'selected' => 0, 'hierarchical' => 0,

'name' => 'cat', 'class' => 'postform', 'depth' => 0);

默认情况下，用法是：

• 以上升的顺序，根据类别id分类

• 不显示最后一次的更新

• 不显示一个类别内文章的数目

• 不显示 '空' 类别

• 不排除任何内容

• 显示(echos)类别

• 没有从形式上'选择'类别‘

• 不以等级结构显示类别

• 将'cat'指定为格式名

• 将格式指定到级别'平台'

• 没有深入的限制

<?php wp_dropdown_categories();?>

拥有提交按钮的下拉列表

以HTML的形式，拥有一个提交按钮，显示一个等级类别的下拉列表，在WordPress工具条中无序的列表上，显示每个类别的文章数目。

<li id="categories">

<h2><?php _e('Categories:');?></h2>

<form action="<?php bloginfo('url');?>" method="get">

<?php wp_dropdown_categories('show_count=1&hierarchical=1');?>

<input type="submit" name="submit" value="view" />

</form>

</li>

使用JavaScript没有提交按钮的下拉列表

例子描述了使用show_option_none参数而且是从Moshu的论坛文章中收集的。

· <?php _e('Posts by Category');?>

<?php wp_dropdown_categories('show_option_none=Select category');?>

<script type="text/javascript"></script> </li>

· </pre>

使用JavaScript没有提交按钮的下拉列表 (2)

这个例子使用了echo 参数 (echo=0)。一个简单的preg_replace插入了JavaScript代码。设置没有JavaScript也能够运行（提交按钮被noscript标签覆盖）。

<li id="categories">

<h2><?php _e('Posts by Category');?></h2>

<form action="<?php bloginfo('url');?>/" method="get">

<?php

$select = wp_dropdown_categories('show_option_none=Select category&show_count=1&orderby=name&echo=0');

$select = preg_replace("#<select([^>]*)>#", "<select$1 οnchange='return this.form.submit()'>", $select);

echo $select;

?>

<noscript><input type="submit" value="View" /></noscript>

</form>

</li>

参数

show_option_all：(string)导致下拉列表的HTML，允许你选择所有的类别。

show_option_none：(string)导致下拉列表的HTML，允许你不选择类别。

orderby：(string)给选项分类的关键词。有效的参数值：

· 'ID' (默认)

· 'name'

Order：(string) 选项的分类顺序。有效的参数值：

· 'ASC' (默认的)

· 'DESC'

show_last_update：(boolean) 设置是否在每个类别上显示最后一篇文章的日期。有效的参数值：

· 1 (True)

· 0 (False - Default)

show_count：(boolean) 设置是否显示每个类别中的文章的数目。有效的参数值：

· 1 (True)

· 0 (False - Default)

hide_empty：(boolean) 设置是否隐藏(不显示)不包含有文章的类别。有效的参数值：

· 1 (正确的 – 默认)

· 0 (错误的)

child_of：(integer)只显示类别ID识别的子类别。这个参数没有默认值。

Exclude：(string) 用逗号分开要删除的类别的ID。例如，'删除=4,12'，指的是类别4和12不会被显示/echoed或者返回。默认不删除任何类别。

Echo：(boolean)显示书签(TRUE)或者返回书签供PHP使用(FALSE)。默认TRUE。

· 1 (True - default)

· 0 (False)

Selected：(integer) 要被'挑选'或者显示在展示框中的类别的类别ID。默认不选择任何类别。

Hierarchical：(boolean) 以等级级别的方式显示类别（子类别以嵌套的方式显示）。默认FALSE。

· 1 (True)

· 0 (False - Default)

Name：(string) 给下拉列表指定的形式的名称。默认为'cat'。

Class：(string) 指定给下拉列表形式的类别。默认为'文章形式'。

Depth：(integer) 这个参数控制了，列出的类别中可以包含多少个类别层级。默认值是0（显示所有的类别和子类别）。这个参数在2.5版本时添加的。

· 0 - 所有的类别和子类别（默认）。

· -1 -所有的类别以平常格式（而不是缩进格式）显示（删除等级级别)。

· 1 -只显示最高级别的类别

· n - n 值(某个数目)规定显示类别的时候，可以显示的子类别的层级(或者等级)