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]

  • 2014.10: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2014.10.tar.bz2
    sha256sum: 49707823ec19d9eed1c21c37550a3b0a2c81ff83855aea2706287a5169e90468 [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.22.x and 1.23.x.
  • CleanChanges: Added support for ULS in language filter selector.
  • Translate:
  • New feature: Remove any page from translation with two clicks from Special:PageTranslation. Previously, translate tags had to be removed manually first.
  • Special:PageTranslation also has prettier warning and error notifications.
  • The user group translate-proofr is no longer created by default. If you were using it, you can add it back with following code in your LocalSettings.php:
$wgGroupPermissions['translate-proofr']['translate-messagereview'] = true;
$wgAddGroups['translate-proofr'] = array( 'translate-proofr' );
  • Removed $wgTranslatePageMigration (enabled by default), $wgTranslateUseTux (no longer in use) and translate-proofr group (needs sysadmin action if in use).

Previous releases[edit | edit source]

  • 2014.09: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2014.09.tar.bz2
    sha256sum: 9cfdc7d4fc87b4cd6f8d1d2e1593b8cd064b7a9a2773c1a6a554304949a609ec [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.22.x and 1.23.x.
  • CLDR is updated to 26.
  • Translate:
  • Regression fixed: Translate's compatibility with MediaWiki 1.22 has been restored.
  • Regression fixed: Fix translation ratios in translatable page language selector.
  • Special:MyLanguage is now in core. For backwards compatibility, translations of Special:MyLanguage aliases were moved to a separate file (Bug 69461).
  • $wgTranslatePageTranslationULS now works as intended on all translation pages by removing the language code from the page name.
  • 2014.08: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2014.08.tar.bz2
    sha256sum: f4663910facd2b34d4afb1af930f66adad22b2746f9395f7706f07751e633857 [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.22.x and 1.23.x.
  • Added Comic Neue font. It is available for English and other languages using the latin alphabet.
  • Translate
    • Breaking change: Dropped support for MediaWiki 1.21 (2014.05 is the latest version of MLEB as a whole which supports 1.21)
    • Avoid losing translators' edits: improved handling of expired sessions (bug 69314).
    • Restore progress icon for the current translation page (regression from MLEB 2014.07).
  • 2014.07: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2014.07.tar.bz2
    sha256sum: 8af5c001db9375bf8dfd16495c7a88fc8dc9b4fe281b1048f6bea6c490bc4a9d [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.22.x and 1.23.x.
  • Updated to CLDR 25 and fixed rebuild script.
  • Display source language for the pages in Special:Translate
  • Fixed ElasticSearchTTMServer to not return matches for single word messages only.
  • Stopped using deprecated jquery.json module, this will make ULS slightly smaller.
  • Added Ludic (lud) transliteration and Tibetian (bo) EWTS layouts.
  • 2014.05: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2014.05.tar.bz2
    sha256sum: f53030ce7e6e0619f9a075877bc85423c0a28f46ffb296dbed5733502683b9b3 [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.21.10 and 1.22.7.
  • Translate: When a user is promoted from translator sandbox, it is treated as account creation. Promoted users can now receive NewUserMessage.
  • CLDR: The fallback logic should not merge the time units from languages in fallback chain. It should use time units from a fallback language only when time units are not defined.
  • Always display assistant languages in compact language list when defined by user in Translate extension.
  • Added 'Hussaini Nastaleeq' font for Urdu.
  • 2014.04: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2014.04.tar.bz2
    sha256sum: f20631d2629e0cf80df8ca022e6eec4d6d784e0cd39799f9fd46f338f4a7381a [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.21.9 and 1.22.6.
    • LocalisationUpdate now updates messages for older MediaWiki versions.
    • Set JSON message format as default for MediaWiki extensions.
    • Allow overriding the header styles from typography refresh.
    • Added Batak input method.

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.10; 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.10.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:

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

go to common parent directory and extract the release file:

tar xjf MediaWikiLanguageExtensionBundle-2014.10.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