Manual:$wgConf/pt-br

Detalhes
Cria um objeto de configuração do site. Não é muito usado em uma instalação padrão.

Isto é usado na instalação em massa do Wikimedia para fornecer um arquivo de configuração centralizada para algumas centenas de wikis, fornecendo padrões por grupo de sites e substituições por wiki.

Pode ser um pouco confuso, no entanto. :) Atualmente necessário pela extensão para buscar informações por site, por exemplo, links para as páginas de usuário apropriados em cada wiki.

Configuração
Wikis são agrupadas pelo sufixo em seus nomes do banco de dados; em uma grande instalação pode ser, por exemplo, 'ptwiki' e 'ptwiktionary' e 'ptwikibooks', cada um em um grupo de sufixo diferente. Sufixos precisam ser declarados na  variável-membro de $wgConf se você quiser usar.

é o array de configurações. Seu formato é.

As definições podem ser atribuídas (do mais específico para o menos específico, esta é a parte  de   conforme mencionado acima):
 * um nome de banco de dados específico.
 * uma wiki tag (desde aversão 1.12.0)
 * um sufixo (p.ex. 'wiki' or 'wiktionary') para afetar todos nesse grupo de sufixos (pode ser determinado com )
 * 'default' para afetar todas as wikis

Para as configurações de strings, você pode definir parâmetros que serão substituídos ao extrair as definições. Pode ser útil quando o ajuste tem o mesmo formato para todas as wikis. O formato é. Tenha cuidado ao usar aspas simples ou tirar o    ou ela será substituída pela variável PHP (que não pode ser definida no momento).

Versão 1.13 e anteriores
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.

To extract the settings in global variables, you can use.

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.

Versão 1.14 e mais recentes
Alguns novos recursos foram adicionados na versão 1.14.0. A versão 1.13 e anteriores ainda podem ser usadas​​, no entanto.

Função de retorno
Desde a versão 1.14, uma chamada de retorno foi introduzida para poder modificar os parâmetros passados ​​para  e funções relacionadas. Ele pode ser usado para alterar os parâmetros quando essas funções são chamadas após o arquivo LocalSettings.php (este é o caso com CentralAuth). Você pode defini-lo em. A função de retorno de chamada tht-e receberá o objeto SiteConfiguration no primeiro argumento e o nome da wiki no segundo. Ela tem que retornar um array com as seguintes chaves (todas opcionais): Eles vão ser mesclados com os parâmetros passados ​​para  e funções similares. Se  e   estão preenchidos, eles podem ser usados ​​para substituir o comportamento padrão de.
 * : sufixo do site (correspondente ao parâmetro $suffix de   e similar)
 * : idioma do site
 * : array de tags wiki (correspondente ao parâmetro $wikiTags)
 * : array de parâmetros a serem substituídos (correspondente ao parâmetro $params)

Fusão de definições
Arrays podem agora ser mesclados. Isso pode ser útil para o. Para usá-lo, você tem que anteceder as teclas com um sinal de mais "+" para as definições que deseja mesclar. As duas possibilidades podem ser utilizadas em conjunto.
 * Para mesclar sua versão personalizada da definição com a do DefaultSettings.php, prefixar o nome da definição com "+" (tal como )
 * Para mesclar um nível mais específico com um menos específico, prefixar o nível com um "+".

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.

Exemplo com :

A sintaxe básica é da seguinte forma:

Exemplo
Este exemplo usa 3 wikis:,   e. Elas estão localizadas em  (ou seja, ,   and  ).

Ele assume que  já está definido.

Configuração da Wikimedia
Para ver como a Wikimedia usa  para configurar suas wikis consulte:
 * CommonSettings.php (A versão da Wikimedia do LocalSettings.php)
 * InitialiseSettings.php (para )
 * wgConf.php (utilizado pelo CommonSettings.php para inicializar $wgConf)