Manual:Extensions/pt-br

Uma extensão permite a você personalizar a aparência e o funcionamento do MediaWiki.

  • Administradores de sistema podem instalar (ou remover) extensões nas instalações do MediaWiki gerenciadas por eles.
  • Desenvolvedores podem criar novas extensões ou contribuir com as já existentes.
Enquanto algumas extensões são mantidas por desenvolvedores do MediaWiki, outras são escritas por desenvolvedores terceiros e podem não ter manutenção. Como resultado, várias extensões são sucetíveis a bugs — incluindo, em alguns casos, falhas de segurança. Nem todas as extensões funcionam em todas as versões do MediaWiki, e não há garantia de que todas sejam compatíveis entre si. Use extensions at your own risk, particularly those tagged as insecure. Se uma extensão que requer correções (patches) ao software principal, certifique-se de fazer um backup do seu banco de dados com antecedência para evitar o risco de quebrar sua wiki.

Selecting extensions

Bundled extensions

Several extensions are bundled with MediaWiki as standard.

These extensions should generally be of high utility, perform efficiently, be stable, be well-written, and have no known major security issues. They should also be compatible with the latest versions of MediaWiki, and with each other (i.e. one extension shouldn't block the functions of another). A bundled extension may have a dependency on one or more other extensions, as long as those are also bundled.

Site admins get these automatically when installing or upgrading MediaWiki. When upgrading MediaWiki, any extension upgrades will be automatically applied as well. Site admins may choose to uninstall any of these, if they wish.

There are open, ongoing discussions about which extensions should be part of this group. You can suggest additional extensions to be bundled. Extensions will be bundled once the developers reach a consensus to do so.

An extension may be removed from bundling if its functionality is merged into MediaWiki core, it is replaced by an alternative, or in the unlikely event of any unsolvable major security vulnerabilities being discovered.

Procurar extensões

Navegue por Category:Todas as extensões ou Category:Extensões por categoria para ver todas as variedades de extensões disponíveis.

Verificar extensões instaladas

Which extensions are active on an instance of MediaWiki can be checked by accessing the Special:Version page, and scrolling down to the heading Installed extensions (anchor #mw-version-ext). Por exemplo, estas extensões estão instaladas nesta wiki, e estas extensões estão ativas na Wikipédia em português.

There are a number of ways of finding popular extensions.

Extensions that are downloaded from MediaWiki.org via the ExtensionDistributor mechanism have some statistics gathered. The top 15 most downloaded extensions are listed at Special:ExtensionDistributor, and applicable extensions have their download count shown in their infobox. Note that these numbers do not account for alternative ways of installing extensions, such as via Git or Composer.

Another option is to look at WikiApiary's counts of wikis that extensions are installed on. This has the advantage of representing actual installations and not just downloads (i.e. it queries the wiki's APIs), but it is also (as of 2023) not completely up-to-date. It also doesn't count installations on private wikis.

Instalar uma extensão

For further guidance, see also Manual:Extensões/Instalação e atualizaçã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 elaboradas para a instalação utilizando comandos do Unix.Você precisa de acesso ao shell (SSH) para inserir esses comandos listados nas páginas de ajuda da extensão.
  2. Baixe a extensão.
    O Distribuidor de Extensões ajuda você a selecionar e baixar as extensões mais populares.
    As extensões costumam ser distribuídas em pacotes modulares.Elas geralmente ficam em seu próprio subdiretório em $IP/extensions/.Uma lista de extensões armazenadas no repositório Git da Wikimedia está localizada em git:mediawiki/extensions.Some extensions don't use version control and are not recommended.
    Algumas extensões também estão disponíveis em bundles, via Composer ou repositórios de pacotes.
    It's recommended to read the README file before installation.It usually contains important info about configuration.
  3. Instale a extensão.
    No final do arquivo LocalSettings.php, adicione:
    wfLoadExtension( 'ExtensionName' );
    
    Esta linha força o interpretador do PHP a ler o arquivo da extensão, tornando-o assim acessível ao MediaWiki.
    Algumas extensões podem entrar em conflito com scripts de manutenção, por exemplo, se acessarem diretamente $_SERVER (não recomendado). Nesse caso, elas podem ser envolvidas na condicional para que os scripts de manutenção ainda possam ser executados.
    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:Page 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.

Atualizar 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 atualizar a uma nova versão de uma extensão:

  1. Baixe a nova versão da extensão.
  2. Substitua todos os arquivos da extensão no diretório extensions/ExtensionName pelos novos arquivos.Não remova a configuração da extensão presente no LocalSettings.php.
  3. Se a extensão exigir alterações no banco de dados do MediaWiki, você precisará executar o script de manutenção update.php.A maioria das extensões irá mencionar se este script precisa ou não ser executado.(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.
Estas instruções cobrem 99% das extensões.Se a extensão específica que você estiver atualizando possuir instruções que são diferentes destas, você provavelmente deverá seguir as instruções da extensão específica.

Desinstalando um extensão 

Remova a linha de LocalSettings.php com o nome da extensão para desinstalá-lo:

wfLoadExtension( 'ExtensionName' );
  • Você deve remover todas as linhas referentes à configuração da extensão.

Developing extensions

MediaWiki core provides several ways for extensions to change the behavior and appearance of a wiki. These extension points give extensions flexibility to add features and functionality, such as displaying a special page or defining an API module. To get started, see the guide to developing extensions. Before writing a new extension, consider contributing to an existing extension or helping with an unmaintained extension.

Users can also make a general request on Phabricator, and hope that your good idea is picked up by a developer. See https://phabricator.wikimedia.org/tag/mediawiki-extension-requests/


Ver também

Category:Customization techniques/pt-br#Extensions/pt-br Category:Extension creation/pt-br
Category:Customization techniques/pt-br Category:Extension creation/pt-br