Repository navigation
Function PHP st_tag_cloud
Amaury Balmer edited this page Jun 10, 2017
·
2 revisions
With this functionality you can show a color tags cloud created dynamically. If you don't want to show it, but use it, use st_get_tag_cloud() function.
Introduction
<?php st_tag_cloud(); ?>
'size' => 'true',
'smallest' => 8,
'largest' => 22,
'unit' => 'pt',
'color' => 'true',
'maxcolor' => '#000000',
'mincolor' => '#CCCCCC',
'number' => 45,
'format' => 'flat',
'cloud_selection' => 'count-desc',
'cloud_sort' => 'random',
'exclude' => '',
'include' => '',
'limit_days' => 0,
'min_usage' => 0,
'notagstext' => __('No tags.', 'simpletags'),
'xformat' => __('<a href="%tag_link%" class="tag-link-%tag_id%" title="%tag_count% topics" %tag_rel% style="%tag_size% %tag_color%">%tag_name%</a>', 'simpletags'),
'title' => __('<h4>Tag Cloud</h4>', 'simpletags'),
'category' => 0,
'taxonomy' => 'post_tag
We wish to display randomly the top 100 tags, the max width will be 45px, the min 12px. The color used for max tags will be red (#FF0000) and for min tags green (#00FF0B). At last, the title will be "Tags Cloud"
<?php st_tag_cloud('cloud_selection=count-desc&cloud_sort=random&number=100&title=Mon nuage de tags&largest=45&smallest=12&unit=px&maxcolor=#FF0000&mincolor=#00FF0B'); ?>
- size
- (boolean) Active or not dynamic font size generation
- smallest
- (integer) Length of the font to use to show the less used tags
- largest
- (integer) Length of the font to use to show the most used tags
- unit
- (string) Measuring unit of the used font for smallest and largest parameters. Use pt for point
- color
- (boolean) Active or not dynamic color generation. true/false
- maxcolor
- (string) Used color for most popular tags
- mincolor
- (string) Used color for less popular tags
- number
- (integer) Number of tags to show inside the tags cloud (Use '0' to show all of them)
- format
- (string) Tag's format of posting
- flat - (Default) Tags are separated by spaces
- list - tags are inside a non ordered list (UL) containing class='st-tag-cloud'
- array - tags are inside a PHP array (use it with st_get_tag_cloud())
- (string) Tag's format of posting
- cloud_selection
- (string) Tags selection order. Valid values are :
- count-desc - (default) by number of usage tags (most popular)
- count-asc - by number of usage tags (least used)
- name-asc - by tag name ascending
- name-desc - by tag name descending
- random - random
- (string) Tags selection order. Valid values are :
- cloud_sort
- (string) Tags selection order. Valid values are :
- count-desc - by number of usage tags (most popular)
- count-asc - by number of usage tags (least used)
- name-asc - by tag name ascending
- name-desc - by tag name descending
- random - (default) random
- (string) Tags selection order. Valid values are :
- exclude
- (string) list of tags to exclude, separated by commas (term_id). For example 'exclude=5,27' means all tags which contain term_id 5 or 27 will be NOT shown. By default, any tag is excluded.
- include
- (string) list of tags to include, separated by commas (term_id). For example 'exclude=5,27' means all tags which contain term_id 5 or 27 will be the alone tags to be shown. By default, all tags are included
- limit_days
- (integer) Number of days to be considered to generated tag cloud.
- min_usage
- (integer) Min number of tag counter for display it into tag cloud
- notagstext
- (string) Text to show, if there is no tag.
- xformat
- (string) Extended format of links. You can personalize the formating of tag's link. Available markups :
- tag_link - Replaced by the permalink of the tag
- tag_feed - Replaced by the RSS tag link
- tag_id - Replaced by the tag ID
- tag_count - Replaced by the use number (counter) of the tag
- tag_size - Replaced by the size of the tag (creates : font-size:17pt;)
- tag_color - Replaced by the color of the tag (creates : color:#666666;)
- tag_name - Replaced by the tag's name
- tag_name_attribute - Replaced by the tag's name, formatted for attribute HTML
- tag_rel - Replaced by rel tag markup (creates : rel="tag")
- tag_scale - Replaced by tag scale (between 1 and 10)
- tag_technorati - Replaced by Technorati tag link
- tag_flickr - Replaced by Flickr tag link
- tag_delicious - Replaced by Del.ici.ous tag link
- (string) Extended format of links. You can personalize the formating of tag's link. Available markups :
- title
- (string) Specify the positioned title shown before tags cloud
- category
- (string) Restrict tag cloud to a specific category. (or more, separated with comma)
- taxonomy
- (string) Select taxonomy to used for tag cloud