Manual:LocalSettings.php/pt-br

O arquivo   fornece configurações locais (com base no arquivo ) de uma instalação do MediaWiki. Você deve tomar o seu tempo para revisar as configurações neste arquivo. O arquivo é normalmente gerado pelo instalador MediaWiki baseado na web, mas você pode querer ajustar alguns dos parâmetros, possivelmente em conjunto com as configurações do Apache. Para instalações do MediaWiki configuradas como wiki farms, um arquivo chamado   pode ser usado. As alterações entrarão em vigor imediatamente após salvar o arquivo: não há necessidade de reiniciar nada manualmente. Em alguns casos pode ser necessário limpar o cache do seu navegador para ver as alterações.

The LocalSettings.php file is not a wiki page and you cannot access it with your web browser. Instead, it is a file in the file system of the server. Its contents are generated during the initial setup of the wiki and the resulting file must be copied on the server manually. The file must be located in the folder you installed MediaWiki into, on the same level with folders like "includes/" or "skins/" and files like "api.php". If this file is not there, the wiki will not work at all - if the wiki does work, the file is there. If you do not know, where it is, you can run this command  on the UNIX shell to make your server show you, where the file actually is

Tenha em mente que as permissões do LocalSettings.php devem impedir que outros usuários vejam este arquivo, pois ele contém dados relacionados à segurança, incluindo a senha do usuário do banco de dados. O chmod 700 ou outro definem as permissões para algo que fornece segurança de acesso público. O usuário do banco de dados só precisa ter permissões SELECT, INSERT, UPDATE and DELETE no banco de dados. Veja também o arquivo AdminSettings.php (até o MediaWiki 1.16) que define as configurações para um usuário do MySQL que tenha permissões de superusuário do banco de dados para executar os scripts de manutenção.

Additionally, you can create a MySQL user, who is restricted to only the database used by the wiki and provide this user's credentials in LocalSettings.php. Also can you configure your database server to only accept connections from localhost - this should prevent access from outside in case of leaked credentials.

When you edit LocalSettings.php, make sure to save it in the right encoding again. You should use "ANSI as UTF-8" encoding - that is UTF-8 encoding without byte order mark (BOM).

Alterar uma configuração geralmente significa mudar o valor de uma variável PHP. Você pode querer se familiarizar com a sintaxe PHP primeiro antes de ir adiante. Como regra geral, lembre-se que as variáveis ​​do PHP são acessadas​​, antecedendo um caractere "$" antes do nome da variável, muitas variáveis ​​são simplesmente definidas como  ou.

Os valores padrão de muitas outras configurações estão definidos em includes/DefaultSettings.php, que não devem ser editados; se a variável que você deseja alterar não estiver mencionada no seu LocalSettings.php, copie a linha apropriada de DefaultSettings e modifique-a de forma adequada. Dentro do LocalSettings.php você pode adicionar novas linhas no final. Todas essas linhas certamente devem aparecer abaixo da linha 'require_once "includes/DefaultSettings.php";.

Dentro do arquivo também pode haver várias linhas, tais como 'require_once "extensions/extension.php";', que fazem ligação a outras extensões habilitadas na wiki. Estas extensões podem requerer a definição dos valores de mais variáveis ​​no LocalSettings.php; verifique a documentação da extensão para obter mais instruções. A lista de extensões está disponível em Extension Matrix.

A sua versão do LocalSettings.php pode não terminar com uma tag de fechamento PHP ?&gt;</tt>. Isso é feito de propósito, uma vez que impede as pessoas de acidentalmente adicionar novas informações após esta tag. PHP funcionará muito bem sem a tag de fechamento.

Se você tem uma wiki em um serviço de hospedagem MediaWiki, você pode não ter acesso de gravação (talvez nem mesmo de acesso de leitura) para o arquivo LocalSettings.php (veja p.ex.este forum no Wikia). A empresa de hospedagem wiki pode ou não estar disposta a fazer as mudanças que você deseja. Talvez ela queira manter a maioria das configurações do mesmo em todas as wikis da hospedagem wiki.

Consulte o índice de configurações e os comentários incluídos nos arquivos de configurações para ajuda sobre o que todas as variáveis fazem. Uma breve listagem das variáveis ​​mais importantes, bem como as características mais solicitadas, está colocada abaixo.

Caminho de instalação
A variável $IP (include path) detém o caminho do arquivo local para a instalação base do seu wiki. Certifique-se de consultar o caminho de arquivo completo. Não inclua uma barra no final do caminho.

O arquivo DefaultSettings.php é carregado a partir do diretório designado pela variável IP.

