Manual:$wgConf/cs

Podrobnosti
Vytvoří objekt konfigurace webu. Ve výchozí instalaci se příliš nepoužívá.

Toto se používá při hromadné instalaci Wikimedie k poskytnutí centralizovaného konfiguračního souboru pro několik stovek wiki, poskytujících výchozí hodnoty pro skupinu stránek a přepisy pro wiki.

Může to být ale trochu matoucí. :) Aktuálně je potřeba k načtení informací o jednotlivých stránkách, např. odkazování na správné uživatelské stránky na každé wiki.

Konfigurace
Wiki jsou seskupeny podle přípony na názvech jejich databází. Na velké instalaci může být např. 'enwiki' a 'enwiktionary' a 'enwikibooks', každá v jiné skupině přípon. Chcete-li použít, musí být přípony deklarovány v členské proměnné  $wgConf.

je pole nastavení. Jeho formát je.

Nastavení lze přiřadit (od specifičtějšího po méně konkrétní, toto je část , jak je uvedeno výše):


 * konkrétní název DB.
 * značka wiki (od 1.12.0)
 * přípona (např. 'wiki' nebo 'wikislovník'), která ovlivní všechny v této skupině přípon (lze určit pomocí )
 * 'výchozí' ovlivní všechny wikiny

Pro nastavení řetězce můžete definovat parametry, které budou nahrazeny při extrahování nastavení. Může být užitečné, když má nastavení stejný formát pro všechny wikiny. Formát je. Dejte pozor, abyste používali jednoduché uvozovky nebo kód  , jinak bude nahrazen proměnnou PHP (tj. nelze v té době definovat).



1.13 a starší
Při extrahování globálních nastavení bude objekt hledat nejprve konkrétnější úroveň (první v seznamu výše) a pokud nastavení nenajde, bude hledat v méně konkrétních úrovních. Když to najde, pokud nebude hledat méně konkrétní. To znamená, že musíte věnovat pozornost některým specifickým nastavením, jako je, protože neslučuje nastavení s méně specifickými úrovněmi, ani výchozí hodnotu (ta v DefaultSettings.php), kterou budete muset vytvořit sami.

Chcete-li extrahovat nastavení v globálních proměnných, můžete použít.

Parametry jsou:
 * - Název databáze Wiki (obecně ). Musíte si jej definovat sami.
 * - Přípona Wiki, používaná k získání úrovně přípony.
 * - pole parametrů mapujících jeho název na jeho hodnotu.
 * - pole wiki tagů.



1.14 a novější
Ve verzi 1.14.0 byly přidány některé nové funkce. Část 1.13 a starší však může být stále používána.



Funkce zpětného volání (Callback)
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):


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

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.

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.


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

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)