Extension:HideNamespace

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

Release status: stable

Implementation Parser function, MyWiki
Description Hides namespace in the header and title when a page is in specified namespace or when the {{#hidens:}} parser function is called. You can also use {{#showns:}} to override the visibility individually.
Author(s) Matěj Grabovskýtalk
Last version 1.4.3 (2010-12-31)
MediaWiki 1.15 or later
License GPL 2.0 or later
Download
Parameters

$wgHidensNamespaces

Hooks used
ParserFirstCallInit

ArticleViewHeader
BeforePageDisplay

Check usage and version matrix; stats

HideNamespace enhances MediaWiki with ability to hide namespace name in page title and its header.

Contents

Usage[edit]

This extension has two main functionalities. They're both explained in the following sections.

The $wgHidensNamespaces array[edit]

Warning Warning: The name of this configuration array was changed from $wgHideNsNamespaces (note the case) in version 1.4.3 (1.4.2a for MW 1.15). Please, change the corresponding code in your LocalSettings.php to avoid further complications.

The first option is to use global variable $wgHidensNamespaces. By specifying namespaces in the $wgHidensNamespaces array you can hide the namespace prefix in all pages within the namespaces.

Example (put in LocalSettings.php after including the extension file):

$wgHidensNamespaces = array(
        NS_FILE,
        NS_USER,
        NS_USER_TALK,
);

This would hide the namespace prefix in all pages within the “File”, “User”, and “User talk” namespaces. Thus if there's a user page with name “User:Foo Bar”, it'd become “Foo Bar” when you visit the page.

Parser functions[edit]

The second option is to hide/unhide namespaces with two parser functions: {{#hidens:}} and {{#showns:}}. Those two parser functions don't take any parameters.

Example:

{{#hidens:}}
Foo bar. Baz, 1926.

If the previous page would be called, for instance, “Help:Bark”, it would become just “Bark” when you visit the page.

Other example:

{{#showns:}}
Hello, my name's Joe. You can leave me a message on my talk page.

If we would define the $wgHidensNamespaces variable as in the very first example and the previous page would be called “User:Joe Doe”, the page title would still be “User:Joe Doe” when you visit the page, because you've overriden the setting with the {{#showns:}} parser function.

Download instructions[edit]

Download the extension code from the Subversion repository and place it in your extensions directory.

Installation[edit]

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

# HideNamespace extension
require_once( "$IP/extensions/HideNamespace/HideNamespace.php" );
# Put the namespaces here
$wgHidensNamespaces = array();