Extension:SelectCategory
This extension is currently not actively maintained! Although it may still work, any bug reports or feature requests will more than likely be ignored. If you are interested in taking on the task of developing and maintaining this extension, you can request repository ownership. As a courtesy, you may want to contact the author. You should also remove this template and list yourself as maintaining the extension in the page's {{Extension }} infobox. |
SelectCategory Release status: unmaintained |
|
---|---|
Implementation | Page action |
Description | Allows the user to select from existing categories when editing a page. |
Author(s) | |
Latest version | 0.9.0 (2017-10-30) |
Compatibility policy | Snapshots releases along with MediaWiki. Master is not backward compatible. |
MediaWiki | |
PHP | 5.4+ |
License | GNU General Public License 2.0 or later |
Download | README CHANGELOG |
|
|
Quarterly downloads | 6 (Ranked 125th) |
Translate the SelectCategory extension if it is available at translatewiki.net | |
Issues | Open tasks · Report a bug |
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.
Download
editThe extension can be retrieved directly from Git [?]:
- Browse code
- Some extensions have tags for stable releases.
- Browse tags
- Select the tag
- Click "snapshot"
- Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).
- Browse branches
- Select a branch name
- Click "Continue"
Extract the snapshot and place it in the extensions/SelectCategory/ directory of your MediaWiki installation.
If you are familiar with Git and have shell access to your server, you can also obtain the extension as follows:
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/SelectCategory.git
Installation
edit- Download and move the extracted
SelectCategory
folder to yourextensions/
directory.
Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/SelectCategory - Add the following code at the bottom of your LocalSettings.php file:
require_once "$IP/extensions/SelectCategory/SelectCategory.php";
- Configure as required
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Configuration
edit$wgSelectCategoryNamespaces
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.
$wgSelectCategoryNamespaces[NS_PROJECT] = false;
$wgSelectCategoryNamespaces[NS_CATEGORY] = false;
or
$wgSelectCategoryNamespaces = array(
NS_MEDIA => true,
NS_MAIN => true,
NS_TALK => false,
NS_USER => false,
NS_USER_TALK => false,
NS_PROJECT => true,
NS_PROJECT_TALK => false,
NS_IMAGE => true,
NS_IMAGE_TALK => false,
NS_MEDIAWIKI => false,
NS_MEDIAWIKI_TALK => false,
NS_TEMPLATE => false,
NS_TEMPLATE_TALK => false,
NS_HELP => true,
NS_HELP_TALK => false,
NS_CATEGORY => true,
NS_CATEGORY_TALK => false,
100 => true, // customized namespace, e.g. ''Portal'', c.f. [[Manual:Using custom namespaces]]
101 => false // customized namespace, e.g. ''Portal talk'', c.f. [[Manual:Using custom namespaces]]
);
$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.
$wgSelectCategoryRoot = array(
NS_MEDIA => false,
NS_MAIN => "My Article Root Category",
NS_TALK => false,
NS_USER => false,
NS_USER_TALK => false,
NS_PROJECT => false,
NS_PROJECT_TALK => false,
NS_IMAGE => "My Image Root Category",
NS_IMAGE_TALK => false,
NS_MEDIAWIKI => false,
NS_MEDIAWIKI_TALK => false,
NS_TEMPLATE => false,
NS_TEMPLATE_TALK => false,
NS_HELP => false,
NS_HELP_TALK => false,
NS_CATEGORY => false,
NS_CATEGORY_TALK => false
);
$wgSelectCategoryEnableSubpages
Defines if the extension should be active when editing subpages.
$wgSelectCategoryEnableSubpages = false;
Style
editTo 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 & Feature Requests
editPlease file bugs and feature requests in the bug tracker on phabricator.wikimedia.org. You might just use this direct link that has these two settings pre-defined: