Een userscript voor de resultatenlijsten

An English version of this article can be found here.

Een poosje geleden ben ik beginnen experimenteren met userscripts. Een userscript is een extern stukje Javascript-code dat gerund kan worden op een bepaalde website of webpagina maar dat er geen deel van uitmaakt. Een userscript wordt normaal gezien niet gemaakt door de webmaster van een website maar door iemand anders, een gebruiker.

Voor mijn eerste userscript heb ik wat code geschreven om de gebruikservaring voor de resultatenlijsten van de jaarlijkse Intersteno-internetwedstrijd te verbeteren. Het script werkt ook voor de resultaten van de nationale wedstrijden.

Ik werd niet echt vrolijk van hoe die lijsten eruitzagen, dus heb ik mijn eigen CSS toegevoegd, de kolombreedtes aangepast, enkele ongerijmdheden weggewerkt, de Nederlandse, Franse, Duitse en Spaanse vertalingen verbeterd (Engels en Italiaans waren oké), een keuzelijst toegevoegd waarmee je de resultaten kunt filteren op land, en een knop toegevoegd die je toelaat uit het beperkende iframe van de Intersteno-website te ontsnappen en de resultatenlijsten in een volledig browservenster te bekijken.

Best indrukwekkend wat je allemaal met een userscript kunt doen, vind je niet?

Hieronder zie je hoe een resultatenlijst er op de Intersteno-website uitziet wanneer het userscript in werking is (klik op de afbeelding om te vergroten):

Ter vergelijking zie je hier de originele versie van diezelfde pagina. Zoek de verschillen!

Als je het allemaal zelf eens wilt uitproberen en zien wat ik gemaakt heb, moet je twee dingen doen. Om te beginnen moet je de Tampermonkey-browserextensie installeren (mocht je dat nog niet eerder gedaan hebben). Vervolgens moet je mijn userscript installeren, dat de naam Intersteno_Internet_Results draagt.

Tampermonkey is ’s werelds populairste userscriptmanager. Het is een browserextensie die je toelaat allerlei userscripts te runnen. Je kunt je eigen userscript schrijven (zoals ik heb gedaan), maar de meeste gebruikers zullen userscripts van andere ontwikkelaars willen downloaden en installeren.

Je vindt mijn userscript (en vele andere) op een website genaamd OpenUserJS. Als je Intersteno intypt in de zoekbalk van die website, dan vind je vanzelf mijn userscript, of je kunt ook direct naar de webpagina voor mijn userscript gaan via deze link.

Nadat je Tampermonkey geïnstalleerd hebt, kun je mijn userscript installeren. Eenmaal geïnstalleerd kun je gelijk welke resultatenlijst bekijken en het verschil zien. Je kunt het script altijd in- of uitschakelen via het Tampermonkey Dashboard, waar je een overzicht vindt van alle geïnstalleerde scripts.

Waarschijnlijk zal ik van tijd tot tijd een nieuwe versie van mijn userscript publiceren. Geen nood, als je de standaardinstellingen van Tampermonkey niet gewijzigd hebt, zal je browser automatisch de nieuwste updates downloaden wanneer beschikbaar, of je kunt handmatig naar updates zoeken of opnieuw installeren wanneer je maar wilt.

Als je vragen of suggesties hebt of problemen ondervindt, contacteer me dan. Aarzel niet om eventuele bugs te rapporteren, ik zal ze proberen oplossen wanneer ik kan.

Nu hoop ik alleen maar dat de webmaster van intersteno.it – dat is de Italiaanse Intersteno-website, waar de resultatenlijsten gehost worden – geen beduidende wijzigingen aanbrengt aan de pagina’s met de resultatenlijsten. Als ze dat wel doen, werkt mijn script mogelijks niet meer...

Nuttige links:

www.intersteno.org/intersteno-internet-contests/classification-lists
www.tampermonkey.net
openuserjs.org
Intersteno_Internet_Results

Geen opmerkingen:

Een reactie posten