Manual:Custom edit buttons/fr



Vous pouvez ajouter des boutons personnalisés d'édition dans la barre des outils d'édition au-dessus de la fenêtre d'édition, en utiisant JavaScript (voir ci-dessous). Il faut distinguer la nouvelle barre d'outils ajoutée par Extension:WikiEditor de l'ancienne barre d'outils (connue également comme étant la barre standard).

peut être utilisé pour vérifier si un utilisateur utilise le wikiEditor ou l'ancienne barre d'outils.



Ajouter JavaScript
Les boutons personnalisés utilisent JavaScript pour implémenter leur fonctionnalité. Pour que JavaScript opère sur la page d'édition il existe plusieurs manières d'appliquer le JavaScript à la page d'édition du Wiki :


 * JavaScript personnel &mdash; approprié sur un serveur pour lequel cette fonctionnalité est autorisée et pour les boutons que vous souhaitez voir chez les utilisateurs qui auront copié le JavaScript dans leur fichier JavaScript personnel.
 * Extension JavaScript &mdash; approprié si tous ou la plupart des utilisateurs du Wiki peuvent utiliser le bouton. Ceci suppose que vous développez une extension pour MediaWiki.
 * JavaScript du noyau MediaWiki &mdash; approprié si le nouveau bouton doit figurer sur toutes les installations du Wiki.



JavaScript personnel
Pour ajouter de nouveaux boutons, vous pouvez les inclure dans votre JavaScript personnel. Dans Localsettings.php ajoutez $wgAllowUserJs = true; ou dans Common.js ou en tant que gadget.

Extension JavaScript
After the setup of the basic extension structure, the core PHP file will need to hold (or indirectly referenced, in complex extensions), the first two steps below. For a simple extension, like one intending only to add the custom button, the third step could occur in the core extension PHP file, as in this simple sample, or could be in another PHP file. There could also be localization needs, which would be included in the I18N file.



Définir le paquet du Resource Loader
The best practice for extensions is exploitation of the Resource Loader API, which provides performance optimization as well as a standard way of accessing scripts. Cet exemple simple montre l'ajout d'un fichier JavaScript.



Référencer une accroche
L'une des accroches offerte par la page d'édition permet l'ajout d'une référence de fonction. La fonction ou la méthode référencée ici peut se trouver dans le fichier PHP principal de l'extension si l'extension est unique, ou dans un autre fichier PHP.



Définir une accroche
L' accroche de la page d'édition permet d'ajouter une référence au module du Resource Loader défini plus tôt. Ce exemple montre l'ajout sur chaque page. There could be complex logic associated with when to display and further conditions would be added in this handler. L'argument de la méthode addModules est la même chaîne de caractères que celle utilisées dans l'étape de définition du paquet.

Une fois ces trois étapes réalisées, le fichier JavaScript référencé dans l'ensemble de ressources sera appliqué à chaque page à modifier. L'API permet de gérer plusieurs fichiers et possède une granularité plus fine quant au contrôle du fichier appelé.



Noyau MediaWiki
The design criteria for additions to the core of MediaWiki exceed what are mentioned here, but the mechanics for adding buttons are described.

Les fichiers JavaScript du noyau MediaWiki sont référencés dans le fichier 'resources/Resources.php'. L'archive par défaut pour la page d'édition inclut 'resources/src/mediawiki.action/mediawiki.action.edit.js'. If the button should be displayed every time, this JavaScript file should be enhanced with the new button. If the button has conditions that the JavaScript file should not be loaded every time, steps similar to an extension should be executed and consideration should be give to whether the function belongs in the core of MediaWiki source code or whether an extension is the right tool to deliver the enhancement.

Voir aussi la personnalisation de la barre d'outils pour les options plus avancées et les exemples.

Vous pouvez aussi utiliser le script InsertWikiEditorButton (de l'utilisateur Krinkle) pour simplifier l'ajout de boutons dans wikiEditor.



Barre standard des outils d'édition

 * imageFile &mdash; URL de l'image du bouton d'édition.
 * tagOpen &mdash; balise d'ouverture, dans cet exemple :
 * sampleText &mdash; texte d'exemple à afficher entre les balises d'ouverture et de fermeture. Le contributeur doit remplacer ce texte d'exemple par son propre texte.



Voir aussi

 * Extension:WikiEditor:
 * Toolbar customization
 * Customizations library
 * List of custom edit buttons sur Wikimedia Commons
 * Reftoolbar 2.0, JavaScript du wiki qui ajoute une barre d'outils 'Cite' à l'interface utilisateur de WikiEditor.
 * Barre standard d'outils d'édition :
 * List of custom edit buttons sur Wikimedia Commons
 * Toolbar formatting buttons sur Wikimedia Commons
 * Help:Edit toolbar sur Meta-Wiki
 * Extra edit buttons sur English Wikipedia
 * More editing buttons sur English Wikisource
 * Help:Custom edit buttons de Wikia.