Predefinição:Instalação de extensão

This page is a translated version of the page Template:ExtensionInstall and the translation is 100% complete.

Baixe e mova a pasta extraída ExtensionInstall ao seu diretório extensions/.
Desenvolvedores e colaboradores de código, por outro lado, deverão instalar a extensão a partir do Git, usando:
```
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ExtensionInstall
```

Adicione o seguinte código ao final do seu arquivo LocalSettings.php:

require_once "$IP/extensions/ExtensionInstall/ExtensionInstall.php";

Concluído – Navegue à página Special:Version em sua wiki para verificar se a instalação da extensão foi bem sucedida.

Documentação da predefinição

Utiliza Lua:

Module:Extension

Uso

Installation instructions.

Template parameters[Edit template data]
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Extension name	`1`	Set the extension name manually. Default The current page name without namespace prefix. Auto value `{{ROOTPAGENAME}}`	String	optional
Git submodule	`git-submodule`	Add --recurse-submodules to the git clone command	Boolean	optional
Vagrant role name	`vagrant`	If given, shows how to install extension with the Vagrant's enable-role command	String	optional
Download link	`download-link`	Overwrite the download link. Default Link to Special:ExtensionDistributor with the extension name.	URL	optional
LocalSettings early	`localsettingsearly`	Pass custom php code that the user should include in [[LocalSettings.php]] before the extension is loaded. Example $wgUseAjax = true; // Must be included before the extension is loaded	Unknown	optional
LocalSettings	`localsettings`	Pass custom PHP code that the user should include in [[LocalSettings.php]]. Example $wgUseAjax = true;	Unknown	optional
Database update	`db-update`	If the extension requires the update script to be run, set this parameter to any value. (For example, if it has one or more database tables that need to be created.) Example 1	Boolean	optional
Composer	`composer`	If the extension uses Composer to manage dependencies, set this parameter to any value. Not that this does not indicate that the extension is able to be installed with Composer. Default false	Boolean	optional
Custom steps 0	`custom-steps0`	Additional steps before download, e.g. other required extensions (as an unordered "* list").	Content	optional
Custom steps	`custom-steps`	Additional steps (as an unordered "* list").	Content	optional
Supports registration	`registration`	Changes the template to use <code>wfLoadExtension()</code> if it supports registration. Set to any value if the extension supports registration, or to <code>required</code> if it <em>only</em> supports registration and doesn't support the old-style of loading.	String	optional
No registration version	`no-registration-version`	The MediaWiki version for which extension registration should not be used. Default 1.24	Unknown	optional

Exemplos

A seguir, há alguns exemplos de como usar essa predefinição:

Simples

{{ExtensionInstall}}

Nome

{{ExtensionInstall|CategoryTree}}

Ligação para baixar

{{ExtensionInstall
|download-link=[http://bits.wikimedia.org/example.zip Download]
}}

LocalSettings

{{ExtensionInstall
|localsettings=
$wgUseAjax = true;
}}

LocalSettings “antecipado”

{{ExtensionInstall
|localsettingsearly=
$wgUseAjax = true; // Isso deve ser incluido antes do carregamento da extensão
}}

Atualizando o banco de dados

{{ExtensionInstall
|db-update=Yes
}}

Composer

{{ExtensionInstall
|composer=Yes
}}

Passos personalizados

{{ExtensionInstall
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
}}

Compatível com registro

{{ExtensionInstall
|registration=1
}}

Compatível com registro e com versão mínima

{{ExtensionInstall
|registration=1
|no-registration-version=1.39
}}

Isso somente funcionará se a versão especificada for 1.35 ou posterior. Caso contrário, a predefinição assumirá que ninguém se importa sobre versões tão antigas assim, e fará o mesmo que em #Requer registro.

Requer registro

{{ExtensionInstall
|registration=required
}}

Tudo

{{ExtensionInstall|Example
|download-link=[http://bits.wikimedia.org/example.zip Download]
|vagrant=example
|localsettings=
$wgUseAjax = true;

|db-update=Yes
|composer=Yes
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
|registration=yes
}}

Uso

See also