Tagcloud Macro

	Name	Size	Creator (Last Modifier)	Creation Date	Last Mod Date	Comment
	tagcloud-1.0.1.jar	5 kB	Chris Cohen	Feb 18, 2007	Feb 18, 2007
	tagcloud-sort.jpg	72 kB	Chris Cohen	Feb 18, 2007	Feb 18, 2007
	tagcloud-nosort.jpg	77 kB	Chris Cohen	Feb 18, 2007	Feb 18, 2007
	tagcloud-1.0.1-jvm1.4.jar	5 kB	Chris Cohen	Jun 19, 2007	Jun 19, 2007	Version for JVM 1.4.2
	tagcloud-1.0.2.jar	6 kB	Ingo Goldbeck	Apr 04, 2007	Apr 04, 2007
	tagcloud-1.0.1-jvm1.4-confluence.jar	5 kB	Ricardo Sueiras	Jun 26, 2007	Jun 26, 2007

Description/Features

Displays a visual representation of the tags (labels) within a space, size representing frequency, and allows the user to click on each to access related pages.

Screenshots

An example of the cloud in action.

The same cloud, but with alphabetical sorting turned on.

Installation

• Download the most recent .jar file. Unless specified, they are compiled for the JVM 5.0 (1.5 - confusing naming scheme!), but there is a special versions for JVM 1.4.2 (see above).
• Go to the plugins section of the administration console and upload the .jar file there.

Parameters

• space - controls which space to get the most popular tags from. If this space does not exist, you will receive an error. If this parameter is left blank, the default is the current space.
• results - the number of results to get, between 1 and 100. The default is 70.
• width - the width of the table that gets generated by the macro. May be an absolute figure or a percentage. Default is automatic width.
• type - may be popular or recent. The default is popular.
• caps - if true, each tag's first letter is capitalized.
• sizing - if false, disables the sizing of tags according to their frequency. The default value is true. Please note that this only affects popular mode. In recent mode, sizing does not work.
• scaling - allows the size difference between largest and smallest tags to be changed. Default value is 1.1. Values less than this will cause the tags to have less size difference, and vice versa. Maximum value is 2.
• sort - you can disable the alphabetical sorting of the tags by setting this to false. This will leave the tags in whichever order they were retrieved (might have unexpected order). Otherwise, it defaults to true.
• title - set this to false if you want to hide the title at the top of the tagcloud. It defaults to true.
• appName (since version 1.0.2) - set the name of your wiki-application (e.g. "wiki" or "confluence") to get the correct links behind the tags rendered.

Examples

{tagcloud}

{tagcloud:space=foo|results=60}

{tagcloud|results=50|caps=true|scaling=0.8|sort=false|title=false}

Appearance and styling

If you are familiar with CSS2 (cascading style sheets) you can style the cloud and its box the way you want it, by adding a definition for the .tagcloud class above the tagcloud itself on the page. Example:

{style}
.tagcloud {
  border:1px solid #00498f;
  background-color:#e0e0ff;
}
.tagcloud a, .tagcloud a:link, .tagcloud a:visited {
  text-decoration:none;
}
.tagcloud a:hover {
  color:#990000;
}
{style}

Version History

Useful Links

• Atlassian forum thread about the Confluence elements that provide the heatmap functionality