Aide:Gadgets
Les Gadgets sont des ensembles de JavaScript, CSS et messages système qui se chargent ensemble pour fournir des fonctionnalités supplémentaires sur le wiki. Les utilisateurs du wiki peuvent éventuellement activer certains gadgets afin d'améliorer leur expérience de consultation et d'édition.
Tous les gadgets disponibles peuvent être consultés sur la page gadgets, avec leurs pages JavaScript et CSS associées. Ils sont divisés en sections et peuvent se charger sous certaines conditions (si l'utilisateur dispose des droits requis, uniquement sur certains espaces de noms, etc.).
En général, les gadgets peuvent être activés et désactivés dans les préférences utilisateur. Les gadgets marqués comme « par défaut » sont activés pour tous les utilisateurs par défaut, tandis que les gadgets marqués comme « masqués » ne sont pas répertoriés dans les préférences utilisateur.
Les gadgets répertoriés dans la section Outils d'édition sont des gadgets facultatifs destinés à améliorer l'expérience de l'éditeur.
Ce gadget permet aux éditeurs du wiki de purger rapidement le cache d'une seule page. Parfois, lors de la modification d'un modèle ou d'un module, certaines pages peuvent mettre un certain temps à afficher le contenu mis à jour. Un éditeur peut accélérer ce processus en purgeant la page.
Après avoir activé ce gadget dans les préférences, l'éditeur peut trouver le bouton "Purger le cache" dans le menu déroulant à côté du bouton « Modifier ». Après avoir cliqué dessus, le cache de la page est purgé et la page s'actualise. La purge peut être effectuée à l'aide de la Accesskey p. Si vous utilisez le gadget Raccourcis clavier Fandom, la purge peut-être effectué à l'aide de la touche n.
Ce gadget permet aux Project:Users#Utilisateurs autoconfirmés ou supérieurs de purger le cache d'un groupe de pages. Il est similaire au gadget purge de cache mais agit sur plusieurs pages à la fois.
Après avoir activé ce gadget dans les préférences, l'éditeur trouvera un bouton « Purge groupée » dans la barre latérale. Il ouvre une boîte de dialogue dans laquelle il est possible de saisir les noms des pages à purger. L'éditeur peut utiliser le bouton « Ajouter des pages » pour ajouter des pages provenant de l'une des sources suivantes :
- les pages qui renvoient vers une page spécifique,
- les pages qui transcluent une page spécifique (comme un modèle),
- les pages qui incluent un fichier spécifique,
- les pages qui commencent par un préfixe spécifique,
- les membres d'une catégorie spécifique, ou
- toutes les pages d'un espace de noms spécifique.
Si l'éditeur se trouve sur une page de catégorie, Page liées, Toutes les pages commençant par... ou Toutes les pages, le gadget remplit automatiquement la zone de texte avec les pages pertinentes.
Après avoir appuyé sur le bouton "Démarrer", le gadget supprime les pages de la liste par lots et signale toute erreur dans la zone de texte rouge en dessous.
Ce gadget affiche un aperçu des différences entre deux pages lorsque vous cliquez sur un lien diff (dans l'historique de la page, les modifications récentes, une autre page diff ou ailleurs) dans une fenêtre modale, sans recharger la page. Il permet de naviguer entre les pages de différences précédentes et suivantes à l'aide des flèches du clavier et offre des fonctionnalités équivalentes à celles des pages diff classiques.
Ce gadget affiche des informations sur la première et la dernière modification de la page sous le titre de celle-ci. Il apparaît sous le format suivant :
Créée le 26/9/2015, 7:21:35 AM par Wsgwsg contribs
Modifié pour la dernière fois il y a 6 jours par Webi Wabo contribs-31
Modification résumée: Les contractions sont mauvaises
Associé au gadget Diff Rapide, ce gadget permet de visualiser rapidement les modifications précédentes apportées à la page en cliquant sur le lien diff dans les informations de modification.
Ce gadget permet Project:Users#Utilisateurs autoconfirmés d'annuler rapidement les modifications. Cliquer sur le bouton "Annuler" sur n'importe quelle page de différences, historique de page ou modifications récentes fait apparaître une boîte de dialogue demandant un résumé de l'annulation. Après confirmation, le gadget annule la modification. Si l'éditeur décide que la modification nécessite une révision plutôt qu'une simple annulation, il peut ouvrir le lien "Annuler" dans un nouvel onglet.
Les modifications effectuées à l'aide de ce gadget sont marquées avec la balise quickundo tag, qui apparaît sous la forme « Annulation effectuée avec une Annulation Rapide » dans l'historique des modifications.
Ce gadget apporte les raccourcis clavier familiers de Fandom à ce wiki, et quelques autres. En appuyant sur une seule touche du clavier, ils peuvent effectuer différentes actions rapidement. Cela ressemble aux touches d'accès déjà fournies par MediaWiki, mais au lieu d'avoir à appuyer sur une combinaison de touches (qui peut parfois être interceptée par le navigateur ou le système d'exploitation et donc peu fiable), ils utilisent une seule touche. Par exemple, au lieu d'utiliser alt+e pour modifier, l'éditeur peut simplement appuyer sur e.
| Raccourci | Action |
|---|---|
| Éditeur | |
| e | Modifier la page actuelle |
| h | Afficher l'historique de la page actuelle |
| w | Vérifier les pages liées à la page actuelle |
| n | Purger la page actuelle (si le gadget purge de cache est activé) |
| m | Renommer (déplacer) la page actuelle |
| Modérateur | |
| p | Protéger la page actuelle |
| d | Supprimer la page actuelle |
Ce gadget se lie également aux touches correspondantes sur un clavier cyrillique (х pour l'historique, д pour la suppression, etc.).
Les gadgets répertoriés dans la section "Outils de modération" sont des gadgets facultatifs qui ne sont utiles qu'aux modérateurs du wiki et aux utilisateurs de niveau supérieur, et qui permettent d'effectuer certaines tâches de modération plus rapidement.
Ce gadget permet aux modérateurs de supprimer rapidement une page. Lorsqu'un modérateur clique sur un lien « Supprimer » ou « Annuler la suppression », ce gadget affiche la boîte de dialogue de suppression dans laquelle il peut saisir un motif. Les motifs de suppression par défaut sont extraits des Motifs de suppression les plus courants et des Motifs fréquents de suppression de fichiers .
Le gadget met en évidence la raison de la suppression dans le document actuel, et en appuyant simplement sur les touches Tab et Entrée, le modérateur peut rapidement naviguer vers la suppression à l'aide de son clavier. Si le gadget Raccourcis clavier Fandom est installé et que la touche d est utilisée, cela affiche immédiatement la fenêtre modale de suppression pour la page actuelle.
Les suppressions effectuées à l'aide de ce gadget sont marquées avec la balise quickdelete, qui apparaissent sous la forme "Supprimé avec Suppression Rapide" dans le log.
Lorsque de nombreuses pages doivent être supprimées en même temps, un modérateur peut utiliser ce gadget. De la même manière que purge groupée fournit une boîte de dialogue pour saisir les pages à purger, ce gadget fournit une boîte de dialogue pour saisir une liste de pages à supprimer en lot. La boîte de dialogue se compose de quatre parties :
- Motif de la suppression : le motif indiqué ici est utilisé pour la suppression de toutes les pages répertoriées.
- Ajouter le contenu de la catégorie : Le modérateur peut saisir ici le nom d'une catégorie, ce qui ajoute toutes les pages de cette catégorie à la liste des pages.
- Liste des pages à supprimer : chaque nom de page sur une ligne distincte.
- Log: si des erreurs surviennent pendant la suppression, elles sont consignées dans ce champ.
Après avoir saisi la liste des pages et le motif de suppression, un modérateur peut lancer la suppression à l'aide du bouton « Démarrer » ou la mettre en pause à l'aide des boutons « Pause » ou « Fermer ».
Les suppressions effectuées à l'aide de ce gadget sont marquées avec la balise batchdelete, qui apparaît sous la forme "Supprimée avec la Suppression Groupée" dans le log.
Ce gadget permet à un administrateur de bloquer ou débloquer un utilisateur sans quitter la page actuelle. Cela peut être fait en utilisant n'importe quel lien « bloquer », depuis l'historique de la page, les modifications récentes, Informations d'édition, ou la page des contributions de l'utilisateur. Les champs suivants sont disponibles :
- Raison du blocage: menu déroulant pour sélectionner l'un des motif de blocage les plus fréquents.
- Motif personnalisé: motif de blocage en plus de celui sélectionné dans le menu déroulant.
- Durée du blocage: une des durées de blocage prédéfinies à sélectionner.
- Détails du blocage: options de blocage additionnelles (toutes cochées par défaut) telles que:
- Empêcher la création de comptes: empêche l'utilisateur de créer un compte sur le wiki en utilisant le compte ou l'adresse IP actuels.
- Bloquer automatiquement les adresses IP de l'utilisateurs pendant 1 jour :
Tout comme Suppression rapide, ce gadget concentre le document sur la raison du blocage, permettant ainsi de bloquer un utilisateur en quelques touches Tab et Entrée.
Les blocages effectués à l'aide de ce gadget sont marqués avec la balise quickblock, qui apparaît sous la forme "Bloqué avec Blocage Rapide." dans le log.
Abréviation de "Gee, Admin, Such Tools Efficiently Restore Balance, Leaving All Spamton's Troubling Edits Reverted" (Bon sang, Admin, tant d'Efficacité des Outils pour Restorer l'Équilibre, en Annulant toutes les Modifications Problématiques de Spamton), ce gadget permet aux administrateurs de nettoyer toutes les créations et modifications de pages effectuées par un utilisateur, tout en le bloquant. Il s'agit de l'outil anti-vandalisme ultime destiné aux utilisateurs qui n'ont fait que du vandalisme sur le wiki. Il est accessible depuis la page des contributions d'un utilisateur, à la fin de la liste des liens utilisateur.
La boîte de dialogue qui s'ouvre lorsque vous utilisez les liens GASTERBLASTER se concentre immédiatement sur le bouton « Blast », permettant à l'administrateur d'effacer immédiatement les contributions de l'utilisateur en appuyant sur la touche Entrée. Cependant, dans certains cas spécifiques, l'administrateur peut souhaiter modifier les options suivantes :
- Raison: raison à utiliser lors de la restauration, du blocage et de la suppression. Par défaut, la valeur est "Vandalisme".
- Durée du blocage: durée pendant laquelle l'utilisateur sera bloqué, s'il est bloqué. La durée par défaut est de 2 semaines.
- Détails: permet d'ignorer certaines actions si certaines des modifications apportées par l'utilisateur ont été utiles ou si l'éditeur n'est pas un éditeur de mauvaise foi. Par défaut, toutes ces options sont cochées :
- Bloquer l'utilisateur
- Supprimer les pages que l'utilisateur a créé.
- Annuler les modifications apportées par l'utilisateur.
Les modifications, suppressions et blocages effectués à l'aide de ce gadget sont marqués avec la balise gasterblaster, qui apparaît sous la forme "GASTERBLASTÉ" dans le log.
Les gadgets marqués comme "Obligatoires" sont activés par défaut et ne sont généralement pas destinés à être désactivés. Cependant, si un éditeur sait ce qu'il fait, il peut tirer profit de la désactivation d'un gadget obligatoire. Par exemple :
- Si le widget Discord dans la barre latérale du wiki dérange, il peut désactiver le gadget Discord.
- S'il ne souhaite pas consulter les modifications récentes depuis la barre latérale, il peut désactiver le gadget Module des modifications récentes.
- S'il teste des boîtes de navigation personalisée, il peut désactiver le gadget "Navbox" afin d'empêcher les scripts par défaut d'affecter les boîtes de navigation.
- Si il veut que le wiki soit moche, il peut désactiver le gadget "Common Styles".
Les gadgets notés comme Corrections sont similaires à ceux marqués comme "obligatoires", sauf qu'ils effectuent des corrections sur certains composants.
Les gadgets marqués comme "Dépendances" sont des gadgets cachés qui n'apparaissent pas dans les préférences utilisateur. Ils sont destinés à être chargés par d'autres gadgets qui les utilisent comme dépendances..
Un administrateur peut développer un nouveau gadget en créant les scripts, feuilles de style et messages système pertinents dans l'espace de noms MediaWiki, puis en les répertoriant tous dans le manifeste du gadget. Un gadget se compose des éléments suivants :
- Manifest : un manifeste de gadget est une page qui définit le contenu d'un gadget et les conditions dans lesquelles il se charge. Il se trouve sous
MediaWiki:Gadgets/<name>.json. Exemple: MediaWiki:Gadgets/Discord.json. - Description: une description de gadget est un message système qui décrit ce qu'est le gadget dans Préférences et Gadgets. Elle se trouve sous
MediaWiki:Gadget-<name>. Exemple: MediaWiki:Gadget-Discord. - Scripts: un gadget peut contenir des scripts JavaScript. Ces scripts se trouvent sous
MediaWiki:Gadget-<name>.js, où le nom ne doit pas nécessairement correspondre au nom du gadget (mais c'est généralement le cas, si le gadget ne comprend qu'un seul script). - Stylesheets: un gadget peut contenir des feuilles de style CSS. Ces feuilles de style se trouvent sous
MediaWiki:Gadget-<name>.css, de façon similaire aux scripts. - System messages: un gadget peut charger certains messages dans son manifeste afin de les utiliser depuis JavaScript, généralement dans le but de localiser le gadget dans d'autres langues. Ils doivent se trouver sous l'espace de noms MediaWiki, mais ne doivent pas nécessairement avoir un format de nom de page spécifique, bien que la convention soit d'utiliser
MediaWiki:Gadget-<name>-comme préfixe.
Pour plus d'informations à propos de développement de gadgets, voir la documentation de l'extension. La documentation décrit toujours le format de manifeste obsolète, mais les mêmes principes s'appliquent.