WordPress标签云标签:wp_tag_cloud
文 / @UTHEME
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()

相关文章
-
WordPress插件:All in One WP Security & Firewall 怎么样(附:AIOWPS拦截垃圾评论设置教程) 2023-01-26 21:51:51
-
在 PHP 中如何通过一行代码就交换两个变量的值 2023-01-26 00:18:31
-
WordPress主题:Pin Premium (WordPress仿Pinterest样式瀑布流主题) 2023-01-25 23:36:43
-
免费WordPress主题:Maupassant(WordPress中文博客主题) 2023-01-25 23:31:29
-
WordPress响应式图片(Responsive Image)功能关闭:取消WordPress图片宽带和高度参数 2023-01-24 10:49:32
-
wordpress报错:修复MySQL 1064错误问题 错误原因和解决方法 2023-01-24 10:42:04
-
WP Rocket – 强大的WordPress缓存加速优化插件(附:WP Rocket插件设置过程与七折优惠码) 2023-01-24 00:41:44
-
WordPress 实现静态化搜索结果页面的方法 2023-01-24 00:41:44
-
get_permalink、get_the_permalink和the_permalink有啥区别? 2023-01-24 00:41:08
-
为什么选用WordPress搭建独立站? 2023-01-23 20:25:21