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 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.

Settings may be assigned to (from the more specific to the less specific, this is the  part of  as mentioned above):


 * a specific DB name.
 * a wiki tag (since 1.12.0)
 * a suffix (eg 'wiki' or 'wiktionary') to affect all in that suffix group (can be determined with )
 * 'default' to affect all wikis

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. It can be useful when the setting has the same format for all wikis. The format is. Be careful to use single quotes or to escape the    or it will be replaced with the PHP variable (that can be not defined at that time).



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 $GroupPermissions) 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. When it finds one, if won't search for less specific ones. This means that you have to pay attention for some specific settings, such as, because it doesn't merge the setting with less specific levels, nor the default value (the one in DefaultSettings.php), you'll need to do it by yourself.

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

Ennek paraméterei:
 * - Wiki's database name (generally ). You have to define it yourself.
 * - Wiki's suffix, used to to get the suffix level.
 * - array of parameters mapping its name to its value.
 * - array of wiki tags.



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): 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):


 * : 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).

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.



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.


 * 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 "+".

The two possibilities can be used together.

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.

LocalSettings.php


1.13 és korábbi verziók esetében


1.14 és újabb verziók esetében


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


 * CommonSettings.php (Wikimedia's version of LocalSettings.php)
 * InitialiseSettings.php (for )
 * wgConf.php (used by CommonSettings.php to initialize $wgConf)



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