Extension:LocalisationUpdate

The LocalisationUpdate extension allows to update the localizations for MediaWiki messages at any time, without needing to upgrade the MediaWiki software.

$wgLocalisationUpdateDirectory
Directory to store cache files in, if not set then it uses default .

LocalisationUpdate requires some place to store files in to work; if neither $wgLocalisationUpdateDirectory nor $wgCacheDirectory is set, LocalisationUpdate's update.php script will not work.

$wgLocalisationUpdateDirectory is set to false by default.

$wgLocalisationUpdateRepository
Default repository source to fetch translation.

GitHub is set to default repository.

This is added with version 1.1.

$wgLocalisationUpdateRepositories
Array of repositories URLs from which to retrieve localisations for core MediaWiki and extensions.

Default is set to GitHub's MediaWiki Git repositories and you should not change this unless you know what you're doing. This is added with version 1.1.

Example for using github

Example for local filesystem configuration

$wgLocalisationUpdateHttpRequestOptions
Options to pass to  .

Possible keys for the array: (see  ).


 * timeout: Timeout length in seconds or 'default'
 * connectTimeout: Timeout for connection, in seconds (curl only) or 'default'
 * postData: An array of key-value pairs or a url-encoded form data
 * proxy: The proxy to use. Otherwise it will use $wgHTTPProxy (if set) Otherwise it will use the environment variable "http_proxy" (if set)
 * noProxy: Don't use any proxy at all. Takes precedence over proxy value(s).
 * sslVerifyHost: Verify hostname against certificate
 * sslVerifyCert: Verify SSL certificate
 * caInfo: Provide CA information
 * maxRedirects: Maximum number of redirects to follow (defaults to 5)
 * followRedirects: Whether to follow redirects (defaults to false). Note: this should only be used when the target URL is trusted, to avoid attacks on intranet services accessible by HTTP.
 * userAgent: A user agent, if you want to override the default <tvar|1>MediaWiki/$wgVersion</>
 * logger: A <tvar|1>\Psr\Logger\LoggerInterface</> instance for debug logging
 * username: Username for HTTP Basic Authentication
 * password: Password for HTTP Basic Authentication
 * originalRequest: Information about the original request (as a WebRequest object or an associative array with 'ip' and 'userAgent').

Example for using GitHub with HTTP Basic Authentication

Usage
Whenever you want to run an update, run <tvar|1> </> on the command line, or set up a cron job.

If you are on a unix-like system, you should add LocalisationUpdate to crontab: crontab -e @daily php /path/to/your/wiki/extensions/LocalisationUpdate/update.php --quiet
 * 1) Add the following line

Script parameters

 * : Fetch translations from repositories identified by this