WordPress 模板标签函数wp_tag_cloud()使用介绍

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官方文档

网友留言:

  1. 写的很详细,赞一个

发表留言