当前浏览:首页 / WordPress函数 / wp_generate_tag_cloud()

wp_generate_tag_cloud( WP_Term[] $tags, string|array $args = '' )

根据提供的数据生成标签云(热点图)

cloud

generate

tagmore...


参数

$tags

(WP_Term[])(必填) 生成标签云的WP_Term对象数组。

$args

(string|array)(可选) 用于生成标签云的参数数组或字符串。

  • 'smallest'
    (int) 用于显示标签的最小字体大小。与$unit的值配对,以确定CSS文本大小单位。默认值8(pt)。
  • 'largest'
    (int) 用于显示标签的最大字体大小。与$unit的值配对,以确定CSS文本大小单位。默认值22(pt)。
  • 'unit'
    (string) 用于$smallest$largest值的CSS文本大小单位。接受任何有效的CSS文本大小单位。默认值'pt'。
  • 'number'
    (int) 要返回的标签数。接受任何正整数或零以返回全部。默认值为0。
  • 'format'
    (string) 显示标签云的格式。接受'flat'(用空格分隔的标签)、'list'(无序列表中显示的标签)或'array'(返回数组)。默认值'flat'。
  • 'separator'
    (string) HTML或文本来分隔标签。默认值“n”(换行符)。
  • 'orderby'
    (string) 按值排序标签。接受'name'或'count'。默认值'name'。tag_cloud_sort过滤器也会影响标签的排序方式。
  • 'order'
    (string) 如何排序标签。接受'ASC'(升序)、'DESC'(降序)或'RAND'(随机)。默认值'ASC'。
  • 'filter'
    (int|bool) 是否通过wp_generate_tag_cloud启用最终输出的过滤。默认值1。
  • 'topic_count_text'
    (string)_n_noop()中去掉复数文本以提供标签计数。默认为null。
  • 'topic_count_text_callback'
    (callable) 回调用于根据计数为标签计数生成无标签复数文本。默认为null。
  • 'topic_count_scale_callback'
    (callable) 用于确定标签计数缩放值的回调。默认值default_topic_count_scale()
  • 'show_count'
    (bool|int) 是否显示标签计数。默认值为0。接受0、1或其布尔等价项。

默认值: ''


返回

(string|string[]) 根据'format'参数,将标签云作为字符串或数组返回。



源码

查看源码 官方文档


更新日志

版本描述
4.8.0添加了show_count参数。
2.3.0开始引入