显示标签云。
原型
wp_tag_cloud( array|string|null $args = '' )
描述
文本大小由“最小”和“最大”参数设置,这些参数将使用CSS文本大小单位的“单位”参数值。 ‘format’参数可以是’flat’(默认值),‘list’或’array’。 ‘format’参数的平坦值将使用空格分隔标记。 ‘format’参数的列表值将格式化UL HTML列表中的标记。 ‘format’参数的数组值将以PHP数组类型格式返回。
参数
$args
(array|string|null)
(Optional)
覆盖默认参数。
返回值
(void|array)
生成的标签云,仅当没有失败时,‘format’参数设置为’array’。否则,此功能输出标签云。
源文件
路径:wp-includes/category-template.php
<?php
...
function wp_tag_cloud( $args = '' ) {
$defaults = array(
'smallest' => 8, 'largest' => 22, 'unit' => 'pt', 'number' => 45,
'format' => 'flat', 'separator' => "n", 'orderby' => 'name', 'order' => 'ASC',
'exclude' => '', 'include' => '', 'link' => 'view', 'taxonomy' => 'post_tag', 'post_type' => '', 'echo' => true,
'show_count' => 0,
);
$args = wp_parse_args( $args, $defaults );
$tags = get_terms( $args['taxonomy'], array_merge( $args, array( 'orderby' => 'count', 'order' => 'DESC' ) ) ); // Always query top tags
if ( empty( $tags ) || is_wp_error( $tags ) )
return;
foreach ( $tags as $key => $tag ) {
if ( 'edit' == $args['link'] )
$link = get_edit_term_link( $tag->term_id, $tag->taxonomy, $args['post_type'] );
else
$link = get_term_link( intval($tag->term_id), $tag->taxonomy );
if ( is_wp_error( $link ) )
return;
$tags[ $key ]->link = $link;
$tags[ $key ]->id = $tag->term_id;
}
$return = wp_generate_tag_cloud( $tags, $args ); // Here's where those top tags get sorted according to $args
/**
* Filters the tag cloud output.
*
* @since 2.3.0
*
* @param string $return HTML output of the tag cloud.
* @param array $args An array of tag cloud arguments.
*/
$return = apply_filters( 'wp_tag_cloud', $return, $args );
if ( 'array' == $args['format'] || empty($args['echo']) )
return $return;
echo $return;
}
...
?>
其他
英文文档:https://developer.wordpress.org/reference/functions/wp_tag_cloud/