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

Filters the tag cloud output.

Contents

Parameters
Source
Related
- Used By
Changelog
User Contributed Notes
- Feedback

Parameters

$return string|string[]

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

$args array

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

File: wp-includes/category-template.php. View all references

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

View on Trac View on GitHub

Used By

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

Changelog

Changelog
Version	Description
2.3.0	Introduced.

User Contributed Notes

Skip to note 1 content

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

Contributed by tarhe — 3 years ago
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 2 content

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

Contributed by buddhabackpacker — 8 months ago

This “filter” only returns the HTML after generated. There is no longer a filter for the args before generating.
Top ↑
Feedback
- 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. — By Jb Audras — 8 months ago
Log in to add feedback

You must log in before being able to contribute a note or feedback.