Manuel:$wgMessagesDirs

This page is a translated version of the page Manual:$wgMessagesDirs and the translation is 100% complete.
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 :[]

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.

Voir aussi