Bedankt voor het gebruiken van de GoT Tracker!
Dit handig stukje DHTML wordt u aangeboden door: MickMack (de bedenker) en crisp (de scripter).

Wat doet dit fantastisch programmaatje nou eigenlijk? Nou, het volgt alle topics op dit te gekke forum dat Gathering of Tweakers heet.
Net als de meeste andere fora is dit forum opgedeeld in zogenaamde subfora; omdat het praktisch onmogelijk is om in alle subfora van je interesse tegelijkertijd te zijn houdt dit programma de active topics op die subfora in de gaten, en laat ze in een overzichtelijk lijstje zien.

Omdat dit 'programma' volledig geschreven is met behulp van DHTML heb je alleen maar een geschikte browser nodig om het te kunnen gebruiken. Je hebt dus geen webserver met PHP of iets dergelijks nodig. Op dit moment worden IE5.0 en hoger en de meest recente versie van Mozilla/Netscape ondersteund.

OK, waarschijnlijk wist u al wat dit programma doet, en kwam u hier voor hulp. Eigenlijk spreekt het allemaal wel een beetje voor zich; u weet al hoe u het programma kan starten, anders had u dit bestand niet gevonden. Ik zal het voor de zekerheid echter toch maar uitleggen:

Als u het tracker.zip bestand gedownload heeft is het eerste wat u moet doen een aparte map aanmaken en de inhoud van dit bestand in die map uitpakken, waarbij U ervoor dient te zorgen dat de ingebouwde map-structuur bewaard blijft.

Omdat Mozilla/Netscape browsers een veel strictere beveiliging hanteren in vergelijking met Internet Explorer (!) is het ook noodzakelijk om toegang te verschaffen aan een aantal eigenschappen van het XMLDocument object als u de Tracker wilt gebruiken met een van deze browsers. Daarvoor moet u de volgende 7 regels invoegen in het all.js bestand in de ../Mozilla/defaults/pref map (waar .. de the map is waar Mozilla/Netscape is geinstalleerd):

pref("capability.policy.default.XMLDocument.getElementsByTagName", "allAccess");
pref("capability.policy.default.XMLDocument.documentElement", "allAccess");
pref("capability.policy.default.Element.childNodes", "allAccess");
pref("capability.policy.default.Element.tagName", "allAccess");
pref("capability.policy.default.Text.nodeValue", "allAccess");
pref("capability.policy.default.HTMLCollection.length", "allAccess");
pref("capability.policy.default.HTMLCollection.item", "allAccess");

Deze setting kunnen ook per gebruiker worden ingestel in het prefs.js bestand in de gebruikersmap; in dat geval dient 'pref' te worden gewijzigd in 'user_pref'.
U kunt optioneel deze policies beperken tot de locatie van het script dat de XML verzorgt, namelijk http://gathering.tweakers.net/forum/hottopic_xml.
Voor meer informatie over het aanpassen van de all.js policy file, ga naar http://www.mozilla.org/projects/security/components/ConfigPolicy.html.

Verder is er geen installatieprocedure, maar kunt u de Tracker direct starten op een van de volgende manieren:

1) Door te dubbelklikken op het bestand tracker.html; dit zal de Tracker in een normaal browservenster opstarten, niks bijzonders aan.

2) Door te dubbelklikken op het bestand loadtracker.html; dit zal de Tracker in een pop-up venster starten. Nou, dat is pas leuk!

3) Door het bestand desktop.html als bureaublad in te stellen (Active Desktop). Als u de bureaublad iconen tijdelijk uitschakeld kunt u zelfs de Tracker positioneren waar u wilt (en u dacht dat de tweede optie al bijzonder was?!)

Tijdens het opstarten van het script krijgen Mozilla/Netscape gebruikers een beveiligings waarschuwing, die bevestigt dient te worden wil de Tracker werken.

Nu komen we bij het leuke gedeelte: uw eigen voorkeuren instellen! Wat is er zowel in te stellen zult u zich afvragen; nou, eigenlijk alles wel zo'n beetje met wat HTML, JS en CSS kennis (er is vast wel ergens een tuutje te vinden).
Voor de kleurtjes, mouse-over effectjes enzovoorts kunt u terecht in bestand style.css. Een beetje spelen met de waarden levert al gauw effect op!

Alle programma-instellingen zijn in principe voorgedefinieerd in bestand tracker.html, maar we hebben voor u een prachtige interface gemaakt waar al deze opties zijn in te stellen vanuit de Tracker zelf. Deze instellingen worden opgeslagen in een cookie, zodat u ze niet kwijt raakt nadat u de Tracker hebt afgesloten!

