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 Download snapshot
Subversion [Help]

Browse source code
View code changes

Parameters

$wgHidensNamespaces

Hooks used
ParserFirstCallInit

ArticleViewHeader
BeforePageDisplay

Check usage (experimental)

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

Contents

[edit] Usage

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

[edit] The $wgHidensNamespaces array

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.

[edit] Parser functions

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.

[edit] Download instructions

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

[edit] Installation

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();
Personal tools
Namespaces
Variants
Actions
Site
Support
Download
Development
Communication
Print/export
Toolbox