Manual:Extensões
 Extensões: |
Desenvolvimento | Extensões de tags | Funções do analisador sintático | Hooks | Páginas especiais | Skins | Palavras mágicas | API | Content models |
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.
Tipos de extensões
Parser tags
Parser functions
Hooks
Special pages
Skins
Magic words
API
Page content models
Authentication
Procurar extensões
Você pode procurar em Category:Extensões por categoria 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:
- 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.
- 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
[[Manual:. 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.$IP/extensions//pt-br|$IP/extensions/]]/extensions/ - Pacotes não-oficiais das extensões do repositório Wikimedia SVN podem ser encontrados no toolserver.
- 'Instalando a extensão'.
- No final do arquivo
LocalSettings.php, a seguinte linha deve ser adicionada: wfLoadExtension( 'ExtensionName' );
- 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.
- No final do arquivo
if ( !$wgCommandLineMode ) {
wfLoadExtension ( 'ExtensionName' );
}
- 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.
- Garanta que as permissões necessárias estão definidas para as extensões!
- Embora este procedimento de instalação é suficiente para a maioria das extensões, algumas requerem um procedimento de instalação diferente. Verifique a documentação de sua extensão para mais detalhes.
- Se você quer alterar a configuração dos variáves no LocalSettings.php, você deverá fazer isso depois de incluir a extensão. Caso contrário, os padrões definidos na extensão irão substituir suas configurações.
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:
- Faça o download da nova versão da extensão.
- 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
LocalSettings.php. - 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.
Desinstalando um extensão
Remove the line from LocalSettings.php with the extension name to uninstall it:
wfLoadExtension( 'ExtensionName' );
- You must remove any lines pertaining to the configuration of the extension.
- If the extension provides any database changes, you must run update.php to remove them.
Ver também
- Category:Extensões
- Template:Extensão
- Manual:Desenvolvendo extensões
- Manual:Translating extensions - Informação sobre traduzir extensões.
| Extensões: | Categoria • Todas • Solicitações • Extensões de marcação • Perguntas frequentes • Registro de hooks • Espaços nominais padrões |
|---|
