DownloadCounter - Anleitung

Es können sowohl Dateien als auch HTML-Seiten und sogar Bilder gezählt werden. Pro Account können unendlich viele Zähler eingerichtet werden und zu jedem stehen die gewohnten Statistiken bereit.

Um den DownloadCounter überhaupt nutzen zu können, bedarf es einigen wenigen Informationen. Der erste Abschnitt der Anleitung erklärt, wie Sie Ihre Links mit dem DownloadCounter verknüpfen, um die Aufrufe oder Downloads der dahintersteckenden Dateien zu zählen.
Hier gibt es zwei verschiedene Methoden, zwischen denen Sie frei wählen können:
- Die erste Methode ist sehr leicht umzusetzen und erfordert nur wenige Änderungen an den gewünschten Seiten; nur die Ziele der Links müssen angepasst werden. Dise Methode iegnet sich besonders für Leute, die sich nicht mit HTML auskennen und fast ausschließlich WYSIWYG-Editoren wie z.B. Frontpage Express benutzen.
- Die zweite Methode ist etwas aufwendiger zu integrieren, da sie auch Javascript einsetzt. Sie hat jedoch einen großen Vorteil: Bei der ersten Methode ist der Link auf die Funktionstüchtigkeit des DownloadCounters angewiesen. Sollte dieser aber einmal einen Server-Ausfall o.ä. haben, so führt der Link ins Leere. Die zweite Methode macht den Link unabhängig vom DownloadCounter und verursacht keinerlei zeitliche Verzögerung beim Laden der Datei. Natürlich sind Serverausfälle unüblich und werden so gut es geht vermieden, einige Leute wollen dieses Risiko aber nicht eingehen. Leider hat die Nutzung von javascript auch einen Nachteil: Surfer, die Javascript in Ihrem Browser deaktiviert haben, können die Links nicht verwenden.

Statt wie gewohnt in Ihren Hyperlinks direkt auf die Dateien zu verweisen, müssen Sie nun das Counter-Skript aufrufen und ihm den Dateinamen und Ihren Benutzernamen übergeben. Das Skript erhöht dann den Counter dieser Datei um eins und verweist dann auf die Datei. Dieser Vorgang geht normalerweise so schnell, dass der Besucher gar nichts davon mitkriegt.

Bei folgendem Beispiel soll die Datei http://www.domain.de/datei.zip gezählt und dann heruntergeladen werden können:

wird beispielsweise zu:

Weitere Angaben sind nicht nötig. Der erste Teil besteht also immer aus "http://www.DownloadCounter.de/counter.pl?file=", dann folgt die URL der Datei und letztendlich "&user=" gefolgt vom Ihrem Benutzernamen. Beachten Sie dabei bitte, dass wenn Ihr Benutzername ein Leerzeichen enthält, Sie dieses in der URL durch ein Plus-Zeichen(+) ersetzen müssen!
Die Abrufe werden völlig unsichtbar gezählt und es ist fast gar keine Verzögerung bemerkbar.

Im Unterschied zu Methode 1 wird nicht auf das Counterskript verwiesen, dass den Surfer dann auf die letztendliche Datei weiterleitet, sondern es werden zwei Verbindungen aufgebaut: Eine direkt zur eigentlichen Datei und eine im Hintergrund und unsichtbar für den Surfer zum Counterskript. Dies hat zwei Vorteile: Sollte der DownloadCounter unter einem der im heutigen Internet leider noch oft vorkommenden Serverausfälle leiden, so kann das Ziel des Links trotzdem erreicht werden, nur gezählt wird nicht. Außerdem wird so die Zieldatei direkt geladen und nicht erst das Counterskript. Die Nachteile: Der Surfer muss Javascript in seinem Browser aktiviert haben, damit die Links korrekt arbeiten und das Ganze ist etwas komplizierter zu implementieren.

Binden Sie als erstes in die Seite mit den Links folgenden Javascript-Code ein (irgendwo hinter dem <BODY>-Tag):

