WordPress 模板标签函数wp_tag_cloud()使用介绍
wordPress 2.3版本开始使用wp_tag_cloud函数来调用文章标签显示列表,WP博主可以轻易地通…
wordPress 2.3版本开始使用wp_tag_cloud函数来调用文章标签显示列表,WP博主可以轻易地通过设置wp_tag_cloud函数的标签参数属性,使标签实现多样化显示。如按标签使用频率而决定显示标签的大小等。下面博客吧详细介绍该wp标签wp_tag_cloud的参数属性及其使用方法。
wp_tag_cloud标签用法
1 |
<?php wp_tag_cloud( $args ); ?> |
其默认参数如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
<?php $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 ); ?> |
wp_tag_cloud标签参数说明
- smallest:使用次数最少的标签的字号大小(单位由unit参数决定),默认值为8
- largest:使用次数最多的标签的字号大小(单位由unit参数决定),默认值为22
- unit:(字符串)对smallest与largest的值的测量单位。可以是任何CSS长度单位,如pt, px, em, %。默认值为’pt’
- number:显示标签数量。(值为’0’时显示所有标签),默认值为45
- format:(字符串)所显示的云的格式。’flat’ (默认值)标签被“separator”参数所定义的空格分隔;’list’ 标签与class=’wp-tag-cloud’ 共同在UL中;’array’ 标签在数组中,函数以数组方式返回标签云,以用在PHP中。(数组被返回,而非显示,引入于WordPress 2.5)
- separator:(字符串)标签之间的文本/空格。(引入于WordPress 2.9)。默认值:’/n’ (空格)
- orderby:(字符串)标签的排列顺序的方式。’name’ (默认值,按名称排列),’count’ (按使用次数排列)
- order:(字符串)排列顺序(升序或降序)。
‘ASC’ ——默认值;
‘DESC’;
‘RAND’ 随机排列。(引入于WordPress 2.5) - exclude:(字符串)不显示的标签(term_id)的ID,各ID用逗号隔开。如 ‘exclude=1,2’表示不显示id为1和2的标签。默认全显示。
- include:(字符串)选择要显示的标签(term_id)列表,各ID用逗号隔开。例如, ‘include=3,4’ 表示只显示id为3和4的标签。默认全显示。
- link:(字符串)设置链接,允许编辑某个指定标签。(该标签引入于WordPress 2.7)。
‘view’ (默认值)
‘edit’ - taxonomy:(字符串)用以生成云的分类法。(引入于WordPress2.8)。
‘post_tag’ —— (默认值)将文章标签当作云的来源
‘category’ —— 用文章分类生成云
‘link_category’ —— 用链接分类目录生成云 - echo:(布尔型)显示结果,或将结果保留在变量中。默认值为true(显示标签云)。(该标签引入于WordPress2.8)
1 (true) —— 默认值
0 (false)
标签参数使用举例:
1 |
<?php wp_tag_cloud('smallest=8&largest=22&number=45&order=DESC'); ?> |
显示的效果请对照上面的参数说明
提醒:以上标签参数皆可选,可自由搭配使用。
提示:英文过关的朋友可以参考WP官方文档
类别:WordPress教程、
本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。
还没有任何评论,赶紧来占个楼吧!