Search
  • Sotware by
  • Christoph Amthor
Search Menu

Tag Cloud Shortcodes

Return to the plugin main page.

Note: Parameters below are displayed with formatting. When you copy & paste them into your editor, make sure that no formatting is copied over and that double quotes (“) don’t appear formatted (curly or titled). It is recommended to switch the editor from “Visual” to “Text” before pasting and to re-type all quotes.

The plugin comes with a widget for each type of tag cloud. You can also insert one of the shortcodes below in a page or post. The parameters for the widgets and the shortcodes are the same. Only “div_id” is not available in the widgets.

Spiral Tag Cloud

Note

Due to the way how the plugin determines the remaining space, the tag cloud always starts with the largest tags (i.e. descending order by post count). The tags on the right side or often cut.

Finding the right values depends on many factors, such as post count, the difference between popular and average or unpopular tags, the amount of tags for each group of tags according to their post counts and the like. It will often be necessary that you fine-tune the available parameters manually until you achieve the desired result.

Format

[cm_spiral_tag_cloud]

Example

[cm_spiral_tag_cloud number=40 separator="|" taxonomy="post_tag,product_tag"]

Parameters

  • div_id: ID of the enclosing div for custom styling. By default empty.
  • taxonomy: Comma-separated list of taxonomy to use. Default is “post_tag”.
  • number: Maximum number of tags to display. Default is 40. The number is also limited by how many tags fit into the coil.
  • width: Width of the container. Default is 100%. Enter the number with the unit sign, such as px or %.
  • height: Height of the container. Default is 500px. Enter the number with the unit sign, such as px or %.
  • margin_left: Margin left of each tag and separator. Default is 5. The unit defaults to px.
  • font_size_factor: Magnification factor of the font. Good values are 1 – 5. Default is 1.
  • line_height_factor : Distance between cycles (rounds). Good values are 0.8 – 1.5. Default is 1.
  • reduce_factor : How much the spiral should become tighter towards the center. Good values are 1 – 10. Default is 1.
  • direction: CW (clockwise) or CCW (counterclockwise). The default is CCW.
  • start: Where the largest tag will start. Values can be “top”, “bottom”, “left”, “right” or a number from 0 to 2π (π is about 3.1415). Default is “top”.
  • cycles: Number of cycles (round). This parameter is only approximate, since the available space and the font size may allow only less cycles. The default is “auto”, meaning that the plugin tries to guess a good value in order to fit all words. You can also use “size” to try to fit it by the available space. Or try a number – good values are 4 – 10.
  • custom_title: Custom title shown as tooltip when hovering the mouse over a tag. No HTML, but you can use {count} and {description} as placeholders. Example: “This tag was used {count} times.”. Default: empty (using description and tag count)
  • color: Whether to use color (=1) or not (=0, default) for different post counts. The colors are set in a style sheet (CSS) by the classes .cm-tag-cloud-color-1, .cm-tag-cloud-color-2, and so on. The numbers correspond to the sequential order of the groups of tags with the same post count. The plugin comes with a sample set of colors. Find more details here.

 

Wave Tag Cloud

Note

Due to the way how the plugin determines the remaining space, the tag cloud always starts with the largest tags (i.e. descending order by post count). The tags on the right side or often cut.

Format

[cm_wave_tag_cloud]

Example

[cm_wave_tag_cloud font_size_factor=2 number=40 waves=5]

Parameters

  • div_id: ID of the enclosing div for custom styling. By default empty.
  • taxonomy: Comma-separated list of taxonomy to use. Default is “post_tag”.
  • number: Maximum number of tags to display. Default is 40. The number is also limited by how many tags fit into the coil.
  • width: Width of the container. Default is 100%. Enter the number with the unit sign, such as px or %.
  • height: Height of the container. Default is 500px. Enter the number with the unit sign, such as px or %.
  • margin_left: Margin left of each tag and separator. Default is 5. The unit defaults to px.
  • separator: Optional separator between the tags. Default is empty.
  • waves: Number of waves above each other. Each waves begins with the largest tags on the left. Default is 3.
  • tags: Maximum number of tags per wave. The default is “auto”, meaning that the plugin tries to remove tags at the end that would “fall off” the wave or be truncated.
  • frequency: The frequency determines who tight the waves are bent. Default is 10.
  • change_wavelength: This factor changes the frequency towards the smaller tags. 1 mean no change, a factor like 1.2 slightly increases the frequency. Default is 1.
  • opacity_decay: Determines a reduction of the opacity value, that means that smaller tags become more transparent. Default is 0.8.
  • line_height_factor : Distance between cycles (rounds). Good values are 0.8 – 1.5. Default is 1.
  • left_right_mode: Where to place vertical slices. Possible values are: “left”, “right”, “alternating”, “random”. Default is “alternating”.
  • font_size_factor: Magnification factor of the font. Good values are 1 – 5. Default is 2.
  • custom_title: Custom title shown as tooltip when hovering the mouse over a tag. No HTML, but you can use {count} and {description} as placeholders. Example: “This tag was used {count} times.”. Default: empty (using description and tag count)
  • color: Whether to use color (=1) or not (=0, default) for different post counts. The colors are set in a style sheet (CSS) by the classes .cm-tag-cloud-color-1, .cm-tag-cloud-color-2, and so on. The numbers correspond to the sequential order of the groups of tags with the same post count. The plugin comes with a sample set of colors. Find more details here.
Share