Tag cloud

    • No status information
< Manual:Extension

About the tag cloud

The tag cloud extension BlueSpiceTagCloud visualizes terms from your wiki based on importance. It can be included on any wiki page. The source for the tag cloud terms can be categories or search terms.

Tagcloud example

Inserting a tag cloud

A tag cloud can be inserted directly in source editing mode with the tag <bs:tagcloud />. To insert a tag cloud with VisualEditor, select Insert > Magic word > Tag cloud.

Inserting a tag cloud with VisualEditor

Configuration

If tag is added using VisualEditor, a configuration dialog appears. It shows configuration options in two tabs: Common and Advanced.

tag cloud example

Common configuration

Parameter Display name Description
renderer Type Mode of rendering the cloud
  • List
  • Text (font size depends on frequency)
  • 3D: rotating, ineractive view
width Width Percent of the page width taken by the cloud
showcount Show count Whether to show numeric frequency of the term in the cloud

Advanced configuration

Parameter Display name Description
store Store Source of the data - category or search terms
minsize Min font size Smallest possible font displayed in the cloud
maxsize Max font size Biggest possible font displayed in the cloud
exclude Exclude pages List of categories to exclude from the cloud, separated by comma - "category1, category2, category3"

Examples

Text

Tag parameters:

<bs:tagcloud count="10" minsize="12" maxsize="34" exclude="Imported vocabulary, Project" />

Output:

Shows a tag cloud with the 10 (count) categories that have the most page associations. The smallest possible font-size is 12 pixels (minsize) and the largest possible font-size is 34 pixels (maxsize). The categories Imported vocabulary and Project have been excluded from the output.Since the data source category is the default for a tag cloud, it is not necessary to specify it in the tag.

Tag cloud example type text with excluded categoriee

3D canvas

Tag parameters:

<bs:tagcloud renderer="canvas3d" store="category" count="15" minsize="12" maxsize="40" showcount="false" float="right" />

Output:

The renderer canvas3d produces an interactive tag cloud. The cloud rotates when the cursor hovers over the tag cloud. It shows the 15 (count) most tagged categories. It is important to set the count limit, since the default count is set to 40, wich produces a 3D cloud where the results are hard to distinguish visually. The data source is set to category (store). This is optional, since category is the default store value. The font sizes range from 12 pixels (minsize) to 40 pixels (maxsize). How many pages and files are associated with each category is not shown (showcount="false").

Tag cloud example type 3D without counter

The tag cloud of type canvas3d ignores the following parameters: width, float.

List

Tag parameters:

<bs:tagcloud renderer="list" store="searchstats" count="5" />

Output:

The renderer type list produces a simple unordered list.

tag cloud with search stats type list


The tag cloud of type list ignores the following parameters: width, float, minsize, maxsize, exclude.


A complete list of parameters and their values can be found at Reference:BlueSpiceTagCloud.

Attachments

Discussions