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

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

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

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


 * : 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)

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.

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 "+".


 * 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) 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:
 * [$common-set CommonSettings.php] (A versão da Wikimedia do LocalSettings.php)
 * [$init-set InitialiseSettings.php] (para )
 * [$wgconf wgConf.php] (utilizado pelo CommonSettings.php para inicializar $wgConf)


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