首页 WordPress函数 WordPress标签云标签:wp_tag_cloud
正文 评论

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()
-=||=-收藏赞 (0)
更多主题
单栏极简文艺WordPress博客主题:Diaspora主题
¥ 0 关注:20,067
详情
简约黑白WordPress个人博客主题:Personal主题
¥ 0 关注:20,018
详情
v1.0.0
小程序收录免费WordPress主题:XCX主题
¥ 0 关注:19,648
详情
v1.0.0
一款简约单栏的免费WordPress博客主题:itheme主题
¥ 0 关注:18,129
详情
功能丰富切轻量的WordPress虚拟资源主题:Rizhuti主题
¥ 599 关注:18,018
详情
大气优雅免费WordPress博客主题:HONEY主题
¥ 0 关注:14,871
详情
回复
暂无评论

不要再留垃圾评论了,主题君整理资源不容易,留几句鼓励的话吧。