函数 wp_generate_tag_cloud() 用于生成一个标签云(Tag Cloud),显示网站上使用的标签的不同大小,以反映标签的热度或使用频率。
函数原型:
wp_generate_tag_cloud( $tags, $args );
参数说明:
1. `$tags`(必需):一个数组,其中包含需要显示的标签。每个标签应该是一个对象,对象中需要包含 `name`(标签的名称),`count`(标签的计数)和 `link`(标签链接的 URL)。
2. `$args`(可选):一个关联数组,用于指定标签云的显示选项。
常用选项:
- `'smallest'`:最小的标签字体大小,默认是 `8`。
- `'largest'`:最大的标签字体大小,默认是 `22`。
- `'unit'`:标签大小的单位,默认是 `px`。
- `'number'`:显示的标签数量,默认是 `45`。
- `'format'`:标签输出的格式,默认是 `flat`,可以设置为 `list`,表示以列表形式输出标签。
- `'separator'`:标签之间的分隔符,默认是一个空格。
- `'orderby'`:标签排序方式,默认是 `name`,可以设置为 `count`,表示按标签的计数排序。
使用示例:
8,
'largest' => 22,
'unit' => 'px',
'number' => 45,
'format' => 'flat',
'separator' => ' ',
'orderby' => 'count'
);
echo wp_generate_tag_cloud( $tags, $args ); // 生成标签云
?>
以上示例获取了当前网站上所有的标签,并按照标签的计数排序,生成一个包含最多 45 个标签的标签云。标签的大小范围从 8px 到 22px,以像素为单位。标签之间以空格分隔,并以扁平格式输出。
更多参数选项和使用示例,请参考官方文档:[https://developer.wordpress.org/reference/functions/wp_generate_tag_cloud/](https://developer.wordpress.org/reference/functions/wp_generate_tag_cloud/)
0 个评论