wp_tag_cloud( array|string $args = '' ): void|string|string[]

716function wp_tag_cloud( $args = '' ) {717	$defaults = array(718		'smallest'   => 8,719		'largest'    => 22,720		'unit'       => 'pt',721		'number'     => 45,722		'format'     => 'flat',723		'separator'  => "\n",724		'orderby'    => 'name',725		'order'      => 'ASC',726		'exclude'    => '',727		'include'    => '',728		'link'       => 'view',729		'taxonomy'   => 'post_tag',730		'post_type'  => '',731		'echo'       => true,732		'show_count' => 0,733	);734 735	$args = wp_parse_args( $args, $defaults );736 737	$tags = get_terms(738		array_merge(739			$args,740			array(741				'orderby' => 'count',742				'order'   => 'DESC',743			)744		)745	); // Always query top tags.746 747	if ( empty( $tags ) || is_wp_error( $tags ) ) {748		return;749	}750 751	foreach ( $tags as $key => $tag ) {752		if ( 'edit' === $args['link'] ) {753			$link = get_edit_term_link( $tag, $tag->taxonomy, $args['post_type'] );754		} else {755			$link = get_term_link( $tag, $tag->taxonomy );756		}757 758		if ( is_wp_error( $link ) ) {759			return;760		}761 762		$tags[ $key ]->link = $link;763		$tags[ $key ]->id   = $tag->term_id;764	}765 766	// Here's where those top tags get sorted according to $args.767	$return = wp_generate_tag_cloud( $tags, $args );768 769	/**770	 * Filters the tag cloud output.771	 *772	 * @since 2.3.0773	 *774	 * @param string|string[] $return Tag cloud as a string or an array, depending on 'format' argument.775	 * @param array           $args   An array of tag cloud arguments. See wp_tag_cloud()776	 *                                for information on accepted arguments.777	 */778	$return = apply_filters( 'wp_tag_cloud', $return, $args );779 780	if ( 'array' === $args['format'] || empty( $args['echo'] ) ) {781		return $return;782	}783 784	echo $return;785}