MediaWiki:Gadget-ScriptSidebox/Documentation

Un livre de Wikilivres.

Le gadget "ScriptSidebox" permet d'ajouter de nouvelles boîtes de liens sur le côté gauche des pages, en utilisant les fonctions dans votre script personnel (common.js, monobook.js, vector.js, ...).

Utilisation

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

  1. Créez la boîte en appelant la fonction createLinkbox en lui attribuant un identifiant unique, un titre, et un préfixe unique.
    • Exemple :
      var mybox = createLinkbox("MYBOX","Ma boîte","mb");
      
  2. Ajoutez les liens en appelant les méthodes de l'objet retourné :
    addLink(id_suffix, text, title, url, akey)
    Ajouter un lien.
    addWikiLink(id_suffix, text, title, url, akey)
    Ajouter un lien wiki.
    Exemple :
mybox.addWikiLink('random', 'Une page au hasard',
    'Afficher une page au hasard', 'Special:Random', 'x');

Les paramètres sont :

id_suffix
Identifiant unique pour le lien,
text
Texte du lien,
title
Texte affiché au survol du lien,
url
URL de la page web(addLink), ou chemin de la page wiki (addWikiLink),
akey
Touche d'accès, ex: 'x'.

Exemple de script

var mybox = createLinkbox("MYBOX","Ma boîte","mb");

mybox.addWikiLink('random', 'Une page au hasard',
    'Afficher une page au hasard', 'Special:Random', 'x');