| Extensions: $wgExtensionMessagesFiles | |
|---|---|
| Extension messages files. |
|
| Introduced in version: | 1.11.0 |
| Removed in version: | still in use |
| Allowed values: | (array) |
| Default value: | [] |
| Other settings: Alphabetical | By function | |
This should only be used to specify files that define $magicWords and $specialPageAliases.
Its usage for $messages is deprecated.
Details
Associative array mapping extension name to the filename where messages can be found.
The file must create a variable called $messages.
Example:
$wgExtensionMessagesFiles['ConfirmEdit'] = __DIR__ . '/ConfirmEdit.i18n.magic.php';
Changed behavior in MediaWiki 1.23
Since MediaWiki 1.23, use of this variable to define messages is deprecated; instead, store messages in JSON format and use $wgMessagesDirs.
For setting other variables than $messages (such as $magicWords and $specialPageAliases), $wgExtensionMessagesFiles should still be used.
If there is an entry in $wgMessagesDirs with the same key as one in $wgExtensionMessagesFiles, then any $messages variables set in the $wgExtensionMessagesFiles file will be ignored.
This means an extension that only provides messages can be backward compatible by using both $wgExtensionMessagesFiles and $wgMessagesDirs, and only one of the two will be used depending on what the version of MediaWiki supports.
See also
- Requests for comment/Localisation format for background
- Localisation