MediaWiki:Gadget-ScriptToolbar/Documentation

Le gadget "ScriptToolbar" permet la création de barres d'outils séparées. Chaque barre possède un titre et peut être affichée ou cachée (mémorisation par cookie).

Un exemple :

Utilisation

Dans votre script personnel (common.js, monobook.js, vector.js, ...) :

1. Créez la barre d'outils en appelant la fonction createToolbar(id, titre) en lui attribuant un identifiant unique et un titre.
   • Exemple: var mabarre = createToolbar( "MYBAR" , "Ma barre d'outils" );
2. Ajouter des boutons à la barre, en appelant les méthodes de l'objet créé :

   addButton(imageFile, speedTip, tagOpen, tagClose, sampleText, summary)

   Ajouter un bouton d'édition.

   • Exemple: mabarre.addButton(url_wpen+'c/c8/Button_redirect.png','Redirection',"#REDIRECT [[","]]",'nom de la destination');

   addModel(imageFile, text, summary)

   Ajouter un bouton d'insertion de modèle.

   • Exemple: mabarre.addModel(url_wpfr+"e/eb/Button_accueilB.png","{{subst:" + "Bienvenue" + "}}" + "--" + "~~" + "~~", "Bienvenue !");

   addScript(imageFile, speedTip, code, summary)

   Ajouter un bouton appelant un code javascript.

   • Exemple: mabarre.addScript(url_wpcm+"c/cb/Button_wikipedia.png", "Importation des liens de wikipédia", "replaceExtLinks('w')");

Ces méthodes ont des paramètres communs :

imageFile

Le nom de l'image du bouton (obligatoire),

speedTip

Texte affiché lors du survol du bouton par la souris (obligatoire),

summary

Texte à placer dans le champ "Résumé" (optionnel).

Exemple de script

var mabarre = createToolbar( "MYBAR" , "Ma barre d'outils" );

mabarre.addButton(url_wpen+'c/c8/Button_redirect.png',
    'Redirection', "#REDIRECT [[","]]",'nom de la destination');

mabarre.addModel(url_wpfr+"e/eb/Button_accueilB.png",
    "{{subst:" + "Bienvenue" + "}}" + "--" + "~~" + "~~", "Bienvenue !");

mabarre.addScript(url_wpcm+"c/cb/Button_wikipedia.png",
    "Importation des liens de wikipédia", "replaceExtLinks('w')");

Cookies

Ce gadget utilise des cookies pour mémoriser les informations suivantes :

• La liste des barres d'outils visibles.

Par défaut ces cookies sont mémorisés durant 1 an. Pour modifier cette durée dans votre script personnel (common.js, monobook.js, vector.js, ...), modifiez la variable CookiesLifeTimeYears. Exemple :

CookiesLifeTimeYears = 10; // 10 ans