![]() | This feature was removed completely in version 1.38. This extension has been abandoned and thus no longer bundled in MediaWiki 1.38. See task T300498 for more information. |
![]() Release status: stable |
|
---|---|
Implementation | Database |
Description | Allows to keep the localized messages as up to date as possible |
Author(s) | Tom Maaswinkel (12wiki), Niklas Laxström |
Latest version | 1.4.0 (2016-10-13) |
MediaWiki | 1.30+ |
Composer | mediawiki/localisation-update |
License | GNU General Public License 2.0 or later |
Download | Download extension Git [?]: Readme |
Parameters
|
|
Hooks used
|
|
Quarterly downloads | 121 (Ranked 73rd) |
Public wikis using | 989 (Ranked 223rd) |
Translate the LocalisationUpdate extension if it is available at translatewiki.net | |
Issues | Open tasks · Report a bug |
The LocalisationUpdate extension allows to update the localizations for MediaWiki messages at any time, without needing to upgrade the MediaWiki software.
Installation
- Download and place the file(s) in a directory called
LocalisationUpdate
in yourextensions/
folder. - Add the following code at the bottom of your LocalSettings.php
wfLoadExtension( 'LocalisationUpdate' ); $wgLocalisationUpdateDirectory = "$IP/cache";
file: - Create a
cache
folder in the installation directory, and be sure the server has permissions to write on it. Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Configuration
$wgLocalisationUpdateDirectory
Directory to store cache files in, if not set then it uses default $wgCacheDirectory
. 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
$wgLocalisationUpdateRepositories['github'] = array(
'mediawiki' =>
'https://raw.github.com/wikimedia/mediawiki/master/%PATH%',
'extension' =>
'https://raw.github.com/wikimedia/mediawiki-extensions-%NAME%/master/%PATH%',
'skin' =>
'https://raw.github.com/wikimedia/mediawiki-skins-%NAME%/master/%PATH%'
);
Example for local filesystem configuration
$wgLocalisationUpdateRepositories['local'] = array(
'mediawiki' =>
'file:///resources/projects/mediawiki/master/%PATH%',
'extension' =>
'file:///resources/projects/mediawiki-extensions/extensions/%NAME%/%PATH%',
'skin' =>
'file:///resources/projects/mediawiki-skins/skins/%NAME%/%PATH%'
);
$wgLocalisationUpdateHttpRequestOptions
MediaWiki version: | ≥ 1.35 |
Options to pass to Http::get()
.
Possible keys for the array: (see HttpRequestFactory::create()
).
- 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 MediaWiki/$wgVersion
- logger
- A \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
$wgLocalisationUpdateHttpRequestOptions = array(
'followRedirects' => true,
'username' => 'YOUR_GITHUB_USERNAME',
'password' => 'YOUR_GITHUB_PERSONAL_ACCESS_TOKEN'
);
Usage
Whenever you want to run an update, run php extensions/LocalisationUpdate/update.php
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 # Add the following line @daily php /path/to/your/wiki/extensions/LocalisationUpdate/update.php --quiet
php maintenance/rebuildLocalisationCache.php --force
.Script parameters
--repoid
: Fetch translations from repositories identified by this
See also
- Localisation
- Technical details about how this runs on Wikimedia projects.
![]() | This extension is included in the following wiki farms/hosts and/or packages:
|