Search
  • Sotware by
  • Christoph Amthor
Search Menu

Tag Cloud Documentation

Return to the plugin main page.

Note: In the following documentation the word “tag” stands for any kind of WordPress term, including custom taxonomies such as WooCommerce Product Tags.

Installation and Updating

Since the Chatty Mango Tag Cloud plugin is not hosted in the WordPress repository, it needs to be installed and updated manually. For the following steps you need to be logged in as administrator (or network administrator). It is recommended to make a database update before updating.

Installation Procedure

  1. Go to the menu Plugins → Add New.
  2. Click on the button “Upload Plugin”.
  3. Click “Browse” and select the file chatty-mango-tag-cloud.zip. Make sure that you upload the right file – it might be inside another ZIP file that you received.
  4. Click “Install Now”.
  5. Activate the plugin directly there or, on a network installation, on the site where you want to use it.

Updating Procedure

  1. Go to the menu Plugins → Installed Plugins.
  2. Find the Chatty Mango Tag Cloud plugin and click on “Deactivate”.
  3. Under the Chatty Mango Tag Cloud plugin click “Delete”.
  4. Install the new version of Chatty Mango Tag Cloud as described above.

Network Installation

The plugin works well on sites with a “multisite installation”.

Settings

The settings page contains some information about the plugin and shortcode parameters. Here you can also check if an update is available.

Shortcodes and Widgets

Screenshot of WidgetInsert the tag clouds with a shortcode or a widget. The output of shortcodes and widgets is exactly the same. The main difference is that widgets are easier to configure – you just fill in the fields of and press “Save”. Widgets, however, can only be used in widget areas that are pre-defined by your theme or by special plugins. Shortcodes can be used in pages, posts, and often also in text widgets.

Widgets

You find the widgets under Appearance → Widgets as “Chatty Mango Spiral Cloud” and “Chatty Mango Wave Cloud”. The parameters are the same as described for the shortcodes.

Shortcodes

Shortcodes are something like placeholders. You add them into the text of a post or page and they will be replaced in the output with something different, depending on the code you use. Shortcodes are enclosed by square bracket and they start with a shortcode’s specific name, followed by optional parameters. Parameters can be numbers or words, and they look like size=12, button=large or title=”Hello there!” (Enclosed in single or double quotes because otherwise the space and everything following would not be included.).

This plugin comes with two shortcodes. One of them produces the spiral tag cloud, the second one the wave tag cloud:

%MINIFYHTMLf3666135cd9d804359e01ab3dbda656f9%
%MINIFYHTMLf3666135cd9d804359e01ab3dbda656f10%

See the detailed description of the shortcodes.

Customizing the Color Scheme

Customizing the color scheme requires basic CSS knowledge and file access to the server.

The easiest way how to choose your own sets of colors is to create a folder “chatty-mango” inside your blog’s “wp-content/uploads/” folder (if it doesn’t already exist) and copy there the file “chatty-mango-tag-cloud-color.css” that you find in the folder “/public/css/” of this plugin. Now go to this new file at “wp-content/uploads/chatty-mango/chatty-mango-tag-cloud-color.css” and edit it with a text editor that doesn’t add any formatting.

The text is rendered as SVG text (or tspan) elements. That means that many forms of styling are applicable, but not all. If you want to change a color, simply edit the value after “fill: “.

The class names are numbered in the sequence of tag sizes, from largest to smallest. For example, the tags that is used with 20 posts has the index 1, the second popular tag, which is used for 15 posts, has the index 2, and so on. That way, there are no gaps in the sequence.

Example:

.cm-tag-cloud-color-1 {
 fill: #dc6900;
 transition:0.5s;
}
.cm-tag-cloud-color-2 {
 fill: #eb8c00;
 transition:0.5s;
}

and so on.

 

Troubleshooting

1. The tag spiral is too short

  • Make sure that you have enough tags in the chosen taxonomy, and that they are actually used for posts that are published.
  • Try a lower value for the “Font Size Factor” and increase the number of “Cycles”.
  • Try to increase “Width” and “Height”. If necessary, move the widget or shortcode somewhere where is more space.

2. The tag spiral is huge and there are only tags along the perimeter

  • Try a smaller value for “Cycles”.

3. Waves or rounds of the coil are touching

  • Increase the value for “Line Height Factor” or “Reduce Factor”.

4. The word in the center or on the right are cut off

  • You can – in the case of the waves – increase the “Opacity Decay” factor to let the last tags be less dominant or – in the case of the spiral – widen it by choosing a higher value for “Cycles” or lower the “Number”, so that the chain of tags finishes earlier.

5. The tag cloud is cut off at one edge

  • Choose a larger size or make the cloud smaller with less cycles and words or with less waves and tags, or choose a smaller “Font Size Factor”.

 

Share