Manual:$wgConf/hu

Részletek
A változó egy oldalkonfigurációs változót hoz létre; erre alapértelmezésben nincs sok szükség.

A beállítás a tömeges telepítéskor használva, amikor több száz wikinek kell egyetlen konfigurációs állományt létrehozni, illetve ekkor csoportonkénti alapértelmezéseket lehet létrehozni, amelyek wikinként felülírhatóak.

A beállítás mibenléte nem feltétlenül egyértelmű. :) Jelenleg a CentralAuth kiterjesztésnek van rá szüksége az oldalankénti információk (például az egyes felhasználói lapok hivatkozásainak) összegyűjtésére.

Konfiguráció
A wikik csoportosítása az adatbázisbéli nevük előtagja alapján történik; nagyobb telepítéseknél például „huwiki”, „huwiktionary” és „huwikibooks”; ezek mindegyike külön előtag-csoportot alkot. Az előtagokat a $wgConf  alváltozójában kell definiálni, ha a   formát használnád.

A  a beállítások tömbje, kitöltése a   formában történik. A következőket kell konfigurálni a fent említett  változó   részében:
 * adatbázis neve
 * wikicímke (az 1.12.0 óta)
 * előtag (például „wiki” vagy „wiktionary”), amely a csoport minden tagjára vonatkozik (meghatározható a  formával)
 * 'default', ha minden wikire vonatkozik.

A sztringek esetén a beállítások során behelyettesítendő paramétereket adhatsz meg; ez akkor hasznos, ha a konfigurációs érték formája minden wikin megegyezik. Ez alapértelmezésben ; figyelj arra, hogy használj aposztrófokat, illetve emeld ki a   jelet , különben értéke a PHP nem definiált változójával lesz felülírva.

1.13 és korábbi verziók
A globális beállítások kibontásakor az objektum először a leginkább specifikált szinten (a fenti listában az első) fog keresni; ha itt nem találja a konfigurációs értéket, akkor folyamatosan továbbhalad; ha megtalálta, akkor megáll. Figyelj egyes specifikus változók (például ) helyes beállítására, mivel sem a kevésbé specifikus szintek, sem az alapértelmezett érték (a DefaultSettings.php-ban található) nem lesznek összefésülve, ezt neked kell megtenni.

A globális változók beállításainak kibontásához a  forma használható.

Ennek paraméterei:
 * : a wiki adatbázisának neve (általában ); neked kell megadnod
 * : a wiki előtagja, az előtag szintjének meghatározására
 * : értékekhez rendelt paraméterek neveinek tömbje
 * : wikicímkék tömbje (az 1.1.2.0 verzió óta)

1.14 és újabb verziók
Az 1.14.0 verzióban néhány új funkciót adtunk hozzá, azonban a korábbiak is használhatóak.

Callback function
Since 1.14, a callback has been introduced to be able to modify the parameters passed to  and related function. It might be used to change parameters when such functions are called after LocalSettings.php (this is the case with CentralAuth). You can define it in. The callback function will receive the SiteConfiguration object in the first argument and the wiki name in the second one. It has to return an array with the following keys (all optional): They'll be merged with the parameters passed to  and similar functions. If the  and   are filled, the they'll be used to override the default behaviour of.
 * : site's suffix (corresponding to $suffix paramater of  and similar)
 * : site's lang
 * : array of wiki tags (corresponding to $wikiTags parameter)
 * : array of parameters to be replaced (corresponding to $params parameter)

Settings merging
Arrays can now be merged. This might be useful for. To use it, you have to prefix the keys with a "+" for the settings you want to merge. The two possibilities can be used together.
 * To merge your customized version of the setting with the one in DefaultSettings.php, prefix the setting's name with "+" (such as )
 * To merge a more specific level with a less-specific one, prefix the level with a "+".

Merging happens in the following order:


 * 1) Database name
 * 2) Tags (in the order provided to the extraction method, which might very well be randomized at this point)
 * 3) Wiki suffix
 * 4) Default

When a key is encountered that is not prefixed with "+", the merging will end.

Example with :

The basic syntax is thus:

Example
This example uses 3 wikis:,   and. They are located at  (i.e. ,   and  ).

It assumes that  is already defined.

Wikimedia configuration
To see how Wikimedia uses  to configure its wikis see:
 * CommonSettings.php (Wikimedia's version of LocalSettings.php)
 * InitialiseSettings.php (for )
 * wgConf.php (used by CommonSettings.php to initialize $wgConf)