Extension:WikiCategoryTagCloud
From MediaWiki.org
 Release status: beta |
|||
|---|---|---|---|
| Implementation | Tag | ||
| Description | Greatly improved fork of Extension:YetAnotherTagCloud | ||
| Author(s) | Daniel Friesen | ||
| Last Version | 1.0.1 (July 2, 2009) | ||
| License | GPL v2+ | ||
| Download | Download snapshot |
||
|
|||
|
check usage (experimental) |
|||
WikiCategoryTagCloud extension is a fork of YetAnotherTagCloud extension, featuring many bugfixes and improved functionality.
[edit] Improvements
- The original YATC extension had some odd use of LOWER() inside the SQL queries (I have no clue why the creators did something like that) and it basically ended up breaking any category which had an uppercase letter anywhere other than the first letter. Not only that but the links showed up with ugly underscores. So we fixed it so that links always work, and normal styled space links with normal capitalization are displayed.
- The original extension only let you tweak background, border, and link colors. And there was no class. Not only that but those hard coded styles didn't work right on some skins with a right sidebar (it overflowed over the right) and you couldn't fix it. We've removed those old bits, and added actual parameters to the tag cloud (like a HTML tag uses) to add extra classes and style it. All tag clouds have a default tagcloud class so the normal styles can be kept through some CSS in MediaWiki:Common.css.
- On the original extension you needed to specify pages to invalidate cache for in an array in the code. Which meant adding a tag cloud on the wiki required source modifications. Not a good idea... So we tweaked the function to allow for the titles of articles to be specified in MediaWiki:Tagcloudpages (one per line).
[edit] 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>
[edit] 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).
