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)
Od 1.14 byl zaveden callback, aby bylo možné upravit parametry předané a související funkci. Může být použit ke změně parametrů, když jsou takové funkce volány přes LocalSettings.php (to je případ CentralAuth). Můžete to definovat v. Funkce zpětného volání obdrží objekt SiteConfiguration v prvním argumentu a název wiki ve druhém. Musí vrátit pole s následujícími klíči (vše volitelné):


 * : přípona webu (odpovídá $suffix paramater a podobně)
 * : jazyk webu
 * : pole wiki tagů (odpovídající parametru $wikiTags)
 * : pole parametrů, které mají být nahrazeny (odpovídající parametru $params)

Budou sloučeny s parametry předanými do a podobnými funkcemi. Pokud jsou vyplněny  a , použijí se k přepsání výchozího chování.



Sloučení nastavení
Pole lze nyní sloučit. To může být užitečné pro. Chcete-li jej použít, musíte před klávesy přidat "+" pro nastavení, která chcete sloučit.


 * Chcete-li sloučit svou upravenou verzi nastavení s tou v DefaultSettings.php, přidejte před název nastavení "+" (například )
 * Chcete-li sloučit specifičtější úroveň s méně specifickou, přidejte před úroveň "+".

Obě možnosti lze použít společně.

Sloučení probíhá v následujícím pořadí:


 * 1) Jméno databáze
 * 2) Značky (v pořadí poskytnutém metodě extrakce, která může být v tomto okamžiku velmi dobře náhodná)
 * 3) Přípona wiki
 * 4) Výchozí

Když je nalezen klíč, který nemá předponu "+", sloučení se ukončí.

Příklad s :

Základní syntaxe je tedy:

Příklad
Tento příklad používá 3 wiki:,   a. Jsou umístěny na adrese  (tj. ,   a  ).

Předpokládá, že  je již definován.

LocalSettings.php


pro 1.13 a starší


pro 1.14 a novější


Konfigurace Wikimedie
Chcete-li vidět, jak Wikimedie používá  ke konfiguraci svých wiki, podívejte se na:


 * CommonSettings.php (verze LocalSettings.php od Wikimedie)
 * InitialiseSettings.php (pro )
 * wgConf.php (používá CommonSettings.php k inicializaci $wgConf)



Související odkazy

 * Soubor  (nebo si jej prohlédněte na GitHubu), který poskytuje návod, jak $wgConf funguje, což může být srozumitelnější než tato stránka.