MediaWiki 言語拡張バンドル

This page is a translated version of the page MediaWiki Language Extension Bundle and the translation is 42% complete.

MediaWiki 言語拡張機能バンドル (MLEB) はキュレーションに合格した MediaWiki 拡張機能一式で多言語機能を提供します。 この機能の目的は、MediaWiki に手軽な言語サポートを提供することです。


MLEB には6つの拡張機能があります。

MLEB の更新日程は年に4回で、常に改善される言語サポートを手軽に最新の状態に保つことができます。 最新の MediaWiki 更新との整合性をテストしてありますので、それぞれの拡張機能の最新開発バージョンを使っても、起こりがちなトラブルを回避できます。


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 common 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 Foundation, KDE, and other sites. 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.


Latest release


Previous releases

  • Fix compatibility with MediaWiki <= 1.37 when VisualEditor is installed. (Phab:T294605)
  • SECURITY: Allow revdel-related actions in translatable pages (Gerrit)
  • Export script: remove --hours (Gerrit)
  • Remove translation aids customization (Hook: TranslateTranslationAids) (Gerrit)
  • Remove $wgTranslateDelayedMessageIndexRebuild (Gerrit)
  • Remove getConfiguration and getFFS from MessageGroup (Gerrit)
  • Group configuration: Rename validator keymatch option to include (Gerrit)
  • SECURITY: Enhance validation and logging for AggregateGroups API deletions (タスク T282932)
Configuration variable changes

To address voice and tone issues in the Translate extension (タスク T277965) the following configuration variable names have been renamed:

  • TranslateBlacklistTranslateDisabledTargetLanguages
  • TranslateAuthorBlacklistTranslateAuthorExclusionList
  • TranslateCheckBlacklistTranslateValidationExclusionFile

The old variables will be supported for MLEB 2021.07 release but removed in the MLEB 2021.10 release.

If you have defined message groups defined with LANGUAGE attributes, whitelist/blacklist have been changed to include/exclude

  • BREAKING CHANGE: UniversalLanguageSelector extension now requires MediaWiki 1.35 or above.
    • Position language menu below language button. (タスク T276248)
    • Fix "ULS settings window can’t be opened with the preferences link on new Vector". (タスク T282956)
  • 2020.04:
    sha256sum: 97dbf8846c62cbafa43b7b5f359c3fb55039846277ebb55dd7b00e42d356d709 [1]
    Announcement and Release Notes
    • Compatible with MediaWiki 1.33 and above and requires PHP 7.2 or above.
  • Remove PHP based entry point for Translate extension. Use wfLoadExtension( 'Translate' ); to load the Translate extension.
  • Test and add support for PHP 7.4. Now all versions of PHP 7.2 and above are supported.
  • SECURITY FIX: Translate: HTML from messages was not escaped in Special:ManageMessageGroups. If you do not use this page (e.g. only use translatable wiki pages) you are not affected. (Phab:T242115)
wfLoadExtension( 'Translate' );
  • Removed deprecated and unmaintained SolrTTMServer. Recommendation is to migrate to ElasticSearch. (Phab:T87985)
  • Dropped support for HHVM.
  • 2019.04:
    sha256sum: 5fbbd39acd1cc0e1edbd542a390daf1992d1526134ceb69248cdb4dced58f3a9 [1]
    Announcement and Release Notes
    • Compatible with MediaWiki 1.31, 1.32 and above and requires PHP 7.0.0 or above.
  • PHP entry point has been removed for CleanChanges and cldr. Warning will be displayed for deprecated PHP entry point. (T140007)
  • Fixed fatal error on PageContentLanguage hook subscriber (T214358)
  • Fixed broken Special:PageMigration (T217727)
  • Added support for newer versions of the Elastica extension while maintaining backward compatibility for older version REL 1.31 (T218100)
  • Added multiple new keyboard layouts in UniversalLanguageSelector.
  • 2019.01:
    sha256sum: 39f2e946e360ac868744dc8e6f62cb5723447415bd11bcbb4911eb0f3674360c [1]
    Announcement and Release Notes
    • Compatible with MediaWiki 1.31, 1.32 and above and requires PHP 5.5.9 or above.
  • $wgTranslateCC is deprecated now. It should be replaced by TranslatePostInitGroups hook. (T212836)
  • Added proofreading to (Language|MessageGroup)Stats. The statistics table also has updated styling. (T41279)
  • Skipping messages Special:Translate's page mode no longer sometimes marks the translation proofread. (T206748)
  • Translatable subpages are no longer moved when moving parent. (T114592)
  • Message group stats updating was broken in multiple ways. (T134252, T208521)
  • Added multiple new keyboard layouts in UniversalLanguageSelector.
  • 2018.10:
    sha256sum: c0a65956d4f8e49ba1b401372636b9575a5c17fbf2501fa14ff1c265dd778862 [1]
    Announcement and Release Notes
    • Compatible with MediaWiki 1.30, 1.31 and above and requires PHP 5.5.9 or above.
  • Updated cldr to version 34.0
  • LocalisationUpdates and UniversalLanguageSelector has removed PHP entry point. Please update your configuration!
  • Fixed an error in Translate that prevented Special:PageMigration from working.
  • UniversalLanguageSelector now supports UI language change when Global Preferences are present. (T198206)
  • UniversalLanguageSelector dropped support for discontinued
  • 2018.07:
    sha256sum: 36aa80c78be6dcfb533f96dc25afdabd2fd4716452c1b5a6f2bc982def1af7bc [1]
    Announcement and Release Notes
    • Compatible with MediaWiki 1.30, 1.31 and above and requires PHP 5.5.9 or above.
  • Updated cldr to version 33.
  • Special:SupportedLanguages: List of authors is now sorted by the number of contributions.
  • Message keys coming from external files are now handled with more care and less likely to produce invalid or inaccessible pages. (T193023)
  • refresh-translatable-pages.php script can now use JobQueue, which is more efficient on wikis with thousands of translatable pages. (T195347)
  • Custom languages defined in $wgExtraLanguages now always appear in Special:Translate and Special:SearchTranslations. (T112889)

Show all releases.

Git でのダウンロード

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
   if [ ! -d "$ext" ]
     git clone$ext.git
   cd $ext; git fetch --tags; git checkout 2021.12; cd ..


Installation requirements

Installation requirements of each piece of provided software are included in the respective documentation. See in particular:

Add/update your LocalSettings.php

Near the end of LocalSettings.php, you have to place this configuration:

wfLoadExtension( 'Babel' );

wfLoadExtension( 'cldr' );

wfLoadExtension( 'CleanChanges' );
$wgCCTrailerFilter = true;
$wgCCUserFilter = false;
$wgDefaultUserOptions['usenewrc'] = 1;

wfLoadExtension( 'LocalisationUpdate' );
$wgLocalisationUpdateDirectory = "$IP/cache";

wfLoadExtension( 'Translate' );
$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

wfLoadExtension( 'UniversalLanguageSelector' );

Update database tables

Command line

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

php maintenance/update.php

Web browser

Go to (see Manual:Upgrading#Web browser) by using your domain and path and rerun install.

Configuring and using extensions

See the respective extension documentation pages. Do note that LocalisationUpdate does nothing by default and needs additional configuration to be run periodically.


MLEB does not use version-specific branches of extensions. It's a snapshot from master which is verified to be working with the specified MediaWiki releases. This means all MLEB extensions must follow the compatibility policy of supporting two latest stable MediaWiki releases in the master branch.

MLEB releases are created with a tool called Melange. If you are interested in that code (e.g. you want to change its code), see the Melange repository in Git.