Toto je dokumentace, jak nastavit skupiny rozšíření MediaWiki pomocí jednoduchého textového konfiguračního souboru. Je to užitečné, pokud máte stovky rozšíření.

Tato konfigurace se vkládá do LocalSettings.php v adresáři 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;
};

Konfigurační soubor

Zde je příklad konfiguračního souboru:

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

Obecná syntaxe je: Název přípony následovaný seznamem klíčů a hodnot a jeden prázdný řádek před další příponou.

ExtensionName - Název přípony s odstraněnými mezerami.

Dostupné klíče jsou:

aliasfile

Umístění souboru obsahujícího speciální překlady aliasů stránky pro toto rozšíření vzhledem k $wgTranslateExtensionDirectory

desc

Popis rozšíření zobrazenému překladatelům

descmsg

Stránka ve jmenném prostoru MediaWiki obsahující popis rozšíření zobrazovaného překladatelům

file

Umístění souboru obsahujícího zprávy pro toto rozšíření. Výchozí hodnota závisí na formátu:

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

format

Formát souboru používaný příponou. Podporované hodnoty jsou php a json. Výchozí: format = php

id

ID skupiny zpráv Výchozí hodnota je ExtensionName napsaná malými písmeny s předponou ext-. Například „Complex Extension“ má výchozí ID „ext-complexextension“

ignored

Seznam klíčů zpráv oddělených čárkami, které se překladatelům nezobrazí. Tento klíč může být přítomen vícekrát, aby bylo možné rozdělit seznam na více řádků.

magicfile

Umístění souboru obsahujícího překlady kouzelných slov pro toto rozšíření vzhledem k $wgTranslateExtensionDirectory

optional

Seznam klíčů zpráv oddělených čárkami, které se zobrazí překladatelům, pouze pokud se rozhodnou zobrazit volitelné zprávy. Nepovinné zprávy se nepočítají jako nepřeložené zprávy, ale přeložené nepovinné zprávy se počítají jako přeložené. Tento klíč může být přítomen vícekrát.

prefix

Chcete-li zpracovat konfliktní klíče zpráv, můžete předřadit dané zprávy. Syntaxí je nejprve mít předponu oddělenou svislou čarou od seznamu klíčů zpráv oddělených čárkami. Tento klíč může být přítomen vícekrát.

var

Název proměnné php obsahující zprávy. Výchozí hodnota je $messages.