FANDOM


Cette fonctionnalité n'est pas disponible par défaut, mais elle peut être activée sur demande.

Les gadgets fournissent du JavaScript (JS) ou CSS personnalisés aux utilisateurs qui veulent l'utiliser. Contrairement au code dans MediaWiki:Common.js ou MediaWiki:Wikia.css, les JS et CSS compatibles avec les gadgets ne sont pas nécessairement visibles par tous les utilisateurs. Au lieu de cela, l'utilisateur choisit d'activer ou de désactiver le code dans ses préférences dans un onglet intitulé « Gadgets ».

Par conséquent, les gadgets sont peut-être mieux pensés comme un moyen de fournir aux utilisateurs de votre wiki des expériences facultatives sur l'ensemble du site. Cependant, gardez à l'esprit que les utilisateurs anonymes ne peuvent pas activer les gadgets optionnels, ou désactiver les gadgets qui sont activés par défaut.

Cette page vous donne un aperçu du processus. Pour plus de détails, veuillez vous rendre sur cette page.

Une extension

Les gadgets ne sont disponibles sur un wiki qu'après que la communauté a envoyé un message au staff demandant que la fonction — ou extension — soit activée. La condition par défaut d'un wiki Fandom est de ne pas avoir de gadgets. Il y a de fortes chances que le wiki sur lequel vous vous trouvez actuellement n'ait pas de gadgets.

Un autre détail mineur : Gadgets en majuscules fait généralement référence à l'extension elle-même, tandis que gadget en minuscules désigne généralement tout élément individuel activé par l'extension.

Définir un gadget

Une fois que l'extension Gadgets a été activée sur votre wiki, créez la liste des gadgets dans Spécial:Préférences à partir de laquelle vos utilisateurs peuvent faire leur choix. Pour ce faire, écrivez des entrées dans MediaWiki:Gadgets-definition qui contient un nom et une description du gadget, ainsi qu'une liste des extraits de code JS et CSS qu'il utilise. À ce stade, il importe peu que les pages JS et CSS existent réellement sur votre wiki ; le fait de commencer par les définitions détermine les noms des fichiers que vous pouvez ensuite créer.

Obtenir une liste de gadgets sur un wiki

Gadgets-preferences

Une section Gadgets typique de Spécial:Préférences

Lorsque les définitions de vos gadgets seront prêtes, les gadgets apparaîtront dans la section « Gadgets » des préférences de tout le monde, afin que les utilisateurs puissent choisir les gadgets qui correspondent aux besoins de leur communauté. Un aperçu des gadgets ajoutés peut être trouvé sur Spécial:Gadgets, avec des liens vers les pages respectives qui les définissent, ce qui permet de mieux contrôler les gadgets des wikis. Les rubriques qui apparaissent dans vos préférences peuvent également être redéfinies ici.

Les gadgets JS qui n'utilisent pas ResourceLoader produisent une erreur dans Spécial:Gadgets sur les wikis UCP. Pour en savoir plus, rendez-vous ici.

Comment configurer un gadget

Gadgets-special

Ce à quoi ressemble Special:Gadgets

Toutes les pages personnalisées de l'espace de noms Gadget de MediaWiki que vous créez doivent être préfixées par Gadget- — comme MediaWiki:Gadget-MonSuperStyle.css ou MediaWiki:Gadget-DuJavascriptAssezCool.js.

Comme pour tout JavaScript sur Fandom, le JS compatible avec les gadgets doit passer par le processus de vérification du JavaScript, donc il ne sera pas immédiatement disponible pour votre wiki. Et, comme pour les autres pages du site, les gadgets ne peuvent être écrits qu'en utilisant du JS et du CSS.

Exemple simple

Disons que vous avez un gadget appelé GadgetCool. Vous voulez appeler un peu de JS et changer son apparence avec du CSS. Pour ce faire, vous créez une ligne, précédée d'un astérisque, dans votre page MediaWiki:Gadgets-definition. Ça pourrait ressembler à quelque chose comme ceci :

* CoolGadget|JavaScript.js|Style.css

Si le gadget était purement basé sur du JS, ne nécessitant pas de CSS particulier, vous feriez cela :

* CoolGadget|JavaScript.js

La première zone est le nom du gadget qui apparaît devant l'utilisateur. Il ne peut contenir que des lettres et des chiffres afin de fonctionner correctement. Si le nom est GadgetCool, la page correspondante de l'espace de noms MediaWiki sera MediaWiki:Gadget-GadgetCool. Cette page est cruciale, car elle vous permet de définir un texte de description qui sera affiché dans la section Gadgets de vos préférences.

Le deuxième champ et les suivants définissent les pages qui composent le code. Dans l'exemple ci-dessus, JavaScript.js et Style.css seraient respectivement MediaWiki:Gadget-JavaScript.js et MediaWiki:Gadget-Style.css.

Notes importantes

  • Assurez-vous de donner aux personnes qui visitent votre wiki un résumé suffisant de ce que fait le gadget sur sa page de description (MediaWiki:Gadget-GadgetCool, par exemple). Ne dites pas qu'il fait une chose — alors qu'en fait il fait quelque chose de complètement différent. Rappelez-vous que le but des gadgets est de donner à vos utilisateurs un choix sur la façon d'utiliser votre wiki. Et pour cela, les utilisateurs ont besoin d'informations précises.
  • Nous avons délibérément choisi des noms différents pour chacun de ces trois composants — nom, page JS et page CSS — juste pour rendre les choses super claires pour cet exemple de base. En pratique, sur un wiki comportant de nombreux gadgets différents, vous garderez probablement tous les noms identiques pour les différencier des « autres » gadgets. Par exemple, vous aurez probablement MediaWiki:Gadget-GadgetCool (nom), MediaWiki:Gadget-GadgetCool.js (JS), et MediaWiki:Gadget-GadgetCool.css (CSS).

Voir aussi

Plus d'aide

Sauf mention contraire, le contenu de la communauté est disponible sous licence CC-BY-SA .