Help:Extension:Translate/Configuration

The MediaWiki Language Extension Bundle provides you with all code and installation steps really required to configure Translate; this page goes into detail on which configuration options are available in case you need more and the installation introduction and requirements didn't help.

Sample configuration
This configuration goes to the  in the MediaWiki directory.

User rights
Translate extension introduces new user rights:

Configuration variables
The following documentation is copied from  for your convenience. Configuration options change over time, so if in doubt, the documentation in your Translate.php is the best one. For the record this is for 2016-04-21.

Message group configuration
Following configuration variable names have been renamed:



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

Translation page is empty or error 'Unbalanced tag' shown
Provided that the closing tag exists, the source page is too big. This starts happening with some translations if the source page size is near 50 kilobytes. Make the page shorter or increase  by setting ini_set( 'pcre.backtrack_limit', 400000 ); in LocalSettings.php or pcre.backtrack_limit=400000 in your PHP configuration (php.ini).

In TUX mode (the new UI) no messages are shown
If you have overridden, make sure task   is not excluded from it.

The tool doesn't load in Special:Translate
If you see something like this with endless "Loading messages...", the ResourceLoader is broken: set  or lower until it works.

If that's not enough, have you remembered to install and enable ?

Saving translation fails with Unknown error: "tpt-unknown-page"
This happens when page has been marked for translation, but the background job has not yet been processed. In this case you can run job queue manually, or even better, setup continuous job running as described in. If that doesn't solve the issue, try running php extensions/Translate/scripts/createMessageIndex.php.