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