Extension:PerPageLanguage

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	Download extension Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review
Parameters $wgPerPageLanguageIgnoreUserSetting
Hooks used SkinTemplateNavigation::Universal UserGetLanguageObject
Quarterly downloads	3 (Ranked 133rd)
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

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

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

• Browse code
• Some extensions have tags for stable releases.
  • Browse tags
  • Select the tag
  • Click "snapshot"
• 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).
  • Browse branches
  • Select a branch name
  • Click "Continue"

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

• 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
•  Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

• $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

• Extension:UniversalLanguageSelector
• Extension:MultiLanguageManager - An extension with similar goals