Help:Gebruik van scripts
Van Wikipedia
Op deze pagina wordt uitgelegd hoe u zelf scripts kunt toevoegen aan uw zogenaamde monobook.js. In dat bestand kunt u javascript gebruiken om extra functionaliteiten aan wikipedia toe te voegen of het uiterlijk van een pagina binnen wikipedia aan te passen. Daarnaast is er een uitleg over hoe u zelf scripts kunt schrijven.
Inhoud |
[bewerk] Bestaande scripts
[bewerk] Vereisten
De meeste scripts werken alleen met de Monobook skin. U kunt bij uw voorkeuren aangeven dat deze skin gebruikt moet worden. U kunt natuurlijk altijd even proberen of een script ook met een andere skin werkt.
[bewerk] Zoek een script
De volgende stap is natuurlijk het zoeken naar een script dat u wilt gebruiken. Populaire voorbeelden zijn Navigation popups en Zeusmodus. Een grote collectie scripts kunt u vinden op en:Wikipedia:WikiProject_User_scripts en diens subpagina en:Wikipedia:WikiProject_User_scripts/Scripts.
[bewerk] Installeer script
Als u een script heeft gevonden, ziet u dat deze bestaat uit een aantal regels code. Deze moet u vervolgens toevoegen aan uw monobook.js. N.B. indien u een andere skin dan Monobook gebruikt, zult u het moeten toevoegen aan diens javascript bestand. Het toevoegen doet u simpelweg door de code te kopiëren en te plakken in het bewerkscherm van monobook.js. Vervolgens slaat u dit op en zult u de cache van uw browser moeten legen, zie daarvoor de instructies op de monobook.js pagina.
Sommige scripts hebben bepaalde functies nodig om ze te laten werken. Op de pagina met uitleg over een script zal men dit vermelden. U dient die benodigde functies ook aan uw monobook.js toe te voegen. Dit hoeft u maar één keer te doen, ook als meerdere scripts dezelfde functie gebruiken.
Nadat u deze stappen heeft uitgevoerd zou het script moeten werken. Indien dit niet het geval is en u weet niet waar het aan ligt, kunt u een bericht plaatsen bij de Helpdesk. Daar zal iemand u waarschijnlijk wel verder kunnen helpen.
[bewerk] Scripts schrijven
[bewerk] Vereisten
Naast de hierbovengenoemde vereisten zult u over kennis van javascript moeten beschikken. Daarnaast is het handig om bestaande scripts te hebben bekeken en/of toegevoegd aan uw monobook.js.
[bewerk] Bestaande functies
Er zijn al een aantal bestaande scripts die functies bevatten die u in uw eigen script kunt gebruiken.
Onderstaande links zijn allemaal naar de Engelstalige wikipedia.
| Naam | Doel |
|---|---|
| Add LI Link | Voegt een link list-item toe als laatste child van een gegeven element |
| Get Page Name | Geeft de titel van de huidige pagina |
| Get tidy title | Geeft de URL versie van de titel van de huidige pagina |
| addLink | Een verbeterde versie van Add LI Link |
Daarnaast kunt u de functie addOnloadHook() gebruiken om een functie uit te voeren bij het laden van de pagina, voor het gebruik hiervan zie hieronder.
[bewerk] Script schrijven
[bewerk] Navigatie link toevoegen
Met behulp van dit script wordt een link naar de kroeg toegevoegd aan de navigatiebox links in beeld. Om het te laten werken moet u ook addLink toevoegen aan uw monobook.js.
//Voer handeling uit bij het laden van de pagina
addOnloadHook( function(){
//Voeg de link toe m.b.v. de functie addLink
addLink("p-navigation", "http://nl.wikipedia.org/wiki/Wikipedia:De_kroeg", "De Kroeg", "n-kroeg", "De kroeg", 0);
});
De functie addLink voegt hierbij een link toe aan p-navigation met als adres http://nl.wikipedia.org/wiki/Wikipedia:De_kroeg, naam De Kroeg, id n-kroeg, tooltip De kroeg en dit wordt helemaal achteraan toegevoegd.
[bewerk] Verberg uw wijzigingen
Met behulp van dit script wijzigen we de link naar uw volgpagina dusdanig dat uw eigen wijzigingen niet getoond worden. Het is afkomstig van en:Wikipedia:WikiProject User scripts/Scripts/hideOwn.js.
//Voer handeling uit bij het laden van de pagina
addOnloadHook(function () {
//Bekijk alle links in het document
for (var i=0; i<document.links.length; ++i) {
//Als in het adres 'Speciaal:Watchlist' voorkomt
if (document.links[i].href.indexOf('Speciaal:Watchlist')>0) {
//voeg '?hideOwn=1' toe aan het adres
document.links[i].href+='?hideOwn=1';
break;
}
}
});
Dit script kunt u ook aanpassen om bijvoorbeeld standaard enkel anonieme wijzigingen te bekijken met de recente wijzigingen link in de navigatie box.
[bewerk] Voer functie uit
In dit script voegen we een tabblad toe aan de pagina. Als er op de link geklikt wordt moet de functie mijnfunctie() worden uitgevoerd. Om het te laten werken moet u ook addLink toevoegen aan uw monobook.js.
Ten eerste laten we de tab toevoegen:
addOnloadHook( function (){
addLink("p-cactions", "javascript:mijnfunctie('test')", "Mijn functie", "ca-mijnfunctie", "Voer mijnfunctie uit", 0);
});
Vervolgens moeten we aangeven wat mijnfunctie() doet. In dit voorbeeld voegt de functie een tekst toe aan het tekstveld.
function mijnfunctie(tekst) {
document.editform.wpTextbox1.value = tekst + document.editform.wpTextbox1.value;
}
Als u nu beide stukken code in uw monobook.js plaatst, kunt u op een tabblad met de tekst Mijn functie klikken. Er zal dan de tekst test aan het tekstveld worden toegevoegd.
Een handige extra voorwaarde is om te kijken naar de paginanaam. Onderstaand voorbeeld zal het tabblad alleen weergeven als u de overlegpagina van een gebruiker wijzigt.
addOnloadHook( function (){
if (document.title.indexOf("Bewerkingspagina: Overleg gebruiker:") != -1)
{
addLink("p-cactions", "javascript:mijnfunctie('test')", "Mijn functie", "ca-mijnfunctie", "Voer mijnfunctie uit", 0);
}
});
function mijnfunctie(tekst) {
document.editform.wpTextbox1.value = tekst + document.editform.wpTextbox1.value;
}
[bewerk] Zie ook
- Help:gebruik van scripts/Nieuwe artikelenscript
- Gebruiker:Zanaq/Zeusmodus
- Script om de bewerkingen van een bepaalde gebruiker tijdelijk uit de lijst met recente wijzigingen te filteren
- Anti-vandal tool
Onderstaande links verwijzen allen naar de Engelstalige wikipedia.
