MediaWiki Language Extension Bundle

From MediaWiki.org
Jump to: navigation, search
shortcut: MLEB

The MediaWiki language extension bundle provides easy way to bring ultimate language support to your MediaWiki. The bundle is a collection of selected few MediaWiki extensions needed by any wiki which desires to be multilingual.

Introduction[edit | edit source]

The Universal Language Selector is a must have, because it provides an essential functionality for any user regardless of the number of languages they speak: language selection, font support for displaying scripts badly supported by operating systems and input methods for typing languages that don't use the Latin alphabet. It includes freely-licensed fonts, which cover most of the major languages of America, Europe, Middle East, India and South East Asia.

Maintaining multilingual content in a wiki is a mess without the Translate extension, which is used by Wikimedia, KDE, translatewiki.net and other sites, where hundreds of interface translations are updated every day. With Localisation Update your users will always have the latest translations freshly out of the oven. The Clean Changes extension keeps your recent changes page uncluttered from translation activity and other clutter.

Don't miss the chance to practice your rusty language skills, use the Babel extension to mark the languages you speak and find other speakers of the same language in your wiki. And finally the cldr extension is a database of language and country translations.

MLEB has a monthly release schedule, so that you can easily stay on the cutting edge with the constantly improving language support. The bundle comes with clear installation and upgrade instructions (see below). The bundle is tested against MediaWiki release versions, so you can avoid most of the temporary breaks that would happen if you were using the latest development versions instead.

Download[edit | edit source]

Latest release[edit | edit source]

Previous releases[edit | edit source]

Via Git[edit | edit source]

In your extensions directory do the following to get or update to the latest release and follow configuration instructions below.

 for ext in Babel cldr CleanChanges LocalisationUpdate Translate UniversalLanguageSelector
 do
   if [ ! -d "$ext" ]
   then
     git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/$ext.git
   fi
   cd $ext; git fetch --tags; git checkout 2014.03; cd ..
 done

Installation[edit | edit source]

extensions in subdirectory[edit | edit source]

If your directory layout looks like this:

./mediawiki/extensions/{A,B,C}

go to mediawiki directory and extract the release file:

tar xjf MediaWikiLanguageExtensionBundle-2014.03.tar.bz2

The variable you have to add to your LocalSettings.php before the configuration below is:

$EXT = "$IP/extensions";

extensions in top-level directory[edit | edit source]

If your directory layout looks like this:

./mediawi
./extensions/{A,B,C}

go to common parent directory and extract the release file:

tar xjf MediaWikiLanguageExtensionBundle-2014.03.tar.bz2

The variables you have to add to your LocalSettings.php before the configuration below is:

$EXT = "$IP/../extensions";
$wgExtensionAssetsPath = "{$wgScriptPath}/../extensions";

Add/update your LocalSettings.php[edit | edit source]

Near the end, you have to place the configuration lines given above (pick from one of the two sections) followed by this:

require_once( "$EXT/Babel/Babel.php" );
 
require_once( "$EXT/cldr/cldr.php" );
 
require_once( "$EXT/CleanChanges/CleanChanges.php" );
$wgCCTrailerFilter = true;
$wgCCUserFilter = false;
$wgDefaultUserOptions['usenewrc'] = 1;
 
require_once( "$EXT/LocalisationUpdate/LocalisationUpdate.php" );
$wgLocalisationUpdateDirectory = "$IP/cache";
 
require_once( "$EXT/Translate/Translate.php" );
$wgGroupPermissions['user']['translate'] = true;
$wgGroupPermissions['user']['translate-messagereview'] = true;
$wgGroupPermissions['user']['translate-groupreview'] = true;
$wgGroupPermissions['user']['translate-import'] = true;
$wgGroupPermissions['sysop']['pagetranslation'] = true;
$wgGroupPermissions['sysop']['translate-manage'] = true;
$wgTranslateDocumentationLanguageCode = 'qqq';
$wgExtraLanguageNames['qqq'] = 'Message documentation'; # No linguistic content. Used for documenting messages

require_once( "$EXT/UniversalLanguageSelector/UniversalLanguageSelector.php" );
If you have existing babel categories, you need to check that the configuration matches your wiki's format. See Extension:Babel.

Update database tables[edit | edit source]

Commandline[edit | edit source]

In the directory where your LocalSettings.php is located, run the following command:

php maintenance/update.php

Webbrowser[edit | edit source]

Go to example.com/mediawiki/mw-config/ by using your domain and path and rerun install.

Configuring LocalisationUpdate[edit | edit source]

If you are on unix like system, you should add LocalisationUpdate to crontab:

crontab -e
# Add the following line
@daily php /path/to/your/wiki/extensions/LocalisationUpdate/update.php --quiet
Retrieved from "http://www.mediawiki.org/w/index.php?title=MediaWiki_Language_Extension_Bundle&oldid=946424"