Template:ExtensionInstall

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

Téléchargez et placez le(s) fichier(s) dans un répertoire appelé ExtensionInstall dans votre dossier extensions/.
Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ExtensionInstall

Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :

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

Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Documentation du modèle

Ce modèle utilise le module Lua suivant :

Module:Extension

Utilisation

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 has one or more database tables that need to be created through [[update.php]], set this parameter to any value. Default false	Boolean	optional
Composer	`composer`	If the extension uses [[Composer]] to manage dependencies, set this parameter to any value. 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

Exemples

Ci-dessous quelques exemples sur la manière d'utiliser ce modèle :

Simple

{{ExtensionInstall}}

Avec un nom

{{ExtensionInstall|CategoryTree}}

Avec un lien de téléchargement

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

LocalSettings

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

Ancien LocalSettings

{{ExtensionInstall
|localsettingsearly=
$wgUseAjax = true; // inclure ceci avant de charger l'extension
}}

Avec une mise à jour de la base de données

{{ExtensionInstall
|db-update=Yes
}}

Avec Composer

{{ExtensionInstall
|composer=Yes
}}

Avec des étapes personnalisées

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

Prend en charge l'enregistrement d'extension

{{ExtensionInstall
|registration=1
}}

Supporter l'enregistrement avec la version minimale

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

Cela ne fonctionne que si la version spécifiée est 1.35 ou plus récente, sinon le modèle suppose que personne ne s'occupe des anciennes versions et se replie sur l'Enregistrement nécessaire.

Nécessite l'enregistrement

{{ExtensionInstall
|registration=required
}}

Tout en même temps

{{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
}}