Nome do site
A variável $wgSitename contém o nome da configuração da sua wiki. Este nome é incluído muitas vezes ao longo do sistema, como via MediaWiki: PageTitle. Por exemplo, o slogan da Wikipédia "'Wikipédia, a enciclopédia livre."' faz uso dessa configuração.

Idioma do site
A variável $wgLanguageCode controla o idioma de interface de sua wiki. Enquanto os usuários registrados podem alternar o idioma que eles vêem em suas preferências, esta variável define o idioma padrão que todos os usuários anônimos e a maioria usuários registrados vêem.

Declinação do site name
Algumas traduções de interface estão prontos para a inflexão do nome do site. Você pode definir formas adequadas de palavra em variáveis $wgGrammarForms.

Caminho do script principal
$wgScriptPath é o prefixo do URL para acessar o script principal do MediaWiki que é a peça central da atuação do código do MediaWiki. Essa configuração deve corresponder às configurações do Apache, especialmente se você estiver usando as regras de reescrita do Apache.

Nome do servidor
$wgServer pode ser usado opcionalmente para substituir a detecção automática. Quando o wiki é acessado a partir de qualquer localhost onde ele é executado, a partir de uma intranet ou da Internet, notificações por e-mail e algumas outras mensagens computadorizadas seriam normalmente entregues com diferentes URLs. Ao utilizar o  é substituída a detecção, e o nome do servidor será constante.

Se www.example.com é o endereço do servidor do seu wiki, como visto a partir da Internet, adicione uma linha da seguinte maneira:

A palavra mágica  pode ser usada em páginas wiki; é igual ao valor de  ; no entanto, em uma wiki, como as da família Wikimedia, onde são usadas URLs relativas, não vai expandir totalmente, por exemplo, aqui ele exibe, que pode nem ser clicado nem copiado e colado na barra de endereços como ele está.

Nome do script principal
$wgScript é o nome do script PHP principal (índice) do MediaWiki, chamado index.php</tt> por padrão. Alterar o nome do script provavelmente não é uma boa idéia. No entanto, se você sentir vontade de fazê-lo, este é o lugar para fazer as alterações. Certifique-se de que você sabe o que está fazendo.

Nome do script de redirect
A variável $wgRedirectScript especifica a URL do script de redirecionamento que lida com redirecionamentos no MediaWiki. Esta configuração é semelhante ao wgScript pois é possível configurar o nome exato do script. Como mencionado acima, isso provavelmente não é uma boa idéia, a menos que você realmente saiba o que está fazendo.

Caminho dos artigos
$wgArticlePath é o caminho a ser usado ao acessar uma página no MediaWiki. O caminho deve conter o caminho para o script principal (geralmente fazendo uso do ) e utilizar o espaço reservado $1</tt> para o nome do artigo.

Se você estiver usando regras de reescrita do Apache para criar bonitas e curtas URLs, você provavelmente precisará ajustar  para abordar o caminho certo. Observe que o wgArticlePath é usado para construir URLs a partir do MediaWiki. Se você cometer um erro aqui, links internos aparecerão de forma incorreta, enquanto você ainda puder acessar a página principal, especificando a URL correta manualmente. Veja Manual:Short URL para mais informações sobre configuração de URL.

Os valores típicos são:

Local de estilos CSS
Use a variável $wgStylePath para definir o caminho da URL para o local onde as folhas de estilo (CSS) para a instalação MediaWiki estão localizadas. A variável $wgStyleDirectory deve apontar o mesmo lugar, mas note que este é um caminho de sistema de arquivos local para uso em scripts internos acessam o sistema de arquivos.

Local para uploads
O diretório de upload é o local onde os arquivos enviados pelos usuários são armazenados. A variável $wgUploadPath especifica a URL, enquanto a variável $wgUploadDirectory aponta para o caminho do sistema de arquivos local.

Logo
A variável $wgLogo especifica qual o logotipo gráfico é exibido no canto superior esquerdo de todas as páginas do MediaWiki. Estes passos substituirão o logotipo padrão no diretório /wiki/skins/common/images/, substituindo /wiki com o caminho para o diretório onde você instalou o software MediaWiki.

Primeiro, copie qual o logotipo que você quer para o diretório /wiki/skins/common/images/ (substituindo /wiki com o caminho para o diretório onde você instalou o software MediaWiki).

Em seguida, tente encontrar a linha parecida com o exemplo a seguir no :

Se não existe tal linha, você pode copiar e colar a linha acima no final do arquivo.

