wp_tag_cloud()

显示标签云。

原型

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/