Manual:$wgConf/fr

Détails
Crée un objet de configuration de site. Non utilisé pour la plus grande partie dans une installation par défaut.

Ce paramètre est utilisé dans une installation de masse de Wikimedia pour fournir un fichier de configuration centralisé pour une centaine de wikis, fournissant des valeurs par défaut par groupe de sites et des écrasements par wiki.

Cela peut sembler un peu déroutant, toutefois. :) Actuellement, il est nécessaire pour CentralAuth pour parcourir les informations par site, par ex. lier les bonnes pages utilisateur sur chaque wiki.

Configuration
Les wikis sont groupés par le suffixe de leurs noms de base de données; sur une grande installation, il peut par exemple y avoir 'enwiki' et 'enwiktionary' et 'enwikibooks', chacun dans un groupe de suffixe différent. Les suffixes doivent être déclarés dans la variable de membre  de $wgConf si vous voulez utiliser.

est le tableau de sparamètres. Son format est.

Les paramètres peuvent être assignés à (du plus spécifique au moins spécifique, c'est la partie  mentionné ci-dessus):
 * un nom de base de données spécifique
 * une balise wiki (depuis 1.12.0)
 * un suffixe (par ex. 'wiki' ou 'wiktionary') pour affecter tous ceux qui sont dans ce groupe de suffixe (peut être déterminé avec )
 * 'default' pour affecter tous les wikis

Pour les paramètres chaîne, vous pouvez définir des paramètres qui seront remplacés lors de l'extraction des paramètres. Cela peut être utile quand le paramètre a le même format pour tous les wikis. Le format est. Faites attention d'utiliser des apostrophes simples ou d'échapper le    sinon il sera remplacé par la variable PHP (qui peut ne pas être définie à ce moment-là).

1.13 et précédents
When extracting global settings, the object will search first the more specific level (the first one in the list above) and if it doesn't find the setting, it will search in less specific levels. 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.

Pour extraire les paramètres dans les variables globales, vous pouvez utiliser.

Parameters are:
 * : 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.
 * : (since 1.12.0) array of wiki tags.

1.14 et suivants
Certaines fonctionnalités nouvelles ont été ajoutées en 1.14.0. La partie 1.13 et précédents peut toutefois toujours être utilisée.

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

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. The two possibilities can be used together.
 * 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 "+".

Example with :

The basic syntax is thus:

Exemple
This example uses 3 wikis:,   and. They are located at  (i.e. ,   and  ).

It assumes that  is already defined. In this example,  is declared in InitialiseSettings.php, this is not required and can be done in LocalSettings.php.

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)