Extension:CategoryMultisort

MediaWiki extensions manual - list

CategoryMultisort Release status: experimental
Implementation	Parser function, User interface, Database
Description	Allowing categories to be viewed with different sortkeys.
Author(s)	LiangentTalk
MediaWiki	1.16+
License	GPLv2
Download	Download snapshot (Git master) Git [?]: repo summary • tree • code changes SVN [?]: checkout-url • tree • code changes
Parameters $wgCategoryMultisortSortkeySettings efCategoryMultisortIntegrate()
Hooks used LoadExtensionSchemaUpdates ParserFirstCallInit LanguageGetMagic ParserClearState ParserBeforeTidy LinksUpdate ArticleDeleteComplete CategoryPageView GetPreferences
Check usage (experimental)

What can this extension do?

This extension allows categories to be viewed with different sortkeys.

Usage

Assume the sortkeys SKA, SKB, SKC are defined in LocalSettings.php (see below).

With integration (see below)

<code>
{{DEFAULTSORT:D}} -- The DEFAULTSORT syntax from core.
{{DEFAULTSORT:|SKA=1}} -- Set default SKA for all categories.
- or -
{{DEFAULTSORT:D|SKA=1}} -- You can put them together.

[[Category:Cat||SKB=2]] -- Leave the first argument alone. That's for the core sortkey; leaving blank means default.
</code>

With and without integration (see below)

<code>
{{DEFAULTSORT:D}} -- The DEFAULTSORT syntax from core.
{{#CategoryDefaultMultisort:SKA=1}} -- Set default SKA for all categories.
[[Category:Cat]] -- This must exist.
{{#CategoryMultisort:Cat|SKB=2}} -- Set SKB for this page in [[:Category:Cat]]
</code>

Download instructions

Please download the code and place it in $IP/extensions. Note: $IP stands for the root directory of your MediaWiki installation, the same directory that holds LocalSettings.php.

Installation

To install this extension, add the following to LocalSettings.php:

require_once("$IP/extensions/CategoryMultisort/CategoryMultisort.php");
# add configuration parameters here

Configuration parameters

• $wgCategoryMultisortSortkeySettings = array( 'SORTKEY' => SETTINGS );
  • where SETTINGS is array( KEY => VALUE );
    • KEY can be 'type' and set VALUE to 'int', or 'first' and set VALUE to an integer. See Extension:CategoryMultisortChinese.
  • also add a wiki page MediaWiki:Categorymultisort-sortkey-name-SORTKEY and set it to a meaningful name.
• efCategoryMultisortIntegrate();
  • Call this if you want this extension to integrate into core category syntax. The experimental LinkHooks feature is used.