As extensoes permitem-lhe personalizar a aparencia e o funcionamento do MediaWiki.
Enquanto algumas extensoes sao mantidas pelos programadores do MediaWiki, outras foram escritas por programadores terceiros.
Como resultado, muitas tem erros, e nem todos sao compativeis entre si.
Alguns nao sao mantidas; nem todas as extensoes funcionam em todas as versoes do MediaWiki.
Utilize qualquer extensao, especialmente as etiquetadas como inseguras, por sua conta e risco.
Se estiver a utilizar uma extensao que requer correcoes no software principal, efetue uma copia de seguranca da sua base de dados.
Isto ajuda a evitar o risco de danificar a sua wiki.
Tipos de extensoes
Etiquetas do analisador
As etiquetas do analisador estendem a marcacao interna da wiki com recursos adicionais, quer seja o processamento simples de "strings" ou recuperacao de informacao completa.
Funcoes do analisador
As funcoes do analisador sao sintaxe especial de marcacao da wiki que podem 'interagir' com outros elementos da wiki na pagina, e fornecer uma saida especifica.
Hooks
Os
hooks
permitem que o codigo personalizado seja executado quando ocorrer um evento definido (tais como guardar uma pagina ou um utilizador iniciar a sessao).
Paginas especiais
As paginas especiais sao paginas que sao criadas pelo "software" sob demanda para realizar uma funcao especifica.
Temas
Os temas permitem que os utilizadores personalizem a aparencia e disposicao do MediaWiki.
Palavras magicas
Palavras magicas
sao uma tecnica para mapear uma variedade de "strings" de texto wiki para uma unica 'Identificacao' que e associada com a funcao.
API
MediaWiki proporciona uma API de acao, um servico da "Web" que permite acesso a algumas funcionalidades da wiki, tais como autenticacao, operacoes de pagina, e pesquisa.
Modelos de conteudo de pagina
O
ContentHandler
introduzido no
MediaWiki 1.21
torna possivel que as paginas wiki sejam compostas de outros dados diferentes de texto wiki, tais como JSON or Markdown.
Autenticacao
MediaWiki fornece o 'Gestor de Sessao' e o 'Gestor de Autenticacao', duas estruturas relacionadas com autenticacao para melhorar a seguranca atraves de motores de autenticacao personalizados.
Finding extensions
Extensoes de navegacao
Pode explorar
Categoria:Extensoes por categoria
para ver todas as variedades de extensoes que ja foram criadas.
Para informacao sobre como instalar estas extensoes ou escrever a sua propria, consulte abaixo.
Verificar extensoes instaladas
Apenas alguem com acesso de administracao ao sistema de ficheiros (e geralmente tambem a base de dados) num servidor pode instalar extensoes para o MediaWiki, mas qualquer pessoa pode verificar quais as extensoes que estao ativas numa instancia do MediaWiki acedendo a pagina
Special:Version
.
Por exemplo,
estas extencoes
estao ativas na Wikipedia inglesa.
Popular extensions
There are a number of ways of finding popular extensions.
The first set is those that are
bundled with MediaWiki
(a list that is reviewed regularly, and to which anyone can
suggested an addition
).
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 alternate ways of installing extensions, such as
via Git
or
Composer
.
A third 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 extensao
- For further guidance, see also
Manual:Extensions/Installation and upgrade
MediaWiki esta pronto para aceitar extensoes, logo depois de a
instalacao
terminar.
Para adicionar uma extensao, siga estes passos:
- Antes de comecar
- Muitas extensoes proporcionam instrucoes destinadas a instalacao, utilizando comandos Unix. Precisa de acesso a
shell
(SSH) para inserir estes comandos listados nas paginas de ajuda da extensao.
- Transfira a sua extensao.
- Distribuidor de Extensao
ajuda-o a selecionar e a transferir as extensoes mais populares.
- As extensoes sao normalmente distribuidas como pacotes modulares. Elas geralmente tem a sua propria diretoria de
$IP
/extensions/
. Uma lista de extensoes guardadas no
repositorio Git
da Wikimedia esta localizada em
git:mediawiki/extensions
. Algumas extensoes
nao utilizam o controlo de versao
e nao sao recomendadas.
- Algumas extensoes tambem estao disponiveis em
pacotes
,
composer
ou em
repositorios
.
- It's recommended to read the README file before installation.
It usually contains important info about configuration.
- Instale a sua extensao.
- 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
,
Extension:Page Forms
.
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.
Atualizar uma extensao
Algumas extensoes tem de ser atualizadas sempre que atualiza o MediaWiki, enquanto outras funcionam com varias versoes.
Para atualizar para uma nova versao de uma extensao.
- Transfira a nova versao da extensao
- Substitua todos os ficheiros da extensao na diretoria
extensions/ExtensionName
com os novos ficheiros. Nao remova a configuracao da extensao presente em LocalSettings.php
- Se a extensao precisar de alteracoes na base de dados do MediaWiki, tera de executar o
script
de manutencao
update.php
. A maioria das extensoes irao mencionar se este
script
precisa ou nao de ser executado. (Efetue uma copia de seguranca dos seus dados antes de executar o
script
). Se nao tem acesso a linha de comandos, tambem pode utilizar o
atualizador da Web
.
Estas instrucoes abrangem 99% das extensoes. Se a extensao especifica que esta a atualizar tiver instrucoes diferentes destas, provavelmente deveria seguir as instrucoes da extensao especifica
Desinstalar uma extensao
Remova a linha de LocalSettings.php com o nome da extensao para desinstala-la:
wfLoadExtension
(
'ExtensionName'
);
- Deve remover todas as linhas pertencentes a configuracao da extensao.
Consultar tambem