WordPress函数：wp_tag_cloud（标签云）

说明

wp_tag_cloud() 函数的作用是用来标签云的，可以根据每个标签所关联的文章次数来定义字体大小、标签排序等属性。从 2.8 版本开始，添加了 分类法（taxonomy）参数，这就意味着，除了 标签（tags）以外，还可以将 分类（Categories） 或其他 自定义分类法（Custom Taxonomies）作为“云”显示。

用法

默认用法

<?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,
'child_of'                   => null(see Note!)
); ?>

默认情况下的输出内容：

• smallest —— 最小的标签（使用次数最少）显示大小为8
• largest ——最大的标签（使用次数最多）显示大小为22
• unit —— 最大值最小值的单位为'pt'
• number —— 至多显示45个标签
• format —— 以平面形式显示所有标签（标签之间用空格隔开）
• separator —— 显示标签之间的空格
• orderby —— 按名称为标签排序
• order —— 以升序排列
• exclude —— 不排除任何标签
• include —— 包括所有标签
• topic_count_text_callback —— 使用函数 default_topic_count_text
• link —— 可视
• taxonomy —— 用文章的标签作为云基础
• echo —— 输出结果

参数

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中。注意：数组被返回，而非显示。

separator

（字符串）（可选）标签之间的文本/空格。

默认值：'\n' （空格）

orderby

（字符串）（可选）标签的排列依据。有效值包括：

• 'name' （默认值）
• 'count'

order

（字符串）（可选）排列顺序（升序或降序）。有效值包括（必须大写）：

• 'ASC' ——升序（默认值）
• 'DESC' ——降序
• 'RAND' —— 随机

exclude

（字符串）（可选）将要被排除的标签（term_id）的ID，各ID用逗号隔开。如 'exclude=5,27'表示不显示term_id为5或27的标签。默认值为不排除任何标签。

include

（字符串）（可选）要包含的标签（term_id）列表，各ID用逗号隔开。例如， 'include=5,27' 表示只显示term_id为5或27的标签。默认为包含所有链接。

topic_count_text_callback

（字符串）（可选）给出标签所关联的文章数，返回标签链接的用于 tooltip 的文本。

默认值： default_topic_count_text

link

（字符串）（可选）设置链接，允许编辑某个指定标签。有效值包括：

• 'view' （默认值）
• 'edit'

taxonomy

（字符串）（可选）用以生成云的分类法。

• 'post_tag' —— （默认值）将文章标签当作云的来源
• 'category' —— 用文章分类生成云
• 'link_category' —— 用链接分类目录生成云
• 任何其他已注册的分类法
• 或者一组 分类法 （注：此参数引入于 3.1 版本）

echo

（布尔型）（可选）显示结果，或将结果保留在变量中。默认值为true（显示标签云）。有效值包括：

• 1 (true) —— 默认值
• 0 (false)

显示 分类 和 标签 云

使用分类法数组将分类和标签显示为云

<?php 
  $args = array(
    'taxonomy'  => array('post_tag','category'), 
   ); 
 
  wp_tag_cloud($args);
?>