Laten we eens de opties van de Tracker langsgaan aan de hand van de iconen:

 Dit icoon is om de verversing te pauzeren. Standaard wordt de lijst om de 120 seconden ververst. Als u op dit icoon klikt wordt de verversing gepauzeerd en verandert het icoon hierin: . Als u hierop klikt zal de lijst ververst worden, en begint het aftellen weer.

 Dit icoon opent een nieuw venster waarin u uw opvolg topics kunt organiseren. Opvolg topics zijn topics die door u geselecteerd zijn, en waarvan de Tracker u op de hoogte kan stellen door middel van een pop-up of een geluidje wanneer er een nieuw bericht in het topic is geplaatst!

 Dit icoon opent een nieuw venster waarin u kunt kiezen welke fora u in de gaten wilt laten houden, niets meer, niet minder...

 Dit icoon opent een nieuw venster waar u uw voorkeuren voor de Tracker kunt wijzigen. Eigenlijk zo'n beetje alles is hier wel aan te passen...

Maar ik moet u nog meer vertellen, bijvoorbeeld dit icoon: , dat voor elk topic staat. Als u dit hokje selecteerd veranderd het in: . Dat wil zeggen dat het topic een opvolg topic is. Het zal nu ook te zien zijn in het opvolg topic venster.

De Tracker kan ook topics volgen zonder pop-ups of geluidjes; in het opvolg topic venster worden alle topics met nieuwe berichten vet weergegeven, met het aantal nieuwe berichten erachter. Handig als u even weg bent!
Het opvolg topics venster heeft een zogenaamd context men dat u op kunt roepen door met uw rechtermuisknop op een topic te klikken. Dit menu heeft 3 opties:
-Openen; opent het topic in een nieuw venster net als wanneer u er normaal op geklikt zou hebben.
-Markeren als gelezen; als het topic vet wordt weergegeven omdat het nieuwe berichten heeft, kunt u met deze optie het topic weer normaal weergegeven laten worden zonder het topic echt te openen.
-Verwijderen; deze optie verwijderd het topic uit de opvolg topics lijst (en zal het dus niet meer gevolgt worden voor nieuwe berichten).

Het opvolg topics venster zelf heeft ook 2 iconen:

 Dit icoon is om handmatig een nieuw topic toe te voegen aan de opvolg topics lijst. In een nieuw venster wordt gevraagd een topic nummer, titel en het subforum in te vullen. De titel wordt overschreven door de echter titel als het topic actief is bij een volgende verversing.
Een alternatieve manier om snel topics toe te voegen is door middel van het klembord. Er is een speciale optie in de voorkeuren die het klembord in de gaten kan houden. Als u een topic-url kopieerd vanuit de adresbalk van uw browser venster komt automatisch het nieuw topic venster te voorschijn met het topic nummer al ingevuld! (Dit werkt alleen onder IE; bij Mozilla/Netscape browsers is deze optie gedeactiveerd)

 Dit icoon is om alle topics uit de opvolg topics lijst te verwijderen.

Verder heeft de opvolg topics lijst een handige sorteer functie; u kan de lijst sorteren door op een kolom titel te klikken. Deze optie kan nog wel eens traag zijn op oudere pc's, ondanks dat het aantal opvolg topics standaard gelimiteerd is tot 30. In dat geval is het raadzaam de sorteer optie helemaal uit te schakelen in de voorkeuren.

Het forum select venster heeft ook een icoon dat er als volgt uitziet: . Omdat net als alles op het internet fora ook aan verandering onderhevig zijn hebben we een automatische update feature voor de subforum lijst. Als u ontdekt dat u subforums mist, of dat sommige niet meer bestaan of anders heten, dan kunt u deze optie gebruiken om het forum definitie bestand automatisch te downloaden en te installeren vanaf onze website!

Nu dan wat standaard vragen (en antwoorden) die u kunt hebben:

