apply_filters( 'widget_tag_cloud_args', array $args , array $instance )
Filters the taxonomy used in the Tag Cloud widget.
Contents
Description
See also
Parameters
-
$args
array -
Args used for the tag cloud widget.
-
$instance
array -
Array of settings for the current widget.
More Information
By default, the following parameters are available to $args:
- smallest – The smallest tag (lowest count) is shown at size 8
- largest – The largest tag (highest count) is shown at size 22
- unit – Describes ‘pt’ (point) as the font-size unit for the smallest and largest values
- number – Displays at most 45 tags
- format – Displays the tags in flat (separated by whitespace) style
- separator – Displays whitespace between tags
- orderby – Order the tags by name
- order – Sort the tags in ASCENDING fashion
- exclude – Exclude no tags
- include – Include all tags
- link – view
- taxonomy – Use post tags for basis of cloud
- echo – echo the results
Source
File: wp-includes/widgets/class-wp-widget-tag-cloud.php
.
View all references
apply_filters(
'widget_tag_cloud_args',
array(
'taxonomy' => $current_taxonomy,
'echo' => false,
'show_count' => $show_count,
),
$instance
)
Changelog
Version | Description |
---|---|
4.9.0 | Added the $instance parameter. |
3.0.0 | Added taxonomy drop-down. |
2.8.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
It appears this filter does not even run when using a Gutenburg tag cloud anymore.
Modifies tag cloud widget arguments to display all tags in the same font size and use list format for better accessibility.
Example Migrated from Codex:
Include specific tag IDs in tag cloud widget.