MediaWiki:Gadget-ScriptToolbar/Documentation

Un livre de Wikilivres.
Sauter à la navigation Sauter à la recherche

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 : MesBarresDOutils.jpg

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