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]

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]

Latest release[edit]

  • 2016.04: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2016.04.tar.bz2
    sha256sum: 113439ad94b1a75ab8616f41c4d120e12c1fa8c3888933ec136783bfbdc9bc70 [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.25, 1.26 or above and requires PHP 5.5.9 or above.
  • Babel and LocalisationUpdate
    • Extensions now uses extension registration.
  • CLDR:
    • Updated to CLDR 29 release.
  • Translate:
    • Message group selector now works in Internet Explorer and Edge browsers.
    • A bug was fixed that sometimes caused translation pages not to update changes to the source page after marking it for translation. After upgrading it is recommended to run scripts/refresh-translatable-pages.php to ensure no pages contain outdated content.
  • UniversalLanguageSelector:
    • Fixed issues related to the tooltip shown for language settings that sometimes caused JavaScript errors.
    • Input methods now work with VisualEditor.

Previous releases[edit]

  • 2016.01: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2016.01.tar.bz2
    sha256sum: 7a46bb96f852aa42f728c68e4e21558878c8cba703ce9f8f6c2316af7bbe03e3 [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.25.x and 1.26.x.
  • CLDR:
    • cldr is converted to extension registration. Please update your LocalSettings.php!
  • Translate:
    • Old custom tokens were deprecated in favor of using regular "csrf" (previously known as "edit") token. If you are using Translate WebAPIs you might need to migrate.
    • Special:Translations no longer shows PHP notices for pages with invalid language codes
  • UniversalLanguageSelector:
    • ULS now uses extension registration and thus requires MediaWiki 1.25 or later.
    • Input methods should now work inside Visual Editor.
    • Various fixes in fonts and input methods.
  • 2015.10: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2015.10.tar.bz2
    sha256sum: 482595d35ab02fdc40c6ae54d2cf21aa22360f7021d498c054624ccdbf721237 [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.24.x and 1.25.x.
  • CLDR:
    • Updated to CLDR 28.
  • Translate:
    • MediaWiki 1.23 is no longer supported. Extension is no longer automatically loaded when installed via composer.
    • If local TTMServer translation memory is marked as public, it will not now automatically take advantage of TranslationWebServices query parallelization.
  • UniversalLanguageSelector:
    • MediaWiki 1.23 is no longer supported. Extension is no longer automatically loaded when installed via composer.
    • Language change is now done in two phase: first changed with API, then page is reloaded. The 'setlang' URL parameter is no longer used, although it still works. Due to the change, language switching might take a slightly longer than previously.
  • 2015.08: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2015.08.tar.bz2
    sha256sum: 21cb43509d1e6da3cadc7e594866215d430e110aea5d04857e5cffd2a69db031 [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.23.x, 1.24.x and 1.25.x.
  • Translate:
    • Special:SearchTranslations has acquired lots of new features, such as cross language search. To take advantage of all the new features, you need to reindex the index with "php scripts/ttmserver-export.php --reindex". You also need to update ruflin/elastica to 2.2.0 or later, or recent version of CirrusSearch which bundles it.
  • UniversalLanguageSelector:
    • ULS will use jQuery.i18n from MediaWiki core if available.
    • Updated the default geoiplookup URL.
    • ULS supports extension registration now.
    • New Input Methods and fonts are added.
  • 2015.04: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2015.04.tar.bz2
    sha256sum: 0aaae92b987130068b9fc03595428286d96541a947cbd137147ae7c0f50d9241 [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.23.x and 1.24.x.
  • Babel:
    • Restore compatibility with MediaWiki 1.24 and older version.
  • CLDR:
    • Update to CLDR 27.0.1
  • Translate:
    • Styled search result navigation buttons in Special:SearchTranslations
    • Fixed Special:PagePreparation, now works better and has autocompletion
  • UniversalLanguageSelector:
    • Show the Common language section only if the list is long enough.
    • Make ULS IME working in Content Translation.
  • 2015.01: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2015.01.tar.bz2
    sha256sum: 7a53ed826ae14ffe279fc4231cc47d367f668723a5843ad62c13a8f17d339744 [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.23.x and 1.24.x.
  • LocalisationUpdate:
    • Added support for updating skins.
  • Translate:
    • Added Content Translation Machine Translation backend support.
    • Message group configurations are now optionally validated.
    • Make 'fuzzy' as a default action for changes in source language in Special:ManageMessageGroups.
  • UniversalLanguageSelector:
    • This version has compatibility issues with Internet Explorer 8. Support will be restored in the next MLEB release.
  • 2014.11: https://translatewiki.net/mleb/MediaWikiLanguageExtensionBundle-2014.11.tar.bz2
    sha256sum: 39b397a05561f743962cfb499f59a58219338607ea13ebfcc7a8806105e7dedc [1]
    Announcement and Release Notes
    • Compatible with MediaWiki: 1.23.x and 1.24.x.
  • CLDR:
    • Fixed some time displays if CLDR had only partial localisation of time units.
  • Translate:
    • Translate WebAPI documentation is now localized. Only works in MediaWiki 1.24 and newer.
    • If you are using the Solr backend for the translation memory or the translation search, please let us know. If there are no users for the Solr backend, we will deprecate and later remove it in favor of the better maintained ElasticSearch backend.
  • UniversalLanguageSelector:
    • ULS WebAPI documentation is now localized. Only works in MediaWiki 1.24 and newer.
    • T67516: Removed font-size for ULS language selection panel buttons, which caused tiny font sizes on the Monobook skin.
    • Small compatibility fix when both ULS and VisualEditor are in use.
    • About 20 new languages are now supported in the language selector and a couple language names were changes.
    • Added support for WOFF2 webfont format. Note that there are no WOFF2 webfonts in the font repository yet due to pending issues in WOFF2 font generation.
  • 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).
  • 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]

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 2016.04; cd ..
 done

Installation[edit]

extensions in subdirectory[edit]

If your directory layout looks like this:

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

go to mediawiki directory and extract the release file:

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

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-2016.04.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]

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]

Command line[edit]

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

php maintenance/update.php

Web browser[edit]

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

Configuring LocalisationUpdate[edit]

If you are on a 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

Background[edit]

MLEB does not use version-specific branches. It's a snapshot from master which is verified to be working with the specified MediaWiki releases.