Extension:CategoryMagicWords

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual - list
Crystal Clear action run.png
CategoryMagicWords

Release status: beta

Implementation Parser extension
Description Adds some magic words to change the behaviour of category pages.
Author(s) Säsongsmat.nu (Rotseetalk)
Last version 0.1.3 (2012-12-29)
MediaWiki 1.17+
PHP 5.3+
Database changes no
License BSD
Download see here
Example säsongsmat.nu
Hooks used
ArticleFromTitle

ParserBeforeStrip
LanguageGetMagic

Check usage and version matrix; stats

The CategoryMagicWords extension allows you to hide the pages and/or the subcategories from category pages, if you want to replace them with some custom code (e.g. using Extension:Semantic MediaWiki). The extension overrides some MediaWiki functions, and will probably interfere with other extensions working in the same way (notably Extension:CategoryTree).

Contents

Usage[edit]

The magic words __CATEGORYNOPAGES__ and __CATEGORYNOSUBCATS__ on a category page will supress the pages and subcategories respectively. For image galleries, there is already a builtin magic word for that, __NOGALLERY__.

The parser function {{#parentcategories:}} will display the categories a page belongs to, in a comma separated list of links internal. Define a parameter "lcfirst" to lower case firt letter: {{#parentcategories:Category:Child}} => Parent, while {{#parentcategories:|lcfirst}} => parent. {{#parentcategories:}} will do the same as {{#parentcategories:Extension:CategoryMagicWords}}.

You might want to change the message in MediaWiki:Category-empty if using this extension.

Installation[edit]

You can also cut and paste the code from CategoryMagicWords.php and CategoryMagicWords.i18n.php and move them into your extensions folder, then add the following to LocalSettings.php:

require_once( "$IP/extensions/CategoryMagicWords/CategoryMagicWords.php" );

Changelog[edit]

  • 0.1.3
    • Changed minimum PHP requirement to 5.3
    • Code formatting
  • 0.1.2
    • Introducing parser function #parentcategories
  • 0.1.1
    • Cleaned up the code
    • Removed support for MagicWordMagicWords (MW <=1.6.0)
    • i18n-file
  • 0.1 First version

Todo[edit]

  • Don't output MediaWiki:Category-empty if category is not really empty.
  • Is it possible to achieve this using the CategoryView hook? Would be good, so that this extensions does not interfere with CategoryTree or other extensions, that might now see some of their category page functionality overriden.
  • Add I18n for magic words
  • Check compatibility with other MediaWiki versions.

See also[edit]