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 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
Lors de l'extraction des paramètres globaux, l'objet sera d'abord recherché au niveau le plus spécifique (le premier dans la liste ci-dessus) et, s'il n'est pas trouvé, il sera cherché dans les niveaux moins spécifiques. Quand il est trouvé, il n'est pas cherché dans de moins spécifiques. Cela veut dire que vous devez faire attention à certains paramètres spécifiques, comme, car s'ils ne correspondent pas au paramètre de niveaux moins spécifiques, ni à la valeur par défaut (celle dans DefaultSettings.php), vous deverz le faire par vous-mêmes.

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

Les paramètres sont:
 * - Nom de base de données du wiki (en général ). Vous devez le définir par vous-mêmes.
 * - Suffixe du wiki, utilisé pour obtenir le niveau de suffixe.
 * - tableau de paramètres faisant correspondre son nom à sa valeur.
 * - tableau de balises wiki.

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
Depuis 1.14, un callback a été introduit pour pouvoir modifier les paramètres passés à  et la fonction associée. Il peut être utilisé pour modifier les paramètres lorsque de telles fonctions sont appelées après LocalSettings.php (c’est le cas avec CentralAuth). Vous pouvez le définir en. La fonction callback recevra l’objet SiteConfiguration dans le premier argument et le nom wiki dans le second. Il doit renvoyer un tableau avec les clés suivantes (toutes optionnelles):


 * : suffixe du site (correspondant à $suffix paramater de et similaire)
 * : langue du site
 * : tableau des tags wiki (correspondant au paramètre $wikiTags)
 * : tableau de paramètres à remplacer (correspondant au paramètre $params)

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.

Fusion des paramètres
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) nom de la base de données
 * 2) Tags (in the order provided to the extraction method, which might very well be randomized at this point)
 * 3) Wiki suffix
 * 4) Défaut

When a key is encountered that is not prefixed with "+", the merging will end.

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.

Configuration de Wikimedia
To see how Wikimedia uses  to configure its wikis see:


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

Voir aussi

 * The  file (or view it on GitHub), which gives a guide on how $wgConf works which might be easier to understand than this page.