Help:Extension:Translate/Installation

The Translate extension, due to its nature of rapid development, requires a relatively recent version of MediaWiki to work. The aim is to support the development version and the two latest stable versions of MediaWiki. In package managers, the version may be too old to fulfill the requirements. In that case you need to download a newer release from mediawiki.org or from Wikimedia's Git repository.

The Translate extension uses a continuous development model, which means we are not making any releases. We recommend that you fetch the latest version from Wikimedia's Git repository and update regularly to get new features and bug fixes. The core functionality is pretty stable, but there may be bigger changes from time to time. These are described in a file called README in the extension's directory. All commits to Translate extension are peer reviewed and thus the development branch is always ready for production use.

Requirements
The following software is required to install this extension:


 * 1) 1.18, 1.19 or the development version
 * 2) MySQL database
 * 3) (optional) PHPlot for statistics graphs
 * 4) (optional) Syck for faster YAML parsing
 * 5) Internet access on the server for machine translation services

In addition, shell access is required to run maintenance scripts.

The use of memcached for caching and for example APC PHP accelerator is recommended in a production environment.

Getting the source
The recommended way to get the Translate extension is to use git: git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Translate.git
 * 1) At mediawiki extensions folder

This is recommended, because the code is regularly updated with new features and bug fixes. Currently we cannot provide good support for versions older than couple of months, due to the lack of resources. It is easy to update this way, only  in the   directory is needed.

At this point you may also want to install other recommended extension:
 * Babel – Allows users to indicate which languages they speak
 * CleanChanges – Cleaner recent changes
 * CLDR – Localised language names and other data in many languages
 * Replace text – Do mass replacements in translations.
 * Narayam and WebFonts – Input method and font support for many languages.

Activating the extension
After the code has been placed into the correct directory, all that is needed is a line similar to this in :

Now you should run  or the web installer again to add database tables used by the extensions.

After that line it is possible to add configuration settings that enable new features or change the way the extension works. See Configuration for a description of these settings. See also the page for Page translation administration to configure the page translation feature.