Projet:Scripts et gadgets

Utiliser une fonction

Pour bénéficier d'une des fonctionnalités présentées par le projet, vous devez posséder un compte utilisateur sur Wikipédia.

Vous pouvez consulter la liste des fonctions disponibles pour connaître la liste des codes disponibles et les procédures d'installation.

Personnaliser une fonction

Certaines fonctions sont paramétrables. Vous pouvez visualiser le code source (par l'onglet modifier). Si vous trouvez une section délimitée par des balises comme /////ZONE PERSONNALISABLE/////, vous pouvez définir d'autres valeurs pour les variables dans votre page common.js.

Les paramètres modifiables peuvent être présents dans les notices d'utilisation.

Exemple pour BandeauxEbauches :

window.BandeauxEbauches_AutoEdit = false;
window.BandeauxEbauches_KeyboardDelay = 0.5;

obtenir('BandeauxEbauches');

Si vous avez des doutes quant à votre personnalisation, vous pouvez demander un conseil sur la page Discussion Projet:Scripts et gadgets.

Signaler un bug

Pour signaler un bug concernant une fonction existante, vous pouvez utiliser la page Discussion Projet:Scripts et gadgets/Rapport de bug.

Pour une meilleure chance d'obtenir une réponse rapide, pensez à préciser la fonction incriminée, votre configuration (navigateur), ainsi que les circonstances amenant l'apparition du bug.

Demander la création d'une fonction

Pour obtenir une fonction inexistante, vous pouvez faire une demande sur la page Discussion Projet:Scripts et gadgets/Demande de fonction.

Des utilisateurs expérimentés pourront vous répondre sur la faisabilité de votre demande et si possible créeront une fonction prête à l'emploi.

Autres requêtes

Pour toute autre demande, vous pouvez vous rendre sur la page de discussion du projet.

Recommandations aux développeurs

• Les fonctions sont dans des pages qui commencent par MediaWiki:Gadget- et se terminent par .js. Il faut l'extension .js (pour être compatible avec l'extension Gadgets), la liste complète de ces pages est donc accessible via Special:Prefixindex/MediaWiki:Gadget- (et choisissez celles qui se terminent par .js). Si vous n'êtes pas administrateur d'interface, vous pouvez demander l'insertion ou la modification d'un script sur Wikipédia:Demande d'intervention sur un message système (raccourci : WP:DIMS).
• Variables permettant de personnaliser la fonction :
  • Elles sont déclarées hors de tout contexte (voir schéma dans le bloc #Personnaliser une fonction).
  • Elles ont un nom discriminatoire et préfixé par le nom de la fonction principale, ceci afin d'éviter les mélanges avec d'autres fonctions.

Tous les javascripts des wikis sont censés suivre MW:Manual:Coding conventions/JavaScript. De plus, ici :

• Les tabulations valent 4 caractères et l'indentation est propre.
• Les points-virgules en fin d'instructions doivent être présents.
• Penser à catégoriser la page.

La catégorisation d'un code s'effectue de préférence via le modèle {{Catégorisation JS}} insérée en commentaire en dehors d’éventuelles balises <syntaxhighlight>, <pre> ou <nowiki>.

Aide aux développeurs

• Cuisine des Gadgets : tout ce qu'il y a à savoir sur les gadgets
• API JavaScript de MediaWiki (OOUI, toutes les API)
• (en) mw:ResourceLoader/Core modules : liste des fonctions fournies par MediaWiki
• (en) Modifier la barre d’outils de l’éditeur de Wikitexte
• (en) mw:Recommendations for gadget developers on Wikimedia wikis