Disen Code müssen Sie nur einmal pro Seite einbinden, auch wenn die Seite mehrere Links enthält, die mit dem DownloadCounter verknüpft werden sollen. Der Text "Benutzername" muss natürlich durch Ihren Benutzernamen ersetzt werden. Beachten Sie dabei bitte, dass wenn Ihr Benutzername ein Leerzeichen enthält, Sie dieses in der URL durch ein Plus-Zeichen(+) ersetzen müssen!

Kommen wir nun zu den eigentlichen Links. Diese müssen nur leicht ergänzt werden. Beispiel:

wird beispielsweise zu:

Ergänzen Sie also einfach jeden Ihrer Hyperlinks, der mit dem DownloadCounter verbunden werden soll, durch folgenden Code: onclick="javascript:DownloadCounter(this.href)". Dieser Code bewirkt, dass neben der normalen Datei noch das Counterskript aufgerufen wird und den Zähler um eins erhöht.

Wenn Sie nun Ihren Besuchern zeigen wollen, wie oft eine Datei schon heruntergeladen wurde, können Sie sich zweier Methoden bedienen:
Die erste Methode, die Anzeige über bestimmte Text-Befehle, die später vom Skript durch die Zählerstände ersetzt werden, eignet sich vorallem für Benutzer von HTML-Editoren wie z.B. MS Frontpage Express - da kein Eingriff in den HTML-Code notwendig ist - und für umfangreiche Download-Seiten, auf denen 5 oder mehr Zählerstände auf einmal ausgegeben werden sollen. Nicht geeignet ist diese Methode jedoch für die erste Seite Ihrer Homepage (z.B. index.html), nutzen Sie in diesem Fall bitte Methode 2.
Bei der zweiten Methode regelt ein kleiner Javascript-HTML-Tag die Ausgabe jedes einzelnen Zählerstandes. Der Vorteil dieses Verfahrens gegenüber des ersten ist, dass man die Seite ganz normal über die gewöhnliche URL aufrufen kann und nicht dem DownloadCounter-Skript die Seite übergeben muss, damit dieses die Befehle durch die Counts ersetzt und dann ausgibt.

Bei dieser Methode markieren Sie die Stellen im Text der HTML-Datei, an denen später die jeweiligen Zählestände ausgegeben werden sollen, durch Befehle der Art "[Downloads: ...]". Zu beachten ist hierbei, dass diese Befehle nicht von ganz alleine durch die Zählerstände ersetzt werden. Die Seite mit den Befehlen muss über das Counter-Skript aufgerufen werden. Dieses liest die angegebene Seite (unsichtbar für den Besucher) ein und ersetzt diese Markierungen durch die jeweiligen Zählerstände. Danach wird dann die Seite ausgegeben. Auch hier ist nur eine minimale Verzögerung gegenüber dem normalen Aurufen der Seite zu bemerken. Die Vorteile dieses Verfahrens: Die Befehle sind knapp und selbsterklärend gehalten, selbst für absolute Laien, außerdem ist kein Eingriff in den HTML-Code nötig und die Befehle können überall in der HTML-Datei plaziert werden - selbst im Titel der Seite.

Im folgenden sehen Sie den HTML-Code der Datei downloads.htm, eine Beispieldatei, in der der Zählerstand der Datei "http://www.domain.de/datei.zip" ausgegeben werden soll:

<html>
<head>
   <title>Beispielseite</title>
</head>