Em seguida, modificar essa linha para apontar para o seu logotipo. O logotipo deve estar acessível. O valor desta variável é passado para o navegador web, que a utiliza para buscar o logotipo. Em caso de dúvida, uma boa maneira de escolher o que colocar aqui é navegar para o logotipo em seu navegador (por exemplo, nesta wiki a url do logotipo é http://upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png ), e colocar a url completa como valor desta variável.

Algumas pessoas simplesmente substituem o arquivo skins/common/images/wiki.png com seu logotipo. Isso não é recomendado, já que o logotipo personalizado seria substituído na atualização.

Informações para contato
A variável $wgEmergencyContact é o endereço de e-mail do usuário para entrar em contato quando as coisas acontecem. Este endereço de e-mail é usado para enviar relatórios de erros internos. Como administrador, você pode incluir o seu endereço de e-mail aqui.

A variável $wgPasswordSender é o endereço de e-mail a partir de onde o e-mail é enviado, quando as senhas são enviadas para usuários que esqueceram suas senhas. Escolha um endereço de pessoas para responder em caso de problemas ou confusão.

Configurações de banco de dados
O MediaWiki precisa ter acesso ao banco de dados (atualmente, seja MySQL ou PostgreSQL) para armazenar páginas, modificações, informações sobre o usuário, e muito mais coisas.

A variável $wgDBserver contém o nome da máquina onde o banco de dados está hospedado. Na maioria dos casos, ele será apenas "localhost" quando o banco de dados é executado no mesmo sistema, mas para instalações distribuídas, você precisa preencher o domínio completo do computador que está executando o banco de dados.

$wgDBname é o nome da base de dados a ser utilizada pelo MediaWiki. Uma única instalação MySQL ou PostgreSQL pode armazenar mais de um banco de dados e você pode até mesmo executar muitas instalações MediaWiki em um único servidor. Certifique-se de ter declarado o nome do banco de dados correto aqui e usar nomes de bancos de dados diferentes para diferentes instalações wiki no mesmo servidor de banco de dados.

As variáveis $wgDBuser e $wgDBpassword contêm o nome de login e senha a ser usados pelo MediaWiki para acessar o banco de dados. Verifique se o usuário especificado tem os direitos de acesso apropriados para poder manipular a tabela wiki no servidor de banco de dados.

Direitos de usuário
A variável $wgGroupPermissions é um array associativo, que controla as permissões para criação e edição de páginas para seus grupos de usuários diferentes. Neste array, níveis de permissão personalizados podem ser criados, e os níveis de permissão para os diferentes grupos de usuários podem ser configurados. Veja Help:User rights para mais informações sobre as diferentes permissões e grupos de usuários disponíveis.

Forçar ligações capitalizadas
Por padrão, nenhum nome da página pode começar com uma letra romana minúscula: na tentativa de fazê-lo a primeira letra é convertida em maiúsculas, se um destino do link, incluído página, imagem ou categoria é especificado com um nome que começa com uma letra minúscula, o alvo real etc é a página começando com a capitalização correspondente.

Alternativamente, nomes de página podem começar com uma letra minúscula, além de a possibilidade de iniciar com um capital, um dígito, etc. Para isso você deve ajustar a variável $wgCapitalLinks para false, que permite caracteres minúsculos, ou true, que escolhe o comportamento padrão.

Habilitando subpáginas
No arquivo localsettings.php, subpáginas são habilitadas em uma base por namespace usando a variável $wgNamespacesWithSubpages. Por exemplo, para permitir subpáginas no namespace principal:

Upload de imagens
Antes que os usuários tenham permissão para fazer upload de arquivos para o sistema MediaWiki, você tem que habilitar esse recurso. Verifique se o diretório de upload está devidamente configurado e gravável pelo processo do servidor web Apache. Em seguida, defina a variável $wgEnableUploads para true a fim de permitir upload na interface de usuário web.

i.e. Aqui está um exemplo de código de includes/DefaultSettings.php para inserir no LocalSettings.php. Se você quer poder redimensionar imagens em tempo real para apoiar as miniaturas, o MediaWiki precisa de uma instalação do ImageMagick funcionando. Defina as variáveis $wgUseImageResize e $wgUseImageMagick como true depois de ter instalado e testado o ImageMagick em seu sistema. Certifique-se que a variável $wgImageMagickConvertCommand aponta para o local correto do comando convert</tt> de sua instalação, que o comando é executável pelo processo do servidor web, e $wgMaxShellMemory seja grande o suficiente. Veja Manual:Image Administration para obter informações detalhadas e resolução de problemas.

Além disso, você pode querer modificar a lista de extensões aceitas, que são armazenados dentro do array $wgFileExtensions:

No caso de você ter problemas com o ImageMagick, e obter a seguinte mensagem de erro:

Tente adicionar a seguinte linha no LocalSettings.php: $wgMimeDetectorCommand = "file -bi";

Equações inline LaTeX
Se desejar transformar fórmulas matemáticas em LaTeX, você precisa de uma instalação LaTeX funcionando em seu sistema. Defina a variável $wgUseTeX como true para ativar este recurso. Também certifique-se que as variáveis $wgMathPath, $wgMathDirectory e $wgTmpDirectory estão definidas corretamente, mas você pode querer continuar com os valores padrão, a menos que você tenha uma boa razão para mudá-lo.

Suporte ao interwiki
O suporte ao InterWiki está embutido no MediaWiki, mas você precisa configurar o prefixo a ser usado para suas ligações internas. Este prefixo é geralmente o mesmo que $wgSitename, mas no caso de você precisar mudar isso, defina a variável $wgLocalInterwiki para o nome preferido.

Idioma da interface de usuário
O MediaWiki permite uma variedade de idiomas de interfaces de usuário localizados em vez do padrão Inglês. Se você deseja executar o seu wiki em um idioma não-inglês, defina a variável $wgLanguageCode ao código de idioma adequado (p. ex. "de" para alemão, "es" para espanhol, etc.)

Você pode usar qualquer um dos idiomas encontrados no diretório /language. P.ex., se encontrar MessagesPt_br.php, você pode usar " " para português brasileiro. Não use " " com letra maiúscula. Embora pareça funcionar, nem todos os textos estão traduzidos.

Depois de alterar o código do idioma, você terá que executar um script php para que ele funcione. Com sua ferramenta de linha de comando, vá para o seu diretório wiki, abra a pasta "maintenance", e digite " ". Por favor note que, no Windows, a pasta PHP pode não ser incluída na variável de ambiente PATH.

Nem todos os idiomas são suportados. Veja aqui para ver uma lista das estatísticas de localização de. Consulte translatewiki.net para as estatísticas por versão lançada.

Configurando direitos autorais para o site

 * $wgRightsPage é a página no wiki, que abrange os direitos autorais que estão incorporados. Normalmente, será Project:Copyrights.
 * $wgRightsUrl é a página que descreve os detalhes da sua licença. (Para a licença GNU FDL, por exemplo, seria .)
 * $wgRightsText é o texto no rodapé que se segue "Conteúdo disponível sob". Ela será vinculada à página especificada na variável.
 * $wgRightsIcon é o URL da imagem colocado à esquerda do rodapé.
 * Note: Se  não estiver vazio, o link no aviso copyright/license ligará para essa página em seu site. Se   estiver vazio, então o aviso copyright/license ligará à variável   como alternativa.

Para modificar as declarações de direitos autorais do site, adicionar algo como isso no LocalSettings.php: Posteriormente, edite MediaWiki:Copyright para proporcionar uma mensagem apropriada, usando  para indicar a posição onde o link para sua página de direitos autorais estará.

Exemplo: criação de uma licença Creative Commons

Para definir uma licença Creative Commons faça o seguinte:

Para  digite o texto onde a segunda âncora é vinculada (adicione o "a" à variável Wiki para uma versão mais gramaticalmente correta)
 * Escolha sua licença: http://creativecommons.org/text/publish-website
 * Examine o código HTML retornado, p.ex.:
 * Para  inserir a informação do href da primeira âncora:
 * Para  inserir as informações da origem (src) da ligação image (img) na primeira âncora. Você quer copiar o emblema de seu próprio site, em vez de usar o do site da Creative Commons.


 * Para utilizar os metadados RDF sobre direitos autorais adicionar uma ou ambas das seguintes linhas ao seu arquivo LocalSettings.php

Namespaces personalizados
Ao declarar o array $wgExtraNamespaces, e modificar os arrays $wgNamespacesWithSubpages, e $wgNamespacesToBeSearchedDefault, namespaces adicionais podem ser adicionados a uma instalação do MediaWiki; e ao declarar o array $wgNamespaceAliases aliases de namespace podem ser adicionados. Tenha cuidado para não ter quaisquer páginas já tituladas nesse namespace, por exemplo, em que você tinha uma página chamada "Technical:Support" e você criou o namespace "Technical:", então essa página não só seria perdida, mas você não pode removê-la de Special:Allpages. Para corrigir isso exclua o namespace, mova "Technical:Support" para "Support" no mainspace, exclua o redirecionamento, reinsira o namespace, e mova-o de volta para "Technical:Support". Consulte Namespaces personalizados para obter informações adicionais a respeito de como fazê-lo.

Skins
A skin padrão do site pode ser modificada através da variável $wgDefaultSkin.

Veja também

 * Famílias wiki podem compartilhar o mesmo LocalSettings.php.
 * A extensão Configure fornece uma maneira de definir as definições de configuração de uma página especial.
 * Protegendo senhas de banco de dados - um guia para proteger suas senhas de banco de dados e o arquivo LocalSettings.php.