wp_tag_cloud – Hook | Developer.WordPress.org

Filters the tag cloud output.

Parameters

$returnstring|string[]

Tag cloud as a string or an array, depending on 'format' argument.

$argsarray

An array of tag cloud arguments. See wp_tag_cloud() for information on accepted arguments.

More Arguments from wp_tag_cloud( … $args )

Array or string of arguments for generating a tag cloud.

smallest int
Smallest font size used to display tags. Paired with the value of $unit, to determine CSS text size unit. Default 8 (pt).
largest int
Largest font size used to display tags. Paired with the value of $unit, to determine CSS text size unit. Default 22 (pt).
unit string
CSS text size unit to use with the $smallest and $largest values. Accepts any valid CSS text size unit. Default 'pt'.
number int
The number of tags to return. Accepts any positive integer or zero to return all.
Default 0.
format string
Format to display the tag cloud in. Accepts 'flat' (tags separated with spaces), 'list' (tags displayed in an unordered list), or 'array' (returns an array).
Default 'flat'.
separator string
HTML or text to separate the tags. Default "n" (newline).
orderby string
Value to order tags by. Accepts 'name' or 'count'.
Default 'name'. The 'tag_cloud_sort' filter can also affect how tags are sorted.
order string
How to order the tags. Accepts 'ASC' (ascending), 'DESC' (descending), or 'RAND' (random). Default 'ASC'.
filter int|bool
Whether to enable filtering of the final output via 'wp_generate_tag_cloud'. Default 1.
topic_count_text array
Nooped plural text from _n_noop() to supply to tag counts. Default null.
topic_count_text_callback callable
Callback used to generate nooped plural text for tag counts based on the count. Default null.
topic_count_scale_callback callable
Callback used to determine the tag count scaling value. Default default_topic_count_scale() .
show_count bool|int
Whether to display the tag counts. Default 0. Accepts 0, 1, or their bool equivalents.

Source

$return = apply_filters( 'wp_tag_cloud', $return, $args );

View all references View on Trac View on GitHub

Used by	Description
wp_tag_cloud()`wp-includes/category-template.php`	Displays a tag cloud.

Changelog

Version	Description
2.3.0	Introduced.

User Contributed Notes

Skip to note 3 content

tarhe 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Basic Example
Adds rel="nofollow" to all the tag cloud links.
```
add_filter( 'wp_tag_cloud', 'wpdocs_no_follow_tag_cloud_links' );
function wpdocs_no_follow_tag_cloud_links( $return ) {
	$return = str_replace('<a ', '<a rel="nofollow" ', $return );
	return $return;
}
```
Log in to add feedback
Skip to note 4 content

buddhabackpacker 3 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

This “filter” only returns the HTML after generated. There is no longer a filter for the args before generating.
- That’s precisely what’s implied in the description of the filter: “Filters the tag cloud output“. It filters the HTML output, not the arguments.
  
  Jb Audras 3 years ago
Log in to add feedback

apply_filters( ‘wp_tag_cloud’, string|string[] $return, array $args )

In this article

Parameters

Source

Changelog

User Contributed Notes

apply_filters( ‘wp_tag_cloud’, string|string[] $return, array $args )

In this article

Parameters

Source

Related

Changelog

User Contributed Notes