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.

Visszahívás
Az 1.14 verzióban egy visszahívási funkciót vezettünk be, amellyel a  és a kapcsolódó funkcióknak átadott paraméterek módosíthatóak. Ez hasznos lehet a paraméterek módosításakor, ha ezen funkciók a LocalSettings.php-ban meghívásra kerülnek (mint például a CentralAuth esetében). A működés a -ben konfigurálható. A visszahívási funkció első argumentuma a SiteConfiguration-objektum, a második pedig a wiki neve. Visszatérési értéke a következő kulcsokat tartalmazza (mindegyik opcionális): Ezen kulcsok össze lesznek vonva a -nek átadott paraméterekkel. Ha a  és   paraméterek ki vannak töltve, akkor tartalmuk a  -ben rögzített alapértelmezett viselkedést felülírja.
 * : az oldal előtagja (a  és hasonlók $suffix paraméterével összhangban)
 * : az oldal nyelve
 * : wikicímkék tömbje (a $wikiTags paraméterrel összhangban)
 * : cserélendő paraméterek tömbje (a $params paraméterrel összhangban).

Beállítások összefésülése
Lehetséges a tömbök összefésülése, amely a -szal való használatkor lehet hasznos. Az összefűzendő paraméterek közé ehhez egy +-jelet kell tenned. A két előfordulás ezután együtt használható.
 * A testre szabott, illetve a DefaultSettings.php-ban található beállítások összefésüléséhez a változó elé +-jelet kell tenned (például )
 * Különböző specifikációs szintű beállítások összefésüléséhez a szint elé kell + jelet tenned.

Az összefűzés a következő sorrendben történik:


 * 1) Adatbázisnév
 * 2) Címkék (a kibontási metódus által meghatározott módon, amely ezen a ponton véletlenszerű lehet)
 * 3) Wiki-előtag
 * 4) Alapértelmezés

Ha egy kulcs előtt nem szerepel a +-jel, az összefésűlés véget ér.

Példa a -ra:

Az alapértelmezett szintaxis a következő:

Példa
Az alábbi példában három wiki szerepel:,   és. Ezek helye:  (pl.: ,   and  ).

Feltételezzük, hogy a  már ki van töltve.

Wikimédia-konfiguráció
Ha érdekel, hogy a Wikimédia-wikik hogy használszák a -ot, lásd a következőket:
 * CommonSettings.php (a LocalSettings.php Wikimédia-verziója)
 * InitialiseSettings.php (a -hez)
 * wgConf.php (A CommonSettings.php használja a $wgConf inicializálásához).

Lásd még

 * állomány (vagy lásd GitHubon) – a $wgConf működését és ezen lap megértését segítő információkat tartalmaz