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>Special:MyLanguage/Help:Extension:Translate/Installation|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.

Page translation
If there is a problem with namespace while translating translatable pages (symptoms: definition not shown, page title starts with colon), add these two to LocalSettings.php:

This problem occurs if something unstubs Language class very early, and because we are adding the namespace late to have them conditionally enabled.

Translation page is empty or error 'Unbalanced &lt;translate> tag' shown
Provided that the closing &lt;/translate> 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 pcre.backtrack_limit by setting  ini_set( 'pcre.backtrack_limit', 400000 ); in LocalSettings.php or  pcre.backtrack_limit=400000  in your PHP configuration (php.ini).

Fonts with PHPlot
If characters in some languages show up as boxes, first check that you have a suitable font installed. If that doesn't help, enable the font debugging log. You may need to clear your MediaWiki cache first. On some systems PHP is not allowed to access the fonts the fc-list command provides.

$wgDebugLogGroups['fcfont'] = '/path/to/writable/logfile';

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 <tvar|script>php extensions/Translate/scripts/createMessageIndex.php</>.

Possibly also, the required extension UniversalLanguageSelector was loaded with <tvar|wfLoadExtension> </> but the extension Translate is loaded with <tvar|require_once> </>, making UniversalLanguageSelector only half-loaded and creating this issue.