Jump to content

Extensions

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

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

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 sont non entretenues; toutes les extensions ne fonctionnent pas avec 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

Balises de l'analyseur

Les balises de l'analyseur étendent le marquage intégré du wiki avec des capacités supplémentaires, allant du simple traitement de chaîne à la récupération globale d'informations.

Fonctions de l'analyseur syntaxique

Les fonctions d'analyse syntaxique sont des syntaxes spéciales de marquage du wiki pouvant 'interagir' avec d'autres éléments de wiki dans la page, et produire une sortie particulière.

Accroches

Les accroches permettent d'exécuter un code personnalisé quand un événement défini se produit (tel que l'enregistrement d'une page, ou un utilisateur qui se connecte).

Pages spéciales

Les pages spéciales sont des pages créées par le logiciel sur demande, pour réaliser une fonction spécifique.

Habillages

Les habillages permettent aux utilisateurs de personnaliser l'apparence et le comportement de MediaWiki.

Mots magiques

Les Mots magiques sont une technique pour faire correspondre un ensemble de chaînes textuelles wiki à un ID unique associé à une fonction.

API

MediaWiki fournit une API action, un service web qui permet l'accès à certaines fonctionalités du wiki comme l'authentification, les opérations sur les pages, et la recherche.

Modèles de pages de contenu

Le ContentHandler introduit dans MediaWiki 1.21 permet que les pages wiki puissent contenir des données autres que le texte wiki, mais aussi des données JSON ou Markdown.

Authentification

MediaWiki fournit SessionManager et AuthManager, deux environnements liés à l'authentification et qui permettent d'étendre la sécurité via des mécanismes d'authentification personnalisés.

Trouver les extensions

Vous pouvez naviguer dans la catégorie Catégorie:Extensions par catégories 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érifier les 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.

Extensions populaires

Il existe plusieurs manières de trouver les extensions populaires.

Le premier ensemble est formé par les extensions livrées avec MediaWiki (dont la liste est revue régulièrement et à laquelle chacun peut proposer des ajouts).

Les extensions téléchargées de MediaWiki.org via le mécanisme ExtensionDistributor rassemblent quelques statistiques. Les 15 extensions les plus téléchargées sont listées dans Special:ExtensionDistributor, et les extensions applicables ont dans leur boîte d'information, un compteur de leur nombre de téléchargements. Notez que ces chiffres ne prennent pas en compte les autres manières dont les extensions ont été installées, comme par par Git ou Composer.

Une troisième 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.


Installation d'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.

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 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.

Suppression d'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.

Voir aussi