Manual:LocalSettings.php/pt-br

O arquivo   fornece Manual:Configuration settings|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|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.

Localização no servidor
O arquivo LocalSettings.php não é uma página wiki e você não pode acessá-lo com o seu navegador. Em vez disso, ele é um arquivo no sistema de arquivos do servidor. Seu conteúdo é gerado durante a configuração inicial da wiki e o arquivo resultante deve ser copiado no servidor manualmente. O arquivo deve estar localizado na pasta que você instalou o MediaWiki, no mesmo nível de pastas como "includes/" ou "skins/" e arquivos como "api.php". Se este arquivo não está lá, a wiki não vai funcionar mesmo - se o wiki funcionar, o arquivo está lá. Se você não sabe onde está, você pode executar esse comando  no shell do UNIX para fazer seu servidor lhe mostrar onde o arquivo está realmente.

(If you are using Vagrant, see also MediaWiki-Vagrant#MediaWiki_settings.)

Segurança
O arquivo LocalSettings.php geralmente contém dados confidenciais, como logins de bancos de dados. Estes dados nunca devem ser revelados ao público! Devido a uma falha de segurança em algum lugar no servidor, pode acontecer que outros usuários possam visualizar o conteúdo dos arquivos. A fim de melhorar a segurança dos seus dados, você deve configurar as permissões do UNIX para este arquivo adequadamente: o usuário do servidor web deve ter acesso a este arquivo. Se esta é a mesma conta, que é o dono do arquivo, então você pode definir permissões para "600". Às vezes, o usuário servidor web não é o dono do arquivo, mas ele está no grupo de usuários UNIX do proprietário. Neste caso, as permissões de "640" devem estar certas. Para maior segurança, você deve estreitar as permissões tanto quanto possível.

Além disso, você pode criar um usuário MySQL, que é restrito a apenas o banco de dados usado pelo wiki e fornecer credenciais desse usuário no arquivo LocalSettings.php. Além disso, você pode configurar o servidor de banco de dados para aceitar apenas conexões a partir de localhost - isso deve impedir o acesso a partir do exterior em caso de credenciais que vazaram.

Conteúdo dos arquivos
Quando você edita LocalSettings.php, certifique-se de salvá-lo na codificação correta novamente. Você deve usara codificação "ANSI as UTF-8" - que é a codificação UTF-8 sem marcas de ordem de byte (BOM).

LocalSettings.php contém código PHP; principalmente a definição de variáveis e seus valores. Alterar uma configuração normalmente significa alterar o valor de uma variável PHP. As alterações entrarão em vigor imediatamente após salvar o arquivo novamente no servidor: Não há necessidade de reiniciar nada manualmente. De qualquer forma, em alguns casos, pode ser necessário limpar o cache do seu navegador para realmente ver as mudanças que você fez.

Os valores “padrão” de muitas outras configurações estão definidos em, os quais não devem ser editados; se a variável que você deseja alterar não estiver mencionada no seu  , copie a linha apropriada de   e modifique-a de forma adequada no. Dentro do  você pode adicionar novas linhas no final.

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 sua versão do LocalSettings.php pode não terminar com uma tag de fechamento PHP ?&gt;. 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.). 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.

Visão geral das configurações disponíveis
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 da sua wiki. Desde a versão 1.17, o MediaWiki automaticamente define a $IP – defini-la no  não é mais necessário. Ele assumirá como padrão o diretório de trabalho atual automaticamente e poderá ser usado sem a necessidade de defini-la manualmente.

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.

Declinações do nome do site
Algumas traduções da interface estão prontas para inflexão do nome do site. Você pode definir as formas adequadas de palavras nas variáveis ' (para exemplos, refira-se à página de documentação da ').

Idioma do site
A variável  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.

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
 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 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  especifica a URL do script de redirecionamento que lida com redirecionamentos no MediaWiki. Esta configuração é semelhante a wgScript pois é possível configurar o nome exato do script. Como mencionado acima, isso provavelmente não é uma boa ideia, a menos que você realmente saiba o que está fazendo.

Caminho dos artigos
 é 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 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, subpáginas são habilitadas em uma base por espaço nominal usando a variável . Por exemplo, para permitir subpáginas no espaço nominal 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.

P.ex., aqui está um exemplo de código de includes/DefaultSettings.php para inserir no :

Se você quer poder redimensionar imagens em tempo real para apoiar as miniaturas, o MediaWiki precisa de uma instalação do ImageMagick funcionando. Defina  como true depois de ter instalado e testado o ImageMagick em seu sistema. Certifique-se que ' aponta para o local correto do comando convert</tt> de sua instalação, que o comando é executável pelo processo do servidor web, e ' seja grande o suficiente. Veja 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 :

No caso do ImageMagick produzir uma mensagem erro semelhante a seguinte:
 * Fatal error: mime_magic could not be initialized, magic file is not available in includes/MimeMagic.php on line 506

experimente então adicionar a seguinte linha ao :

= "file -bi";

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 $site-name, mas no caso de você precisar mudar isso, defina a variável 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 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. Assim, se encontrar, você pode usar   para português do Brasil. Não use, com letra maiúscula. Embora pareça funcionar, nem todos os textos são traduzidos.

Depois de alterar o código do idioma, você terá que executar um script PHP para que ele funcione. Num terminal, vá para o diretório da sua wiki, abra a pasta  e digite. No Windows, a pasta do PHP pode não estar incluída na variável de ambiente, e você terá de prefixar php com o caminho ao programa.

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:


 * Escolha sua licença: http://creativecommons.org/choose/
 * Examine o código HTML retornado, p.ex.:

Para  digite o texto onde a segunda âncora é vinculada (adicione o "a" à variável Wiki para uma versão mais gramaticalmente correta)
 * 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.

Ver também

 * source code, which generates the inital contents of  during installation.
 * 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.