Jump to content

Extension:PerPageLanguage

From mediawiki.org
This extension is professionally maintained by the WikiTeq team.
WikiTeq provides official support for MediaWiki LTS releases only. It may work with other MediaWiki releases.
MediaWiki extensions manual
PerPageLanguage
Release status: stable
Implementation MyWiki
Description Changes the localized interface messages based on which language the page is set as.
Author(s) Vedmaka
Maintainer(s) WikiTeq team
Latest version 1.0.0 (June 2021)
Compatibility policy For every MediaWiki release that is a Long Term Support release there is a corresponding branch in the extension.
MediaWiki 1.35, 1.39
Database changes No
License GNU General Public License 2.0
Download
  • $wgPerPageLanguageIgnoreUserSetting
Quarterly downloads 3 (Ranked 134th)
Translate the PerPageLanguage extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The PerPageLanguage extension allows a multi-lingual wiki to display each page in the same language as its contents. It allows for the page's defined content language, a feature built into MediaWiki, to also define what language the user interface should use. Unlike UniversalLanguageSelector, it changes the language used for the user interface based on the page's content language, not what the user selects. This extension can be thought of as using ?uselang= based on the page content language. (For more information on the difference between user interface language and page content language, see Manual:Language.)

This extension was created for WikiWorks.

Usage

[edit]

A page's content language can be defined at Special:PageLanguage if $wgPageLanguageUseDB is set to true. If this is defined, then PerPageLanguage will change the user interface language to match the page content language for anyone who navigates to that page.

Download

[edit]

The extension can be retrieved directly from Git [?]:

  • Browse code
  • Some extensions have tags for stable releases.
  • Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).

Extract the snapshot and place it in the extensions/PerPageLanguage/ directory of your MediaWiki installation.

If you are familiar with Git and have shell access to your server, you can also obtain the extension as follows:

cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/PerPageLanguage.git

Installation

[edit]
  • Download and move the extracted PerPageLanguage 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/PerPageLanguage
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'PerPageLanguage' );
    $wgPageLanguageUseDB = true;
    $wgGroupPermissions['sysop']['pagelang'] = true;
    
  • Configure as required
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

[edit]
  • $wgPerPageLanguageIgnoreUserSetting - If true, disregards the language chosen by the user's own preferences and forces the page to be displayed in the same language as the page content language.

See also

[edit]