Extension:NamespacePaths

MediaWiki extensions manual

File:OOjs UI icon advanced-invert.svg NamespacePaths Release status: stable
Description	Allows custom article paths to be mapped to namespaces of the wiki
Author(s)	Daniel Friesen @ Redwerks (Dantmantalk)
Latest version	1.2.0 (2022-10-07)
MediaWiki	1.35+
Database changes	No
License	GNU General Public License 2.0 or later
Download	<translate> Download extension</translate> <translate> Git</translate> [?]: <translate> Download Git master</translate> <translate> browse repository</translate> (GitHub) <translate> commit history</translate> <translate> repository contributors (GitHub)</translate> <translate> code review</translate>
Parameters $wgNamespacePaths
Hooks used WebRequestPathInfoRouter GetLocalURL::Article Article extensions
Quarterly downloads
Public wikis using
Translate the NamespacePaths extension if it is available at translatewiki.net

The NamespacePaths extension extends custom article paths to allow namespaces to be mapped to extra paths separate from the article path. For example mapping the help namespace to /help/$1 so pages like "Help:Contents" go to /help/Contents.

Installation

• <translate> [[<tvar name=2>Special:ExtensionDistributor/NamespacePaths</tvar>|Download]] and move the extracted <tvar name=name>NamespacePaths</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
  <translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/NamespacePaths
• <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>

  wfLoadExtension( 'NamespacePaths' );
  

1. Configure the $wgNamespacePaths with the paths you want to use for namespaces, the key is the namespace id (you can use the NS_ constants), and the value is a $wgArticlePath style string like "/help/$1".
2. Configure your webserver to pass the extra paths to MediaWiki. Consult the short URL documentation you set the article paths for your wiki and extend it to map the extra paths to "index.php".

Note: You don't want to try mapping things to ⁄index.php?title=$1, doing so will break the paths. If you just make sure that ⁄index.php is run for these extra article paths as long as your webserver sets REQUEST_URI correctly the extension will take it from there and extract the correct title on it's own.

• File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>

<translate> To users running MediaWiki <tvar name=1>1.39</tvar> or earlier: </translate>

<translate> The instructions above describe the new way of installing this extension using <tvar name=LoadExtension>wfLoadExtension()</tvar>.</translate> <translate> If you need to install this extension on these earlier versions (MediaWiki <tvar name=1>1.39</tvar> and earlier), instead of <tvar name=code>wfLoadExtension( 'NamespacePaths' );</tvar>, you need to use:</translate>

require_once "$IP/extensions/NamespacePaths/NamespacePaths.php";