Jump to content

Extension:UrlGetParameters

From mediawiki.org
MediaWiki extensions manual
UrlGetParameters
Release status: stable
Implementation Parser function
Description Provides a parser function {{#urlget:...}} which allows access to the URL parameters in your page.
Author(s) S.O.E. Ansems
Latest version 1.6.0 (2021-04-16)
MediaWiki 1.35+
Database changes No
  • $wgUrlGetParametersSeparator
Licence GNU General Public License 2.0 or later
Download
Translate the UrlGetParameters extension if it is available at translatewiki.net
Vagrant role urlgetparameters

The UrlGetParameters extension enables you to use and/or display the "GET" parameters of the URL, i.e. the query string, on the wiki page.

Installation

[edit]
  • Download and move the extracted UrlGetParameters folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/UrlGetParameters
    
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'UrlGetParameters' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Usage

[edit]
Caching for the page you use this extension on should be disabled.

To display the value of a URL get parameter in your page, you might do this:

{{#urlget:parameter-name}}

Where parameter-name is the name of the parameter whose value you want. If the parameter is not found, the extension will result in nothing. Alternatively, you can also specify a default value as follows:

{{#urlget:parameter-name|default-value}}

When the parameter parameter-name is not available, then the value default-value is returned.

If the URL contains parameters of the form "A[B]=C", you can display the value "C" in a similar way, by calling:

{{#urlget:A[B]}}

Authors

[edit]

This extension was written by S.O.E. Ansems. Important contributions were made by Ankit Garg and some anonymous editors.