当前浏览:首页 / WordPress钩子 / wp_generate_tag_cloud

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

过滤生成的标签云输出

cloud

generate

tagmore...


描述

只有当将true值传递给wp_generate_tag_cloud()中的$filter参数时,才会执行过滤器。

另见


参数

$returnstring[]|string
如果'format'参数等于'array',则包含生成的HTML标签云输出或标签链接数组的字符串。
$tagsWP_Term[]
标签云中使用的分类项(term)数组。
$argsarray
wp_generate_tag_cloud()参数数组。

更多参数来自:wp_generate_tag_cloud( ... $args )

用于生成标签云的参数数组或字符串

  • smallestint
    用于显示标签的最小字体大小。与$unit的值配对,以确定CSS文本大小单位。默认值8(pt)。
  • largestint
    用于显示标签的最大字体大小。与$unit的值配对,以确定CSS文本大小单位。默认值22(pt)。
  • unitstring
    用于$smallest$largest值的CSS文本大小单位。接受任何有效的CSS文本大小单位。默认'pt'
  • numberint
    要返回的标签数。接受任何正整数或零以返回全部。
    默认值0。
  • formatstring
    显示标签云的格式。接受'flat'(用空格分隔的标签)、'list'(无序列表中显示的标签)或'array'(返回数组)。
    默认值'flat'
  • separatorstring
    HTML或文本分隔标签。默认值“n”(换行)。
  • orderbystring
    标签排序依据的值。接受'name''count'
    默认值'name''tag_cloud_sort'过滤器还可以影响标签的排序方式。
  • orderstring
    如何排序标签。接受'ASC'(升序)、'DESC'(降序)或'RAND'(随机)。默认'ASC'
  • filterint|bool
    是否通过'wp_generate_tag_cloud'启用最终输出的过滤。默认值1。
  • topic_count_textarray
    _n_noop()中选择要提供给标签计数的多个文本。默认值为null。
  • topic_count_text_callbackcallable
    回调用于根据计数为标签计数生成多个文本。默认值为null。
  • topic_count_scale_callbackcallable
    用于确定标签计数值的回调。默认default_topic_count_scale()
  • show_countbool|int
    是否显示标签计数。默认值为0。接受0、1或它们的布尔值。


源码

查看源码 官方文档


更新日志

版本描述
2.3.0开始引入