<body>
   <p align="center"><font size="1">Downloads der Datei <i>http://www.domain.de/datei.zip</i>:
   [Downloads: http://www.domain.de/datei.zip]</font></p>
</body>
</html>

Hier besteht der erste Teil also immer aus "[Downloads: ", dann folgt die URL der Datei und danach die abschließende Klammer "]". Sie können diese Anweisungen überall in den Text schreiben und ihn sogar bei z.B. Buttonbeschriftungen oder gar Grafikadressen verwenden.

Interpretiert vom Browser oder von einem WYSIWYG-Editor wie z.B. MS Frontpage Express würde der obige Code in etwa folgendes Ergebnis zeigen:

Damit nun "[Downloads: http://www.domain.de/datei.zip]" durch den Zählerstand ersetzt wird, darf man die Seite nicht direkt aufrufen, sondern muss wieder das Counter-Skript aufrufen und ihm die Seite übermitteln. Das Counter-Skript sucht alle Vorkommen dieser Platzhalter und ersetzt sie durch den Zählerstand. Danach wird die HTML-Seite ausgegeben. Keine Angst, an der Datei selbst wird also nichts geändert, das wäre dem Skript sowieso nicht möglich.
Beim folgenden Beispiel nehmen wir nun an, von einer anderen Seite aus würde zur Datei downloads.htm durch einen Link verwiesen:

wird zu:

Beachten Sie bitte, das die Seite diesmal mit "page=" angegeben wird, und nicht mit "file=". Einfache Merkregel: Zählen mit file, anzeigen mit page, nicht aber etwa "Dateien zählen mit file, Seiten mit page"! Lassen Sie sich nicht von "page" in die Irre leiten.

Außerdem müssen Sie bei diesem Beispiel natürlich noch "&user=Benutzername" durch Ihren Benutzernamen ersetzen. Beachten Sie dabei bitte, dass wenn Ihr Benutzername ein Leerzeichen enthält, Sie dieses in der URL durch ein Plus-Zeichen(+) ersetzen müssen!

Die zweite Methode ist anfangs wahrscheinlich einfacher zu verstehen, setzt jedoch - wenn auch nur sehr geringe - Kenntnisse in HTML vorraus. Außerdem lohnt sich dieses Verfahren nur bei max. 1-5 anzuzeigenden Zählerständen, da die Ladezeit der Counterstände viel länger wäre als bei der ersten Methode.

Es folgt der HTML-Code der Datei downloads.htm, einer Beispieldatei, in der der Zählerstand der Datei "http://www.domain.de/datei.zip" ausgegeben werden soll:

<html>
<head>
   <title>Beispielseite</title>
</head>

<body>
   <p align="center"><font size="1">Downloads der Datei <i>http://www.domain.de/datei.zip</i>:
   <script language="JavaScript" src="http://www.DownloadCounter.de/view.pl?file=http://www.domain.de/datei.zip&user=Benutzername"></script></font></p>
</body>
</html>

Der Browser zeigt nun den Zählerstand ohne weitere Maßnahmen direkt bzw. kurz verzögert zum Rest der Seite (Ladezeit) an.
Anzupassen sind nur die Angaben "file=http://www.domain.de/datei.zip" (durch die URL der Datei, dessen Counterstand angezeigt werden soll) und "user=Benutzername" (durch Ihren Benutzernamen beim DownloadCounter). Beachten Sie beim Benutzernamen bitte, dass wenn dieser ein Leerzeichen enthält, Sie dieses in der URL durch ein Plus-Zeichen(+) ersetzen müssen!

Anmerkung zu den folgenden Erklärungen: Mit Dateiurl ist bei Methode 1 und 2 jeweils der fett markierte Teil gemeint:
- Methode 1: [Downloads: http://www.domain.de/datei.zip]
- Methode 2: <script language="JavaScript" src="http://www.DownloadCounter.de/view.pl?file=http://www.domain.de/datei.zip&user=Benutzername"></script>

Grafische Counter: In Ihrem Account können Sie festlegen, ob die Zählerstände Ihrer Counter als reiner Text angezeigt werden sollen oder sich aus einzelnen grafischen Ziffern (die Sie sich aus einigen Vorlagen aussuchen können) zusammensetzen soll. Bei beiden Methoden wird dies automatisch berücksichtigt und je nach Einstellung Text oder Grafiken ausgegeben.

Prozentangaben: Wenn Sie einen Zählerstand in Prozent (im Verhältnis zu allen anderen Countern) ausgeben wollen, hängen Sie der URL der Datei (in den Beispielen http://www.domain.de/datei.zip) sowohl bei Methode 1 als auch bei Methode 2 einfach ein %-Zeichen an.

Anzeigen der Summe aller Counter: Soll die Summe aller Zähler Ihres Accounts ausgegeben werden, so geben Sie als URL der Datei einfach die Angabe all an.

Verwendung von Wildcards in URLs: Sie können bei der Ausgabe eines Zählerstandes auch eingeschränkt Wildcards(Platzhalter) benutzen. Notieren Sie vor der Dateiurl-Angabe ein Sternchen, so wird der folgende Text in allen Ihren Countern gesucht. Sagen wir, Sie würden mit z.B. Präfixen arbeiten. Sie hätten 3 Dateien namens "packer_winzip.exe", "packer_winrar.exe" und "packer_winace.exe". Nun wollen Sie Ihren Besuchern zeigen, wie oft insgesamt ein Datei-Packer heruntergeladen wurde, also die Summe dieser drei Dateien. Wenn Sie als Dateiurl folgendes angeben, können Sie dies erreichen: *packer_.

Anzahl aller eingerichteten Counter ausgeben: Um die Anzahl aller in Ihrem Account eingerichteten Counter auszugeben, geben Sie als Dateiurl einfach "number" oder "num" an.

Vergessen Sie nicht, dass der DownloadCounter auch HTML-Seiten zählen kann. Er kann auch sehr gut als normaler Besucherzähler eingesetzt werden und wenn Sie den DownloadCounter richtig einsetzen, ist er ein sehr mächtiges Werkzeug für Webmaster.

Bei Benutzung des DownloadCounters als Besucherzähler bietet es sich an, entweder ein kleines (1x1 Pixel), transparentes GIF-File irgendwo in der Homepage unterzubringen oder eine bestehende Grafik (wie z.B. ein Logo) mit dem DownloadCounter zu verlinken. Geben Sie statt der direkten Bild-Url einfach wieder das DownloadCounter-Skript an, übergeben Sie ihm die URL des Bildes per "file=" und das Skript gibt dann das Bild aus. Bei jedem Besuch Ihrer Homepage werden diese Bilder geladen und der Zähler für das Bild steigt. Dann ist es auch kein Problem mehr, den Zählerstand auszugeben. Bei Einsatz des DownloadCounters als Besucherzähler empfiehlt sich aber die 2. Methode, da die Homepage nicht über das Counter-Skript aufgerufen werden muss. Falls Sie den Besucherzähler durch ein 1x1-Pixel-GIF einbinden wollen, können Sie dazu dieses Bild nutzen: http://www.DownloadCounter.de/counter.gif. Dieses Bild ist 1 Pixel breit sowie einen Pixel hoch und noch dazu transparent, also für den Surfer völlig unsichtbar.

Wenn Sie mit Javascript programmieren können, stehen Ihnen ungeahnte Möglichkeiten zur Verfügung: Mit Hilfe von Methode 1 können Sie Counterstände verschiedenen Variablen im Script-Teil Ihrer Seite zuweisen und so damit völlig frei rechnen usw.

Richten Sie sich eventuell ruhig mehrere Accounts ein, wenn Sie z.B. den Stand eines Counters in verschiedenen Grafiken ausgeben wollen oder besser sortierte, durchschaubare Logfiles wünschen.

Keine Angst, liebe Perl-, ASP- und PHP-Programmierer, in den Dateiurls können auch weitere Trennzeichen (=, &, ?) vorkommen, das Skript erkennt diese nicht als eigene Trennzeichen zwischen den Angaben.

Achten Sie darauf, die eventuellen Leerzeichen in Ihrem Benutzernamen im HTML-Code durch ein +-Zeichen zu ersetzen, denn ältere Browser kommen mit Leerzeichen in URLs oft nicht klar.

Bei weiteren Fragen senden Sie ruhig eine eMail an Hilfe@DownloadCounter.de, Sie werden dort schnellstmöglich eine Antwort auf Ihre Frage bekommen. Auch für Anregungen betrefflich neuen Features wäre ich dankbar.

Letzte Änderung: 07.02.2001