Extension:SelectCategoryTagCloud

The SelectCategoryTagCloud extension provides five functions:
 * It shows a tag cloud of all categories (unless limited by minimum count or by a custom root category)
 * It strips all categories linked within a page upon editing and inserts them in a category input box.
 * It adds categories selected from the tag cloud to the input box and removes them if already there.
 * It suggests existing categories that match the user input in the input box from the database via AJAX
 * It saves the categories from the input box to the text body of the page on saving.

RELATED EXTENSIONS
Please see the below pages for further documentation:
 * See SelectCategory extension
 * See YetAnotherTagCloud extension
 * See Wiki Category Tag Cloud extension (this site is intended to be replaced with a Forge site, but this was provided by Google Cache)

Installation
Copy the SelectCategoryTagCloud directory into the extensions folder of your MediaWiki installation. Then add the following line to your LocalSettings.php file (near the end):

require_once( 'extensions/SelectCategoryTagCloud/SelectCategoryTagCloud.php' );

Tag Cloud Parameters
Parameters for the tag cloud are configured at the top of SelectCategoryTagCloudFunctions.php. (These are going to be moved to LocalSettings.php in a future release.)

AJAX Server Page
Configure database credentials at the top of SelectCategoryTagCloudSuggest.php If you are using a database prefix (e.g. MW_ or similar) then you need to amend the SQL command in this file. Prepend the prefix to categorylinks (e.g. MW_categorylinks).

$wgSelectCategoryNamespaces
This is in the SelectCategoryTagCloud.php file

Defines in which namespaces the Extension should be active.

All namespaces are already predefined in the array. Set a specific namespace to true to enable or to false to disable the extension.

Active per default are: Media, Main, Project, Image, Help, Category.


 * Example:


 * Or:

$wgSelectCategoryRoot
Set a specific root category depending the namespace. Only categories within this root will be displayed when editing a page in a certain namespace.

Useful on big wiki sites to keep the database load down.

If not set (default) the extension searches for all root categories and displays them including all children.

$wgSelectCategoryEnableSubpages
Defines if the extension should be active when editing subpages.

To Do

 * Move SelectCategoryTagCloudSuggest.php configuration for database access into Mediawiki framework to simplify configuration
 * Move configuration of tag cloud parameters from SelectCategoryTagCloudFunctions.php into LocalSettings.php
 * Test i18n features

Bugs
No known bugs at the moment. Lindele 11:23, 22 August 2007 (UTC)

Document issues on http://www.mediawiki.org/wiki/Extension_talk:SelectCategoryTagCloud. Alternatively, you can reach me at - Andreas Rindler:

Previous concerns not validated yet:


 * I cannot add an article to a new (not existing) category by adding it in the wiki way (I mean by adding at the end of an article)
 * Adding a new category while editing a single section leads to an entry at the end of the edited section, not at the end of the page. --WIKImaniac 11:57, 6 July 2007 (UTC)
 * Placing two or more categories on the same line results in only the last category being read.   Only Cat2 shows up as selected in the list. --PaulHat 22:57, 12 July 2007 (UTC)
 * Categories placed in between "pre" and "includeonly" tags should be ignored. --Paul 16:52, 20 August 2007 (UTC)

Feature Requests

 * It would be nice to incorporate the creation of additional categories into this extension. --Oreo masta 17:40, 12 February 2007 (UTC) - Completed, Lindele 11:23, 22 August 2007 (UTC)
 * The UI makes it too easy to erase all your carefully assigned categories from a page. One accidental mouseclick (on the category list) will deselect all the categories on a page. I suggest you make the category list read-only, and add a dropdown with buttons to "add category" and "remove category" through JavaScript. Also add a "Revert" button to go back to the original saved set of categories. Otherwise this extension is too dangerous to existing categories on a page. - Obsolete, Lindele 11:23, 22 August 2007 (UTC)
 * I recommend an additional text field for each entry of the category list. There you could type an alternative text, which will be used to modify the displayed order of the articles in a category, e.g.  , cf. w:Wikipedia:Categorization. --WIKImaniac 19:12, 11 July 2007 (UTC)
 * Would be nice if we could use SelectCategory with the SemanticForms extension (The Category select box apear in Spezial:EditData).