Manual:Extensions/pt

Extensions:

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

  • Os administradores de sistema podem instalar (ou remover) as extensões nas instalações do MediaWiki que eles administram.
  • Os programadores podem escrever novas extensões ou contribuir para as extensões existentes.
Enquanto algumas extensões são mantidas pelos programadores do MediaWiki, outras foram desenvolvidas por programadores terceiros e podem não ser geridas. Como resultado, muitas extensões têm erros que podem conter erros - incluindo, em alguns casos, vulnerabilidades de segurança. Nem todas as extensões são compatíveis com cada versão

do MediaWiki, e elas podem não funcionar em condições quando utilizadas juntas.

Utilize as extensões por sua conta e risco, particularmente aquelas marcadas como inseguras. Se uma extensão requer correções no programa principal, certifique-se que efetua antes uma cópia de segurança da sua base de dados para minimizar o risco de criar problemas na sua wiki.

Seleção de extensões

Extensões agrupadas

Várias extensões são agrupadas com o MediaWiki como padrão.

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. Pode sugerir extensões adicionais para serem agrupadas. 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.

Extensões de navegação

Explore Categoria:Todas as extensões, ou Categoria: Extensões por categoria para ver todas as variedades de extensões que estão disponíveis.

Verificação de extensões instaladas

Quais as extensões que estão ativas numa instância do MediaWiki podem ser verificadas acedendo à página Special:Version, e deslizando para baixo até ao título "Extensões instaladas" (âncora #mw-version-ext). Por exemplo, estas extensões estão instaladas nesta wiki, e estas extensões estão ativas na Wikipédia inglesa.

Extensões populares

Há várias maneiras para encontrar extensões populares.

As extensões que são transferidas de Mediawiki.org através do mecanismo ExtensionDistributor têm algumas estatísticas reunidas. 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

Para mais assistência, consulte também Manual:Extensões/Instalação e atualização

MediaWiki está pronto para aceitar extensões, assim que a instalação esteja concluída. Para adicionar uma extensão, siga estes passos:

  1. Antes de começar
    Muitas extensões proporcionam instruções destinadas à instalação, utilizando comandos Unix.Precisa de acesso à shell (SSH) para inserir estes comandos listados nas páginas de ajuda da extensão.
  2. Transfira a sua extensão.
    Distribuidor de Extensão ajuda-o a selecionar e a transferir as extensões mais populares.
    As extensões são normalmente distribuídas como pacotes modulares.Elas geralmente tem a sua própria diretoria de $IP/extensions/.Uma lista de extensões guardadas no repositório Git da Wikimédia está localizada em git:mediawiki/extensions.Algumas extensões não utilizam o controlo de versão e não são recomendadas.
    Algumas extensões também estão disponíveis em pacotes, Composer ou em repositórios.
    It's recommended to read the README file before installation.It usually contains important info about configuration.
  3. Instale a sua extensão.
    No fim do ficheiro LocalSettings.php, adicione:
    wfLoadExtension( 'ExtensionName' );
    This line forces the PHP interpreter to read the extension file, and thereby make it accessible to MediaWiki.
    Some extensions can conflict with maintenance scripts, for example if they directly access $_SERVER (not recommended). In this case, they can be wrapped in the conditional so maintenance scripts can still run.
    if ( !$wgCommandLineMode ) {
   wfLoadExtension ( 'ExtensionName' );
}
    The maintenance script importDump.php will fail for any extension which requires customised namespaces which is included inside the conditional above such as Extension:Semantic MediaWiki, Extensão: Formas de Página.
Ensure that required permissions are set for extensions!
While this installation procedure is sufficient for most extensions, some require a different installation procedure.Check your extension's documentation for details.
If you want to alter configuration variables in LocalSettings.php, you have to do this typically after including the extension.Otherwise defaults defined in the extension will overwrite your settings.

Atualização de uma extensão

Algumas extensões têm de ser atualizadas sempre que atualiza o MediaWiki, enquanto outras funcionam com várias versões. Para atualizar para uma nova versão de uma extensão.

  1. Transfira a nova versão da extensão
  2. Substitua todos os ficheiros da extensão na diretoria extensions/ExtensionName com os novos ficheiros.Não remova a configuração da extensão presente em LocalSettings.php
  3. Se a extensão precisar de alterações na base de dados do MediaWiki, terá de executar o script de manutenção update.php.A maioria das extensões irão mencionar se este script precisa ou não de ser executado.(Efetue uma cópia de segurança dos seus dados antes de executar o script).Se não tem acesso à linha de comandos, também pode utilizar o atualizador da Web.
Estas instruções abrangem 99% das extensões.Se a extensão específica que está a atualizar tiver instruções diferentes destas, provavelmente deveria seguir as instruções da extensão específica

Desinstalação de uma extensão

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

wfLoadExtension( 'ExtensionName' );
  • Deve remover todas as linhas pertencentes à configuração da extensão.

Desenvolver extensões

O núcleo do Mediawiki proporciona vários modos para as extensões para alterar o comportamento e a aparência de uma 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. Consulte https://phabricator.wikimedia.org/tag/mediawiki-extension-requests/


Consultar também

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