Aller au contenu

MediaWiki:Gadget-ScriptToolbar/Documentation

Un livre de Wikilivres.

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