Manuel:$wgMessagesDirs
| Extensions: $wgMessagesDirs | |
|---|---|
| Répertoire des messages des extensions |
|
| Introduit dans la version : | 1.24.0 (Gerrit change 102957; git #2f7b68ff) |
| Retiré dans la version : | Encore utilisé |
| Valeurs autorisées : | (tableau) |
| Valeur par défaut : | [] |
| Autres paramètres : Alphabétique | Par fonction | |
C'est un pointeur global configurable vers le chemin du répertoire qui contient les fichiers des messages. Il fonctionne avec des tableaux associatifs comme indiqué ci-dessous. Les fichiers de messages sont attendus au format JSON et sont nommés avec le code de la langue, par exemple : en.json, de.json, etc. Les extensions pour lesquelles les messages se trouvent répartis à plusieurs endroits peuvent utiliser un tableau de répertoires.
L'approche moderne recommandée pour les extensions est de ne pas utiliser $wgMessagesDirs directement mais la clé équivalente dans extension.json.
Exemples
Exemple simple :
| PHP | extension.json |
|---|---|
$wgMessagesDirs['ConfirmEdit'] = __DIR__ . '/i18n';
|
"MessagesDirs": {
"ConfirmEdit": [
"i18n"
]
}
|
Exemple utilisant plusieurs répertoires :
| PHP | extension.json |
|---|---|
$wgMessagesDirs['VisualEditor'] = [
__DIR__ . '/i18n',
__DIR__ . '/modules/ve-core/i18n',
__DIR__ . '/modules/qunit/localisation',
__DIR__ . '/modules/oojs-ui/messages',
];
|
"MessagesDirs": {
"VisualEditor": [
"i18n",
"modules/ve-core/i18n",
"modules/qunit/localisation",
"modules/oojs-ui/messages"
]
}
|
$wgMessagesDirs peut coexister avec $wgExtensionMessagesFiles; les deux doivent être initialisés si vous voulez préserver la compatilbilité lors de la conversion des anciens fichiers PHP en fichiers l10n.