Jump to content

Extensions

From mediawiki.org
This page is a translated version of the page Manual:Extensions and the translation is 100% complete.
Languages:
Extensions :

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

  • 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 contribuer aux extensions existantes.
Tandis que certaines extensions sont maintenues par les développeurs de MediaWiki, d'autres ont été écrites par des développeurs tiers et peuvent ne plus être maintenues. De ce fait, beaucoup d'entre elles peuvent contenir des bogues incluant le cas échéant des failles de sécurité. Toutes les extensions ne sont pas forcément compatibles avec chaque version de MediaWiki et leur fiabilité peut être remise en cause si vous les utilisez ensemble. Utilisez les extensions mais à vos propres risques, en particulier celles qui sont classées comme étant dangereuses. Si vous utilisez une extension qui nécessite des corrections dans le logiciel du noyau, assurez-vous d'avoir bien sauvegardé votre base de données auparavant afin de minimiser les risques de non-compatibilité de votre wiki.

Choisir des extensions

Extensions intégrées

Plusieurs extensions sont livrées avec MediaWiki en standard.

Ces extensions doivent généralement être d'une grande utilité, fonctionner efficacement, être stables, être bien écrites et ne pas présenter de problèmes de sécurité majeurs connus. Elles doivent également être compatibles avec les dernières versions de MediaWiki et compatibles entre-elles (c'est-à-dire qu'une extension ne doit pas bloquer les fonctions d'une autre extension). Une extension incluse peut être dépendante d'une ou de plusieurs autres extensions, à condition que celles-ci soient également incluses.

Les administrateurs de site les reçoivent automatiquement lors de l'installation ou de la mise à niveau de MediaWiki. Lors de la mise à niveau de MediaWiki, toutes les mises à niveau des extensions sont également automatiquement appliquées. Les administrateurs de site peuvent choisir de les désinstaller s'ils le souhaitent.

Les discussions ouvertes sont à votre disposition concernant les extensions qui devraient faire partie de ce groupe. Vous pouvez suggérer des extensions supplémentaires à ajouter à l'archive de livraison . Les extensions seront incluses une fois que les développeurs auront atteint un consensus pour le faire.

Une extension peut être supprimée de l'archive de livraison quand ses fonctionnalités ont été fusionnées dans le noyau MediaWiki , ou si elle est remplacée par une autre fonction, ou encore dans le cas improbable où une faille majeure de sécurité insolvable a été découverte.

Voir Catégorie:Toutes les extensions ou Catégorie:Extensions par catégories pour avoir un éventail complet des extensions déjà disponibles.

Vérifier les extensions installées

Pour connaître les extensions actives sur une instance de MediaWiki, vous pouvez aller sur la page Special:Version, et descendre jusqu'au paragraphe Extensions installées (ancré à #mw-version-ext). Par exemple, ces extensions sont installées sur ce wiki, et ces extensions sont actives sur la Wikipédia anglaise.

Extensions populaires

Une autre option est de regarder les compteurs de WikiApiary sur les wikis où les extensions sont installées. Ceci a l'avantage de représenter les installations actuelles et non seulement les téléchargements (en interrogeant les requêtes aux APIs du wiki), mais (depuis 2023) la valeur n'est pas complètement à jour. Cela ne prend pas non plus en compte l'installation sur les wikis privés.

Installer une extension

Pour plus d'informations, voir également Manuel:Extensions/Installation et mise à jour

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.
  2. 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 $IP /extensions/. 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 distribution, de Composer ou de dépôt de packages.
    Il est recommandé de lire le fichier README avant de faire l'installation. Il contient habituellement d'importantes informations concernant la configuration.
  3. Installez votre extension.
    A la fin du fichier LocalSettings.php , ajoutez :
    wfLoadExtension( 'ExtensionName' );
    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.
    if ( !$wgCommandLineMode ) {
   wfLoadExtension ( 'ExtensionName' );
}
    Le script de maintenance importDump.php 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 Extension:Semantic MediaWiki , Extension:Page Forms .
Assurez-vous de disposer des permissions adéquates pour les extensions !
Bien que la procédure d'installation soit suffisante pour la majorité des extensions, certaines peuvent demander une installation différente. Voyez la documentation de l'extension pour plus d'informations.
Si vous souhaitez modifier les variables de configuration dans LocalSettings.php, vous devez impérativement le faire après avoir inclus l'extension. Autrement les valeurs par défaut de l'extension écraseront votre configuration.

Mettre à jour 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 d'extensions du répertoire extensions/ExtensionName 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 exécuter le script de maintenance update.php . 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.
Ces instructions couvrent 99% des extensions. Si l'extension spécifique que vous mettez à jour possède des instructions qui diffère de celles-ci, vous devez dans ce cas suivre les instructions spécifiques à cette extension.

Désinstaller une extension

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

wfLoadExtension( 'ExtensionName' );
  • Vous devez supprimer toutes les lignes liées à la configuration de l'extension.

Développement d'extensions

Le noyau MediaWiki fournit plusieurs moyens pour que les extensions puissent changer le comportement et l'apparence d'un wiki. Ces points d'extension donnent aux extensions de la souplesse pour ajouter des fonctions et des fonctionnalités, comme afficher une page spéciale ou définir un module API. Pour débuter, référez-vous au guide de développement des extensions . Avant d'écrire une nouvelle extension, envisagez de contribuer à une extension existante ou d'aider sur une extension non maintenue .

Les utilisateurs peuvent également déposer une requête générale sur Phabricator, en espérant que leurs bonnes idées seront prises en compte par les développeurs. Voir https://phabricator.wikimedia.org/tag/mediawiki-extension-requests/

Voir aussi

Retrieved from "https://www.mediawiki.org/w/index.php?title=Manual:Extensions/fr&oldid=7886965"