Extension:WikiCategoryTagCloud

MediaWiki extensions manual - list

WikiCategoryTagCloud Release status: stable
Implementation	Tag, Skin
Description	Allows to add tag clouds based on categories to a page
Author(s)	Daniel Friesen (Dantmantalk)
Last version	1.1 (July 11, 2012)
MediaWiki	1.17+
Database changes	no
License	GPL v2+
Download	Download snapshot (Git master) Git [?]: repo summary tree code changes
Tags <tagcloud>
Hooks used ParserFirstCallInit ArticleSave
Check usage and version matrix

The WikiCategoryTagCloud extension allows to add tag clouds based on categories to a page.

Usage

These in text parameters from the original extension still work the same:

min_count

Only display a tag for the category that contain at least min_count articles. Default value : 0.

min_size

Defines the minimum text size. (Default: 77).

increase_factor

Defines the factor to increase the text size by the number of articles. Default value : 100.

exclude

Defined the categories you do not want to be displayed. Use comma to separate the categories, like this:

<tagcloud>exclude=television,celebrities,food,yoga</tagcloud>

makes "television", "celebrities", "food" and "yoga" categories not to show up in the categories cloud.

The coloring in text parameters do not work anymore, instead we have XML parameters:

class

Adds CSS classes to the tag cloud itself (The tagcloud class is always included).

style

Adds CSS styles to the style parameter of the tag cloud.

linkclass

Adds CSS classes to the links.

linkstyle

Adds CSS styles to the links' style parameters.

in text parameters are place in between the two tags, and XML parameters are done inside the opening tag. Here's an example use showing where things are placed.

<tagcloud style="background: black;">
min_size=55
exclude=browse
</tagcloud>

Installation

Download the extension into extensions/WikiCategoryTagCloud/WikiCategoryTagCloud.php and include the following line into your LocalSettings.php:

require_once("$IP/extensions/WikiCategoryTagCloud/WikiCategoryTagCloud.php"); // Wiki Category Tag Cloud extension

You should include this code into your MediaWiki:Common.css to get the default styles. After that you can freely tweak it:

.tagcloud {
        width: 98%;
        text-align: center;
        background-color: #FDFDFD;
        border: 1px solid #EEEEEE;
        padding: 15px 10px 15px 10px;
}
.tagcloud a {
        color: #0052CB;
        margin-left: 10px;
        margin-right: 10px;
        font-weight: bold;
}

Finally, add the pages to invalidate the cache for to MediaWiki:Tagcloudpages (one title per line).