WordPress标签云标签：wp_tag_cloud

WordPress模板标签wp_tag_cloud用于输出标签云，标签的大小由该标签下的文章数量决定。

wp_tag_cloud( array $args = \'\' )

函数参数

$args

数组或字符串值

wp_tag_cloud()函数$args参数默认的值如下：

$args = array(\'smallest\'                  => 8, \'largest\'                   => 22,\'unit\'                      => \'pt\', \'number\'                    => 45,  \'format\'                    => \'flat\',\'separator\'                 => \"\\n\",\'orderby\'                   => \'name\', \'order\'                     => \'ASC\',\'exclude\'                   => null, \'include\'                   => null, \'topic_count_text_callback\' => default_topic_count_text,\'link\'                      => \'view\', \'taxonomy\'                  => \'post_tag\', \'echo\'                      => true,\'child_of\'                  => null,);

wp_tag_cloud()函数$args参数可用的值如下：

smallest

整数型，默认值：8

最小字号大小

largest

整数型，默认值：22

最大字号大小

unit

字符串值，默认值：pt

字号单位

number

整数型，默认值：45

显示的标签数量

format

字符串值，默认值：flat

列表的格式，可选值：

• flat：空格；
• list：UL列表；
• array：数组；

separator

字符串值，默认值：\\n

标签之间的文本

orderby

字符串值，默认值：name

排序规则，可选值：

• name：按名称排序；
• count：按文章数量排序；

order

字符串值，默认值：ASC

排序方式，可选值：

• ASC：升序；
• DESC：降序；
• RAND：随机；

exclude

字符串值，默认值：null

提供标签ID，以排除显示这些标签，多个标签ID用半角逗号分隔

include

字符串值，默认值：null

提供标签ID，以显示这些标签，多个标签ID用半角逗号分隔

topic_count_text_callback

字符串值，默认值：default_topic_count_text

指定一个函数名称，该函数返回的值将作为链接的title属性值，默认输出文章数量，例如：28个话题

link

字符串值，默认值：view

链接的类型，可选值：

• view：输出标签归档页面链接；
• edit：当已登录且有编辑标签的权限时，输出编辑该标签的链接，否则输出首页链接；

taxonomy

字符串或数组，默认值：post_tag

指定分类法名称，可选值：

• post_tag：文章标签；
• category：文章分类；
• link_category：友情链接分类；

echo

布尔值，默认值：true

是否输出返回结果

函数使用示例

<?php if ( function_exists( \'wp_tag_cloud\' ) ) : ?><h2>标签云集</h2><ul><li><?php wp_tag_cloud( \'smallest=8&largest=22\' ); ?></li></ul><?php endif; ?>

扩展阅读

wp_tag_cloud()函数位于：wp-includes/category-template.php

相关函数：

• get_tag()
• get_tag_link()
• get_tags()
• get_the_tag_list()
• get_the_tags()
• is_tag()
• the_tags()
• single_tag_title()
• tag_description()
• wp_generate_tag_cloud()