V: De Tracker werkt niet als ik 'm op m'n website zet :(
A: Dat klopt; de Tracker is gemaakt om lokaal te werken op een PC. Voor een web-oplossing zult u de XML van GoT moeten parsen met behulp van een server-side parser. De Microsoft ActiveX XML-parser werkt alleen lokaal; dit is geen bug, maar een beveiliging.

V: Hoe kan ik de Tracker integreren met mijn Active Desktop?
A: Check bestand desktop.html voor een voorbeeld.
Als u een AD programma gebruikt waar u links in kunt vullen, dan kunt u gewoon een link naar tracker.html, of tracker.html?type=desktop opnemen.

V: De Tracker werkt niet in Opera/Andere browser!
A: Opera is een leuke browser, maar staat erom bekend niet goed met DHTML om te kunnen gaan. De XML parser is compatible met de Microsoft ActiveX parser, en de XML/DOM parser van Mozilla, dus de meeste andere browsers zullen niet werken... (NS6.x werkt trouwens ook niet, omdat de laatste NS6 versie nog steeds gebaseerd is op Mozilla 0.9.4, en die werkt ook niet. Probeer de preview van NS7.)

V: Waarom werkt de Tracker niet met versie 4 van IE/Netscape?
A: Omdat dit echt antieke browsers zijn uit een tijd dat XML nog niet eens bestond. Upgraden is mijn advies!

V: Waarom laat een link naar een topic me niet de laatste pagina van het topic zien?
A: Om de link goed te laten werken moet het aantal berichten per pagina in de voorkeuren van de Tracker gelijk zijn met uw voorkeur op GoT. Echter, als u vanuit het opvolg topics venster op een link geklikt had met zeg maar 50 nieuwe berichten, dan wordt u doorgelinkt naar de pagina waarop het eerste nieuwe bericht staat sinds het toevoegen aan de opvolg topics lijst; dit is express zo bedoeld.

V: Hoe kan ik de titels onder mijn bureaublad iconen transparant maken als ik Active Desktop gebruik?
A: Met een stukje software zoals Window FX.

V: Waarom wordt het Tracker venster op mijn Active Desktop niet groter/kleiner als ik het aantal topics verander in mijn voorkeuren?
A: Helaas is de Active Desktop niet zo dynamisch; u zult de grootte van het venster handmatig moeten wijzigen in bestand desktop.html. De juiste hoogte kan berekend worden middels de volgende formule: (aantal topics * 13) + 29.

V: De Tracker op mijn Active Desktop wil geen topics meer laden!?
A: Na een aantal keer wijzigen van de AD kan dit probleem inderdaad optreden. De enige remedie is rebooten...

V: Waarom kan ik de Tracker op mijn Active Desktop niet verplaatsen?
A: Om de Tracker te kunnen verplaatsen op een Active Desktop moet u eerst de bureaublad iconen tijdelijk uitschakelen (optie zit ergens in het contextmenu als u rechtsklikt op het bureaublad).

V: Als ik een opvolgtopic wil toevoegen krijg ik de melding dat het maximum aantal topics is bereikt?
A: Omdat ik gebruik maak van cookies om alle informatie van die topics in op te slaan (tijden, titels, topic nummers enz.) samen met alle voorkeuren, en een cookie slechts 4KB aan informatie kan bevatten, is het aantal opvolgtopics beperkt. Als je meer informatie toevoegd dan een cookie kan bevatten zal dit leiden tot verlies van data; als je zeker weet dat jouw browser grotere cookies aankan, dan kan je de waarde van de variabele CookieLimit in tracker.html ophogen.

V: Waarom is het sorteren van de opvolg topics zo traag?
A: Pffff, heb ik me daarvoor staan uitsloven? De sorteer routine is al zo snel mogelijk gemaakt, en het is nog te traag?
Koop dan maar een nieuwe pc, of schakel de sorteer optie uit in de voorkeuren, dit kan wel een paar seconden schelen op sommige systemen ;)

V: Help! Ik krijg allemaal javascript errors, en de Tracker werkt niet meer!!!???
A: Allereerst: rustig maar, geen paniek! Het is niet het einde van de wereld, hoewel het misschien wel zo lijkt ;) Neem nog een biertje en surf ondertussen even naar dit topic op GoT en leg uit wat voor errors u precies kreeg.
Als een alternatief kunt u de debug opties genoemd op deze pagina proberen om de Tracker te starten.

V: Hoe kan ik ervoor zorgen dat de Tracker mijn eigen berichten in een topic niet als nieuw bericht ziet?
A: Voer uw GoT gebruikersnaam in in de voorkeuren, en zorg ervoor dat het correct gespeld is. Hierdoor weet de Tracker dat hij uw berichten moet negeren.

V: Wat betekent 'klembord controle'?
A: Nee hoor, dat betekent niet dat ik uw wachtwoord probeer te achterhalen. Het is de eerder genoemde optie om snel topics toe te kunnen voegen door het topic-url te kopieeren vanaf de adres balk van uw browser.

V: Waarom hoor ik geen geluidjes?
A: Allereerst kunt u even controleren of de bestandsnaam in uw voorkeuren goed is ingevuld, en dat het bestand bestaat. Als het bestand in de Tracker map staat hoeft er geen pad voor te staan, anders moet een volledig pad worden opgegeven.
Het kan zijn dat u een bepaalde plug-in mist, maar ik zou niet weten welke omdat mijn browser het eigenlijk vanaf het begin al goed heeft gedaan. Als u echt problemen ondervind met het geluid, schakel het dan uit in uw voorkeuren; de Tracker zal er dan in elk geval niet op kunnen crashen ;)

V: Ik krijg telkens de melding 'Verversings timeout', wat kan ik daar aan doen?
A: Waarschijnlijk bent u niet gezegend met een snelle internetverbinding, waardoor de Tracker niet binnen de default van 10 seconden de hele XML binnen kan trekken. U kunt in uw voorkeuren deze timeout ophogen naar bijvoorbeeld 20 seconden.

V: Ik kan niet inloggen op het forum als ik de sidebar gebruik!
A: Hoewel ik dit probleem zelf nog niet ondervonden heb is mij verteld dat dit op te lossen is door het URL van het forum (http://gathering.tweakers.net) toe te voegen aan de Vertrouwde Sites in de beveiligings instellingen van Internet Explorer.

Voor problemen, verzoeken of complimenten kunt u terecht in dit topic op GoT.

De officiele website: http://www.xs4all.nl/~crisp/gottracker/ (in aanbouw)

Veel plezier!

crisp