Commons:Gadgets

L'onglet de gadget des préférences sur la Wikipedia française

Les Gadgets sont des scripts utilisateurs qui étendent les fonctionnalités de MediaWiki, le logiciel utilisé par Commons, et sont facilement installables via les Préférences utilisateur (il existe d'autres scripts qui doivent être installés manuellement). Les gadgets individuels peuvent être activés ou désactivés (certains sont activés par défaut) sur la page de vos Préférences (vous devez être connecté) en cochant les cases correspondantes. La plupart des gadgets ont besoin que JavaScript soit activé dans votre navigateur pour fonctionner.

Détails techniques

Définition

• MediaWiki:Gadgets-definition est la liste des gadgets installés qui apparaissent dans les Préférences
  • L'utilisation d'un gadget peut être limitée à certains groupes d'utilisateurs en ajoutant, par exemple, rights=delete dans la définition du gadget. Les gadgets sont chargés par défaut (y compris pour les utilisateurs non connectés) en ajoutant default. L'utilisation d'un gadget peut être limitée aux utilisateurs connectés avec rights=upload.
• Special:Gadgets fournit la liste des gadgets installés, avec des liens vers les fichiers source des gadgets.
• MediaWiki:Common.js charge certains scripts automatiquement

Internationalisation

• L'internationalisation des gadgets, lorsqu'elle est nécessaire, peut être gérée de différentes façons. Habituellement, elle est gérée dans le code source, ou sur une sous-page (par exemple MediaWiki:Gadget-HotCat.js/fr), mais dans certains cas il y a plusieurs versions différentes du même script. {{Gadget-talk}} sert à catégoriser l'internationalisation et si nécessaire place les scripts dans la catégorie Category:User scripts needing internationalisation.
• L'internationalisation de la description d'un gadget est réalisée en créant des sous-pages /xx de la page de description principale (en anglais) (par exemple MediaWiki:Gadget-Cat-a-lot et MediaWiki:Gadget-Cat-a-lot/fr). La page de préférences, avec {{Gadget-desc}}, ajoute un lien "translate this" qui facilite cette opération.

Modèles

• {{Gadget-state}} enregistre des informations redondantes sur les gadgets et doit être gardé à jour. L'indication de l'état par défaut (default-state) d'un gadget est requise suite à cette demande : phab:T51501
• {{Gadget-desc}} standardise les descriptions des gadgets (pour celles qui sont affichées dans les Préférences)
• {{Gadget-help}} et {{Gadget-talk}} standardisent les entêtes sur les pages d'aide et de discussion du gadget
• {{ActivateGadget}} et {{DeactivateGadget}} génèrent des liens qui conduisent à la création de boîtes de dialogue demandant à l'utilisateur s'il souhaite activer ou désactiver un gadget
• certains gadgets documentent leur compatibilité avec les différents navigateurs sur une sous-page (par exemple Help:Gadget-PrettyLog/Compatibility) ; il existe un format commun mais pas de modèle prédéfini

Limitations

Depuis la version 1.18 de MediaWiki, les gadgets (et les configurations CSS/JS de l'utilisateur) ne sont pas chargés sur certaines pages spéciales, pour des raisons de sécurité. Ceci inclut Special:Preferences, ne permettant plus le déplacement de gadgets vers d'autres sections des Préférences. Voir phab:T20186. phab:T35220 requiert le remplacement par une version directement implantée dans le logiciel MediaWiki de ce qui était fait auparavant en Javascript.

Liens

• Category:Gadget scripts
• Commons:User Scripts - projet pour améliorer les gadgets et d'autres scripts utilisateur
• MediaWiki talk:Gadgets-definition - discussions
• mw:Extension:Gadgets - l'extension MediaWiki permettant l'existence des gadgets
• mw:Extension:Gadgets/Scripts - quelques gadgets sur mediawiki.org
• mw:ResourceLoader - environnement pour le développement de gadgets ; la V2, en développement, évolue de manière significative ; voir aussi phab:T31398 et phab:T22153
• Special:GadgetUsage indique le nombre d'utilisateurs actifs et inactifs qui utilisent les différents gadgets