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()