Extension:WikiCategoryTagCloud

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual
Crystal Clear action run.png
WikiCategoryTagCloud

Release status: stable

Implementation Tag, Skin
Description Allows to add tag clouds based on categories to a page
Author(s) Daniel Friesen (Dantmantalk)
Latest version 1.1 (2012-11-07)
MediaWiki 1.17+
PHP 5.3+
Database changes No
License GPL v2+
Download
Tags
<tagcloud>
Hooks used
ParserFirstCallInit

ArticleSave

Translate the WikiCategoryTagCloud extension if it is available at translatewiki.net

Check usage and version matrix; code metrics

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

Usage[edit | edit source]

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 underscore instead of spaces in category names, use comma to separate the categories, like this:
<tagcloud>exclude=television,television_series,celebrities,food,yoga</tagcloud>

makes "television", "television series", "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[edit | edit source]

  • Download and extract the file(s) in a directory called WikiCategoryTagCloud in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
require_once "$IP/extensions/WikiCategoryTagCloud/WikiCategoryTagCloud.php";
  • 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).
  • Done! Navigate to "Special:Version" on your wiki to verify that the extension is successfully installed.