Manual:Extensions/fr

{| style="border: 2px solid #aaa; padding: 1em 2em; margin: 1em 0 2em 0; width:auto; margin:0 auto; float: left" |

Qu'est-ce que c'est qu'une extension ?
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 ou bien demander une nouvelle extension. Les administrateurs système peuvent installer (ou désinstaller) des extensions sur les systèmes MediaWiki qu'ils gèrent. Les développeurs peuvent écrire de nouvelles extensions ou bien améliorer/maintenir des extensions existantes.

Recherchez les extensions par mot(s)-clé(s) :
 * style="textalign: center; valign: middle; padding: 0 2em" |


 * }

En fonction de vos objectifs, vous pouvez utiliser des extensions pour :


 * étendre la syntaxe wiki pour écrire des articles - consultez les catégories extensions des fonctions parseur et extensions parseur pour avoir des exemples.
 * ajouter des nouvelles possibilités au niveau reporting et administration - consultez la catégorie extensions pages spéciales pour avoir des exemples.
 * changer l'apparence du logiciel - consultez la galerie des styles utilisateur et la catégorie extensions interface utilisateur pour avoir des exemples.
 * étendre la sécurité via d'autres mécanismes d'authentification - consultez la catégorie extensions authentification et autorisation pour avoir des exemples.

Certaines extensions sont maintenues par les développeurs MediaWiki, d'autres sont écrites par des développeurs tiers. De ce fait, un certain nombre 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 risques et périls. Lorsque l'utilisation d'une extension réclame d'ajouter des patches dans le noyau MediaWiki ou des entrées supplémentaires dans votre(vos) base(s) de données, assurez-vous d'effectuer une sauvegarde de votre base de données et/ou du code noyau MediaWiki de façon à éviter de planter de façon permanente votre wiki.

Navigation dans les extensions
Vous pouvez naviguer dans la catégorie Extensions par catégorie ou Matrice des extensions pour voir la majeure partie des extensions qui ont été écrites. may also be helpful to pick out extensions. 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, mais tous peuvent vérifier quelles extensions sont installées sur une version de MediaWiki en accédant à la page spéciale Spécial:Version. Par exemple, voici la liste des extensions actives sur la Wikipédia francophone.

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'
 * Certaines extensions requièrent un patch. Un bon nombre d'entre elles fournissent aussi des instructions pour les installer via des commandes unix. Vous aurez besoin d'un accès shell (SSH) pour entrer ces commandes énumérées dans les page d'aide de l'extension.
 * 1) Téléchargez votre extension.
 * Les extensions sont généralement distribuées sous forme de packages modulaires.
 * 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 /fr|IP]]/extensions/ .  Une liste des extensions documentées est disponible sur la page Matrice des extensions, et une liste des extensions stockées sur le répertoire SVN de Wikimedia est disponible à svn:trunk/extensions. Certaines extensions sont disponibles sur [ ce wiki].
 * Des regroupements (en anglais Bundles) non officiels d'extensions stockées dans la base de connaissance SVN de Wikimedia peuvent être trouvés sur le serveur d'outils.
 * 1) Installez votre extension..
 * Généralement à la fin du fichier, (mais au-dessus de délimiteur de fin de code PHP " " s'il est présent), la ligne suivante devrait être ajoutée :
 * This line forces the PHP interpreter to read the extension file, and thereby make it accessible to MediaWiki.
 * Some extensions can conflict with maintenance scripts, for example if they directly access $_SERVER (not recommended).
 * In this case they can be wrapped in the conditional so maintenance scripts can still run.
 * In this case they can be wrapped in the conditional so maintenance scripts can still run.


 * The maintenance script will fail for any extension which requires customized namespaces which is included inside the conditional above such as,.


 * Ensure that required permissions are set for extensions!
 * While this installation procedure is sufficient for most extensions, some require a different installation procedure. Check your extension's documentation for details.
 * If you want to alter configuration variables in LocalSettings.php, you have to do this typically after including the extension. Otherwise defaults defined in the extension will overwrite your settings.
 * While extension declaration can be placed in other places within the LocalSettings.php file, never place extensions before the  line for MediaWiki versions below 1.17 . Doing so will blank the extension setup function arrays, causing no extensions to be installed, and probably will make your wiki inaccessible until you fix it!

Upgrading an extension
Some extensions require to be updated whenever you update MediaWiki, while others work with multiple versions. To upgrade to a new version of an extension:


 * 1) Download the new version of the extension
 * 2) Replace all the extension files in the extension/ExtensionName directory with the new files. Do not remove the extension configuration present in LocalSettings.php
 * 3) Depending on the extension, you may have to run the Update.php maintenance script. Most extensions will mention if this script needs to be run or not. (Running the update.php script when its unnecessary will not hurt anything, so if you're unsure don't be afraid to run it). If you don't have command line access, you can also use the web updater.
 * 4) That's all you need to do. In most cases any extension configuration you have in LocalSettings.php will also work with the newer version of the extension.

These instructions cover 99% of extensions. If the specific extension you are upgrading has instructions that differ from these, you should probably follow the specific extension's instructions

Uninstalling an extension
Extensions are added by adding a line to LocalSettings.php, which basically looks like this:

Depending on the extension you want to uninstall additionally other stuff might be done on installation, which you want to undo now. For details see the section on installing an extension.


 * 1) Remove this line and the extension is uninstalled. If you want to, you can (and if you do not want to use this extension in the future you should) remove the files of this extension inside the folder "extensions/".
 * 2) Maybe you also have some other lines in LocalSettings.php, which have to do with the extension you want to remove. Most likely this will be lines, which give certain users the right to access pages, which are provided by the extension. These lines contain the variable "$wgGroupPermissions" and make some settings there. As far as they have to do with rights, which come from the removed extension, you can remove these lines as well.
 * 3) Maybe your extension also has added columns to your database. The updater maintenance/update.php removes them, when you run it, after you have uninstalled the extension.

Developing extensions
This complex topic is handled on the developing extensions manual page.