Manual:$wgConf/nl

Details
Maak een site-configuratieobject. Wordt niet veel gebruikt in een standaardinstallatie.

Dit wordt gebruikt op Wikimedia's massa-installatie om een gecentraliseerd configuratiebestand te leveren voor een paar honderd wiki's, met standaardinstellingen per sitegroep en per-wiki overrides.

Het kan echter een beetje verwarrend zijn. :) Op dit moment nodig door om informatie per-site op te halen, bijvoorbeeld door te linken naar de juiste gebruikerspagina's op elke wiki.

Configuratie
Wiki's zijn gegroepeerd door het achtervoegsel op hun databasenaam; op een grote installatie kunnen er bijvoorbeeld 'enwiki' en 'enwikibooks' zijn, elk in een andere achtervoegselgroep. Achtervoegsels moeten worden gedeclareerd in de  lidvariabele van $wgConf als u   wilt gebruiken.

is de reeks instellingen. Het formaat is. Instellingen kunnen worden toegewezen aan (van de meer specifieke naar de minder specifieke, dit is het  deel van   zoals hierboven vermeld):
 * een specifieke DB-naam.
 * een wiki-tag (sinds 1.12.0)
 * een achtervoegsel (bijvoorbeeld 'wiki' of 'wiktionary') om alles in die achtervoegselgroep te beïnvloeden (kan worden bepaald met )
 * 'default' om alle wiki's te beïnvloeden

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

Voor de stringinstellingen kunt u parameters definiëren die bij het uitpakken van de instellingen worden vervangen. Het kan nuttig zijn wanneer de instelling hetzelfde formaat heeft voor alle wiki's. Het formaat is. Wees voorzichtig met het gebruik van enkele aanhalingstekens of om e    te escapen of het zal worden vervangen door de PHP-variabele (die op dat moment niet kan worden gedefinieerd). 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 en eerder
Bij het uitpakken van globale instellingen zal het object eerst het meer specifieke niveau zoeken (het eerste niveau in de lijst hierboven) en als het de instelling niet vindt, zal het zoeken in minder specifieke niveaus. Als het er een vindt, zal het zoeken naar minder specifieke niveaus. Dit betekent dat u moet letten op enkele specifieke instellingen, zoals $GroupPermissions, omdat het de instelling niet samenvoegt met minder specifieke niveaus, noch de standaardwaarde (die in DefaultSettings.php), u zult het zelf moeten doen. 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.

Om de instellingen in globale variabelen uit te pakken, kunt u  gebruiken.

Parameters zijn:
 * : Wiki's database naam (over het algemeen $DBname). Je moet het zelf definiëren.
 * : Wiki's achtervoegsel, gebruikt om het achtervoegselniveau te krijgen.
 * : een reeks parameters die de naam van de Wiki aan zijn waarde koppelen.
 * : (sinds 1.12.0) array van wiki-tags.
 * - 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 en nieuwer
In 1.14.0 zijn enkele nieuwe functies toegevoegd. Het 1.13 en eerder deel kan echter nog steeds gebruikt worden.

Callback function
Sinds 1.14 is er een callback ingevoerd om de parameters die worden doorgegeven aan  en de bijbehorende functie te kunnen wijzigen. Het kan worden gebruikt om parameters te wijzigen wanneer dergelijke functies worden aangeroepen na LocalSettings.php (dit is het geval met CentralAuth). U kunt het definiëren in. De callback functie zal het SiteConfiguration object in het eerste argument ontvangen en de wiki naam in het tweede argument. Het moet een array teruggeven met de volgende key's (allemaal optioneel): 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 (komt overeen met $suffix paramater van  en dergelijke)
 * : site's lang
 * : reeks wiki-tags (overeenkomend met de parameter $wikiTags)
 * : array van te vervangen parameters (overeenkomend met $params parameter)

Ze worden samengevoegd met de parameters die worden doorgegeven aan  en soortgelijke functies. Als de  en   worden ingevuld, worden ze gebruikt om het standaardgedrag van   te overschrijven.

Samenvoegen van instellingen
Arrays kunnen nu worden samengevoegd. Dit kan nuttig zijn voor. Om ze te gebruiken, moet je bij de key's een "+" voor de instellingen plaatsen die je wilt samenvoegen. De twee mogelijkheden kunnen samen worden gebruikt.
 * Om uw aangepaste versie van de instelling samen te voegen met die in DefaultSettings.php, moet u de naam van de instelling voorvoegen met een "+" (zoals )
 * Om een meer specifiek niveau samen te voegen met een minder specifiek niveau, moet het niveau worden voorafgegaan door een "+".


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

Het samenvoegen gebeurt in de volgende volgorde:


 * 1) Databasenaam
 * 2) Tags (in de volgorde van de extractiemethode, die op dit punt heel goed willekeurig zou kunnen worden)
 * 3) Wiki achtervoegsel
 * 4) Standaard

Wanneer een toets wordt aangetroffen die niet voorafgegaan is door een "+", zal de samenvoeging eindigen.

Voorbeeld met :

De basissyntaxis is dus:

Voorbeeld
In dit voorbeeld worden 3 wiki's gebruikt:,   en. Ze staan op  (d.w.z. ,   en  ).

Het gaat ervan uit dat de  al gedefinieerd is.

Wikimedia-configuratie
Om te zien hoe Wikimedia  gebruikt om zijn wiki's te configureren zie:
 * [$common-set CommonSettings.php] (Wikimedia's versie van LocalSettings.php)
 * [$init-set InitialiseSettings.php] (voor )
 * [$wgconf wgConf.php] (gebruikt door CommonSettings.php om $wgConf te initialiseren)


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

Zie ook

 * Het  bestand (of bekijk het op GitHub), heeft een gids over hoe $wgConf werkt die misschien makkelijker te begrijpen is dan deze pagina.