Manual:Extensions/fr

Les extensions vous permettent de personnaliser l'apparence et la façon de travailler de MediaWiki.


 * Les utilisateurs wiki peuvent rechercher parmi les extensions existantes.
 * Les administrateurs système peuvent installer (ou désinstaller) les extensions sur les systèmes MediaWiki qu'ils gèrent.
 * Les développeurs peuvent écrire de nouvelles extensions ou bien améliorer ou maintenir les extensions existantes.

Tandis que certaines extensions sont maintenues par les développeurs MediaWiki, d'autres ont été écrites par des développeurs tiers. De ce fait, beaucoup d'entre-elles contiennent des bogues et la compatibilité entre extensions n'est pas garantie. Certaines ne sont pas maintenues : toutes les extensions ne fonctionnent pas sur toutes les versions de MediaWiki. L'utilisation de toute extension, notamment celles qui sont marquées comme dangereuses, se fera à vos propres risques. Si vous utilisez une extension qui nécessite des corrections dans le logiciel du noyau, soyez sûr d'avoir bien sauvegardé votre base de données auparavent. Ceci vous aide à éviter le risque de voir votre wiki s'écrouler.



Types d'extensions


Navigation dans les extensions
Vous pouvez naviguer dans la catégorie pour voir l'éventail des extensions qui ont déjà été écrites. Pour les informations sur la manière d'installer ces extensions ou bien d'écrire la vôtre, voyez plus bas.



Vérification des extensions installées
Seule une personne disposant d'un accès administration au système de fichiers (et souvent aussi à la base de données) sur un serveur peut installer des extensions pour MediaWiki, et tous les utilisateurs peuvent vérifier quelles extensions sont activées sur une version de MediaWiki en accédant à la page spéciale Special:Version. Par exemple, voici la liste des extensions actives sur la Wikipédia francophone.

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.



Installation d'une extension
MediaWiki est prêt à accepter des extensions dès la fin de l'installation. Pour ajouter une extension, suivez ces étapes :


 * 1) Avant de commencer
 * De nombreuses extensions fournissent des instructions conçues pour l'installation à l'aide de commandes unix. Vous aurez besoin d'un accès shell (SSH) pour entrer ces commandes énumérées dans les pages d'aide de l'extension.
 * 1) Téléchargez votre extension.
 * La page de téléchargement d'extensions vous permet de sélectionner et de télécharger la plupart des extensions populaires.
 * Les extensions sont généralement distribuées sous forme de packages modulaires. Elles vont généralement dans leur propre sous-répertoire du dossier .  Une liste des extensions stockées dans Wikimedia  Dépôt Git se trouve dans git:mediawiki/extensions. Certaines extensions n'utilisent pas de contrôle de version et ne sont pas recommandées.
 * Quelques extensions aussi sont disponibles sous forme de colis, de ou de dépôt de packages.
 * 1) Installez votre extension..
 * A la fin du fichier, ajoutez :
 * Cette ligne oblige l'interpréteur PHP à lire le fichier principal de l'extension et donc la rendre accessible à MediaWiki.
 * Certaines extensions peuvent être en conflit avec les scripts de maintenance, par exemple si elles accèdent directement à $_SERVER (non recommandé).
 * Dans ce cas, elles peuvent être incluses dans une condition afin que les scripts de maintenance puissent toujours s'exécuter.
 * Le script de maintenance ne fonctionnera pas pour toute extension qui nécessite des espaces de noms personnalisés et qui est incluse dans la condition ci-dessus comme,.
 * Le script de maintenance ne fonctionnera pas pour toute extension qui nécessite des espaces de noms personnalisés et qui est incluse dans la condition ci-dessus comme,.
 * Le script de maintenance ne fonctionnera pas pour toute extension qui nécessite des espaces de noms personnalisés et qui est incluse dans la condition ci-dessus comme,.



Mise à jour d'une extension
Certaines extensions nécessitent une mise à jour lorsque vous mettez à jour MediaWiki tandis que d'autres fonctionnent sur plusieurs versions. Pour mettre à jour une extension avec une nouvelle version :


 * 1) Téléchargez la nouvelle version de l'extension
 * 2) Remplacez tous les fichiers de l'extension dans le répertoire  par les nouveaux fichiers. Ne retirez pas la configuration de l'extension présente dans LocalSettings.php.
 * 3) Si l'extension nécessite des modifications dans la base de données MediaWiki, vous devrez lancer le script de maintenance . La majeure partie des extensions mentionneront si le script a besoin ou non d'être exécuté. (Faites une sauvegarde de vos données avant d'exécuter le script). Si vous ne disposez pas d'accès aux lignes de commande, vous pouvez aussi utiliser l'utilitaire de mise à jour web.



Suppression d'une extension
Supprimez la ligne de LocalSettings.php contenant le nom de l'extension afin de la désinstaller :


 * Vous devez supprimer toutes les lignes liées à la configuration de l'extension.



Voir aussi

 * - Informations à propos de la traduction des extensions.
 * Special:ExtensionDistributor - Comprend une liste des 15 extensions les plus téléchargées du système de contrôle des versions de Wikimedia
 * - Informations à propos de la traduction des extensions.
 * Special:ExtensionDistributor - Comprend une liste des 15 extensions les plus téléchargées du système de contrôle des versions de Wikimedia
 * Special:ExtensionDistributor - Comprend une liste des 15 extensions les plus téléchargées du système de contrôle des versions de Wikimedia