Manual:Extensions/pt-br

Extensões permitem a você personalizar a aparência e o funcionamento do MediaWiki.
 * Os usuários das wikis podem navegar pelas extensões existentes ou solicitar novas extensões.
 * Administradores de sistema podem instalar (ou remover) extensões nas instalações do MediaWiki que eles manuseiam.
 * Desenvolvedores podem elaborar novas extensões ou melhorar/manter extensões já existentes.

Enquanto algumas extensões são mantidas por desenvolvedores do MediaWiki, outras são escritas por desenvolvedores de terceiros. Como resultado, várias extensões possuem bugs, e elas não são totalmente garantidas de serem compatíveis umas com as outras. Algumas não são mantidas; nem todas as extensões funcionam em todas as versões do MediaWiki. Use qualquer extensão, especialmente aquelas marcadas como inseguras, a seu próprio risco. Quando for usar uma extensão que exiga patches para o núcleo de código do MediaWiki ou entradas em sua(s) base(s) de dados, certifique-se de criar um back-up da sua base de dados e/ou do núcleo do código do MediaWiki, para evitar risco de quebrar permanentemente a sua wiki.

Procurar extensões
Você pode procurar em para ver todas as variedades de extensões que já desenvolvidas. Para informações de como instalar estas extensões ou sobre escrever a sua própria, veja abaixo.

Checando extensões instaladas
Apenas alguém com acesso administrativo ao sistema de arquivos (e talvez à base de dados também) em um servidor pode instalar uma extensão para o MediaWiki, mas qualquer um pode checar quais extensões estão ativas em uma instância do MediaWiki, acessando a página Special:Version. Por exemplo, estas extensões estão ativas na Wikipédia portuguesa.

Instalando uma extensão
O MediaWiki estará pronto para aceitar extensões logo após a instalação concluir-se. Para adicionar uma extensão siga os passos a seguir:


 * 1) Antes de você começar
 * Várias extensões fornecem instruções desenvolvidas para a instalação usando comandos unix. Você precisa de acesso ao shell (SSH) para entrar esses comandos listados nas páginas de ajuda da extensão.
 * 1) Baixe a extensão
 * O Distribuidor de Extensões ajuda você a selecionar e fazer o download das extensões mais populares.
 * As extensões costumam ser distribuídas em pacotes modulares. Elas geralmente ficam em seu próprio subdiretório em /pt-br| ]]/extensions/ .  Uma lista de extensões armazenadas no repositório Git da Wikimedia está localizada em git:mediawiki/extensions. Algumas extensões estão disponíveis como código fonte  [ nesta wiki].
 * Pacotes não-oficiais das extensões do repositório Wikimedia SVN podem ser encontrados no toolserver.
 * 1) 'Instalando a extensão'.
 * Geralmente, no final do arquivo  (mas acima do delimitador de fim do código PHP " ", se presente), a linha a seguir deve ser adicionada:
 * Esta linha força o interpretador do PHP a ler o arquivo da extensão, e assim, torná-lo acessível para o MediaWiki.
 * Algumas extensões podem entrar em conflito com scripts de manutenção, por exemplo, se aceder diretamente o $_SERVER (não recomendado).
 * Neste caso, elas podem ser envolvidas na condicional para os scripts de manutenção ainda poderem executar.
 * Neste caso, elas podem ser envolvidas na condicional para os scripts de manutenção ainda poderem executar.


 * O script de manutenção importDump.php vai falhar para qualquer extensão que exija espaços nominais customizados que estejam incluídos dentro da condicional acima, assim como Extension:Semantic MediaWiki, Extension:Semantic Forms.



Atualizando uma extensão
Algumas extensões requerem serem atualizadas cada vez que você atualizar o MediaWiki, enquanto outras funcionam em múltiplas versões. Para a atualizar para uma nova versão de uma extensão:


 * 1) Faça o download da nova versão da extensão.
 * 2) Substitua todos os arquivos da extensão no diretório extension/ExtensionName pelos novos arquivos. Não remova a configuração da extensão presente no.
 * 3) Dependendo da extensão, talvez você tenha que rodar o script de manutenção Update.php. A maioria das extensões irá mencionar se este script precisa ou não ser rodado (Faça backup de seus dados antes de executar o script). Se você não tem acesso à linha de comando, você também pode usar o web updater.
 * 4) Isso é tudo o que você precisa fazer. Na maioria dos casos, qualquer configuração de extensão que você tiver no LocalSettings.php também funcionará com a nova versão da extensão.

Desinstalando um extensão
Extensões são adicionadas ao adicionar uma linha ao LocalSettings.php, que basicamente é assim:


 * 1) Remova essa linha para desinstalar a extensão. You should remove the extension files from inside the "extensions/" code if you no longer plan on using it.
 * 2) Talvez hajam mais linhas no LocalSettings.php relacionadas a extensão. Remova-as. Em geral, estas linhas dão permissão a certos usuários para acessar páginas, fornecida pela extensão. Estas linhas contêm a variável “$wgGroupPermissions” e algumas configurações. Se forem relacionadas às permissões dadas pela extensão removida, remova-as também.
 * 3) Talvez a extensão também tenha adicionado algumas colunas ao seu banco de dados. O atualizador maintenance/update.php as removerá se você executá-lo após a desinstalação.

Ver também

 * - Informação sobre traduzir extensões.
 * - Informação sobre traduzir extensões.
 * - Informação sobre traduzir extensões.
 * - Informação sobre traduzir extensões.