Aide:Extension:Translate/Configuration des groupes/MediaWiki

Ce document indique comment configurer des groupes d'extensions MediaWiki en utilisant simplement le fichier texte de configuration. Il est utile si vous possédez des centaines d'extensions.

Cette configuration se trouve dans LocalSettings.php du répertoire MediaWiki.

require "$IP/extensions/Translate/Translate.php";

$wgHooks['TranslatePostInitGroups'][] = function ( &$list, &$deps, &$autoload ) {
	$def = "/path/to/mediawiki-extensions.txt";
	$path = '%GROUPROOT%/extensions/';

	$parser = new PremadeMediawikiExtensionGroups( $def, $path );
	$parser->register( $list, $deps, $autoload );

	return true;
};

Fichier de configuration

Voici un exemple de fichier de configuration :

Simple Extension

Complex Extension
desc = Some text here.
ignored = sidebar, robots.txt
optional = grouppage-recursive-export
prefix = wmf- | sidebar, grouppage-Staff, group-Staff, group-Staff-member
aliasfile = ComplexExtension.alias.php
magicfile = ComplexExtension.magic.php

La syntaxe générale est : NomDeLextension suivi de la liste des clés et des valeurs et d'une ligne vide précédant l'extension suivante.

ExtensionName - Nom de l'extension en ayant supprimé les espaces.

Les clés disponibles sont :

aliasfile

Emplacement du fichier contenant les traductions des alias des pages spéciales pour cette extension relativement à $wgTranslateExtensionDirectory

desc

Description de l'extension affichée aux traducteurs

descmsg

Une page dans l'espace de noms MediaWiki contenant la description de l'extension affichée aux traducteurs

file

Emplacement du fichier contenant les messages pour cette extension. La valeur par défaut dépend du format :

• php: ExtensionName/ExtensionName.i18n.php
• json: ExtensionName/i18n/%CODE%.json

format

format du fichier utilisé par l'extension. Les valeurs reconnues sont php et json. Valeur par défaut : format = php

id

ID du groupe de messages. La valeur par défaut est le nom de l'extension (ExtensionName) en minuscules préfixé par ext-. Par exemple, Complex Extension a pour identifiant par défaut ext-complexextension

ignored

Liste des clés de message (non affichées pour les traducteurs) séparées par des virgules. Cette clé peut être présente plusieurs fois pour segmenter la liste sur plusieurs lignes.

magicfile

Chemin du fichier contenant des traductions des mots magiques pour cette extension par rapport à $wgTranslateExtensionDirectory

optional

Liste des clés de message (affichées pour les traducteurs seulement s'ils choisissent de voir les messages optionnels) séparées par des virgules. Les messages facultatifs ne sont pas comptés comme des messages non traduits, mais les messages facultatifs traduits sont comptés comme des messages traduits. Cette clé peut être présente plusieurs fois.

prefix

Pour gérer les clés de message contradictoires, vous pouvez préfixer les messages donnés. La syntaxe est d'abord de disposer du préfixe séparé par une barre verticale de la liste des clés de message séparées par des virgules. Cette clé peut être présente plusieurs fois.

var

Nom de la variable php contenant les messages. Par défaut $messages.