Extension:SelectCategory



The SelectCategory extension provides three functions:
 * It shows a list of all categories (unless a custom root category is configured) in their hierarchical structure on the edit page.
 * It strips all categories linked within a page upon editing and selects them in the category list list.
 * It adds selected categories from the list to the text body of the page on saving.

Stable release (recommended for most uses)
To use the stable release, download the tarball linked in the box on the right, and uncompress it. Copy the SelectCategory directory into the extensions folder of your MediaWiki installation. Then add the following lines to your LocalSettings.php file (near the end):

Download from SVN trunk
To use the current SVN version, which might be unstable and full of bugs, use the following URL for your subversion client: http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/SelectCategory

$wgSelectCategoryNamespaces
This is in your SelectCategory.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.

Style
To customize the design of the select box use the CSS id "SelectCategoryBox" and attach your own settings to MediaWiki:Monobook.css or your users User:USERNAME/Monobook.css.

Bugs & Hotfixes
# The normal query to get all children of a given root category: +	$m_root = str_replace("'","\'",$m_root); $m_sql = "	SELECT tmpSelectCatPage.page_title AS title			FROM $m_tblCatLink AS tmpSelectCat 			LEFT JOIN $m_tblPage AS tmpSelectCatPage ON tmpSelectCat.cl_from = tmpSelectCatPage.page_id 			WHERE tmpSelectCat.cl_to LIKE '$m_root' AND tmpSelectCatPage.page_namespace = 14";
 * if a category name has an apostrophe in it, a mysql error occurs in the fnSelectCategoryGetChildren function add marked ("+") line before the sql query to fix the problem (revision 29737 still contains this bug):

Warning: Call-time pass-by-reference has been deprecated; If you would like to pass it by reference, modify the declaration of [runtime function name]. If you would like to enable call-time pass-by-reference, you can set allow_call_time_pass_reference to true in your INI file in .../extensions/SelectCategory/SelectCategoryFunctions.php on line 21 Warning: Call-time pass-by-reference has been deprecated; If you would like to pass it by reference, modify the declaration of [runtime function name]. If you would like to enable call-time pass-by-reference, you can set allow_call_time_pass_reference to true in your INI file in .../wiki/extensions/SelectCategory/SelectCategoryFunctions.php on line 84
 * following warning "Warning: Call-time pass-by-reference"...
 * ...can be fixed by following changes in fnSelectCategoryShowHook...

function fnSelectCategoryShowHook( $m_isUpload = false, &$m_pageObj ) {

# check if we should do anything or sleep -	if ( fnSelectCategoryCheckConditions( $m_isUpload, &$m_pageObj ) ) { +	if ( fnSelectCategoryCheckConditions( $m_isUpload, $m_pageObj ) ) {
 * ...and fnSelectCategorySaveHook...

function fnSelectCategorySaveHook( $m_isUpload, &$m_pageObj ) { global $wgContLang; global $wgTitle;

# check if we should do anything or sleep -	if ( fnSelectCategoryCheckConditions( $m_isUpload, &$m_pageObj ) ) { +	if ( fnSelectCategoryCheckConditions( $m_isUpload, $m_pageObj ) ) {


 * Dont combine SelectCategory with the extension "RequireCategory" ... it doesnt work! --Nyks 01:16, 21 December 2006 (UTC)


 * I am running 1.9. when I install this extension I just get a blank page when editing. -- Magick 10:46, 12 January 2007 (UTC)
 * I get the same error have had to disable --Markw21 17:08, 19 September 2007 (UTC)
 * This error still happens occasionally on 1.10 and 1.11, I've not been able to find a common cause for it. It seems to run fine for weeks, then when server load increases, it just dies.  optimize your categorylinks table, and things improve quickly. -- Shannon Lowder 20070921
 * I also found that if you have recursive categories (a parent with a child that shows the parent as ITS child) will cause this issue. Run a query on your categorylinks table, look for this, and remove instances of it, it clears the problem easily!-- Shannon Lowder 20071129
 * It doesn't detect cycles in the category graph, so editing just seems to hang if it hits one. -Steve Sanbeg 19:16, 19 January 2007 (UTC)
 * I get a blank page by loading the same page twice, and only with Firefox, not with Internet Explorer. --WIKImaniac 14:48, 14 January 2008 (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) still in revision 29737
 * Fixed this, see SelectCategoryTagCloud --Kaspera 14:32, 10 December 2007 (UTC)


 * Categories placed in between "pre" and "includeonly" tags should be ignored. --Paul 16:52, 20 August 2007 (UTC) still in revision 29737
 * Same as above (fixes only the nowiki issue, modifying the regexp could solve pre issue, working on it) . --Kaspera 14:32, 10 December 2007 (UTC)

Feature Requests

 * 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)


 * It would be nice to incorporate the creation of additional categories into this extension. --Oreo masta 17:40, 12 February 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.


 * 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 Extension:Semantic Forms (The Category select box apear in Spezial:EditData).