05. Mai 2007

Anleitung zum Einrichten eines Zugriffszählers

Bitte benutzen Sie die unten stehenden Beispiele für die Verwendung des Zugriffszählers.

Normalerweise sollte diese Beschreibung hier vollkommen ausreichen, um sich einen eigenen Zugriffszähler auf den Seiten bei ASAM/ASAMnet einzurichten.

Weiterführende Informationen finden Sie in der Dokumentation zum Counter (in Englisch). Sie können Ihren eigenen Zähler direkt aufrufen, das eigentliche Programm ist bereits auf dem ASAM/ASAMnet-Server installiert.

Wenn Sie nach der Dokumentation zum Counter vorgehen möchten, dann müssen Sie unbedingt beachten, daß der Zähler nicht mit /cgi-bin/Count.cgi... aufgerufen wird. Verwenden Sie stattdessen den Aufruf /cgi-bin/count-cgi/Count.cgi...

Sie sollten weiterhin bedenken, dass die sogenannten Frontpage-Erweiterungen bei ASAM aus Sicherheitsgründen nicht installiert sind, sie mit dieser Internet-Software also keinen Zähler einrichten können. Verwenden Sie nur den Zugriffszähler, der hier auf dieser Seite beschrieben ist.

Wenden Sie sich bei Problemen bitte an Thomas.Belmer(at)asamnet.de oder das CGI-Team.

In den meisten Beispielen fungiert der Zähler als reiner Hit-Counter. Wenn ein Besucher Ihre Seite mehrmals hintereinander in kurzen Abständen besucht, dann wird der Zähler jeweils um eins erhöht. Wenn Sie das nicht möchten, dann müssen Sie unbedingt den Parameter reload=N mit angeben. Beispiel: Der nachfolgende Zugriffszähler ist als reiner Hit-Counter ausgeführt, d.h. wirklich alle Zugriffe werden gezählt (sog. Hit-Counter). Wenn Ihr Besucher z.B. "Neu laden" bzw. "Aktualisieren" in seinem Browser betätigt, dann wird gezählt.

Normal, ohne Rahmen, Design A (Voreinstellung)

<img src="/cgi-bin/count-cgi/Count.cgi?df=sample&ft=0">

Der folgende Zähler ist mit dem Obigen absolut identisch, mit der Ausnahme, dass er als echter Zugriffszähler fungiert. "Neu Laden" oder wiederholte Besuche in kurzen Zeitabständen werden nicht mitgezählt.

Fügen Sie dazu einfach den Kode &reload=N vor dem letzten Anführungszeichen ein.

Wie oben, allerdings als echter Zähler

<img src="/cgi-bin/count-cgi/Count.cgi?df=sample&ft=0&reload=N">

Wie funktioniert's?

Der Zähler wird wie ein normales Bild im Format GIF behandelt. Deshalb ist es nötig, den entsprechenden Aufruf in eine HTML-Seite einzubinden:

Wir wollen natürlich nicht die Datei "bilddatei" anzeigen lassen. Anstelle dieser Datei soll der Zähler aufgerufen werden.

Der Zähler selbst ist eigentlich nichts anderes als ein einfaches Programm, das auf dem ASAM-Server ausgeführt werden muss. Dieses Programm liefert dann das Bildchen mit den Ziffern zurück.

Das Programm - also der eigentlich Zähler - heißt Count.cgi (unter Unix ist es nicht nötig, daß ausführbare Programme die Dateiendung EXE tragen). Unix unterscheidet aber zwischen Groß- und Kleinschreibung.

Das Zählerprogramm Count.cgi befindet sich im Verzeichnis /cgi-bin/count-cgi/, weshalb es auch mit /cgi-bin/count-cgi/Count.cgi aufgerufen werden muß.

<img src="/cgi-bin/count-cgi/Count.cgi?ft=0">

Das Programm weiß weder, welcher Zählerstand anzuzeigen ist, noch weiß es, wie (mit welchem Design). Deshalb wird ohne Angabe einer Datendatei immer eine zufällige Zahl als Bild zurückgegeben. Der angegebene Parameter ft=0 bewirkt nur, dass kein Rahmen um den Zähler gelegt wird.

Setzen wir doch einfach noch eine Datendatei ein und lassen uns den Wert dieser Datei anzeigen. Wir verwenden die Datei beispiel.

<img src="/cgi-bin/count-cgi/Count.cgi?df=beispiel">

df=beispiel bewirkt, dass die Datei beispiel als Datendatei (engl. data file, "df") verwendet wird.

Bitte beachten Sie, dass die restliche Dokumentation die Datei sample (=beispiel) verwendet.

Verwenden Sie nur Datendateien, die mit Ihrer Benutzerkennung beginnen. Mein Benutzername (mit dem ich mich bei ASAM einwähle) ist z.B. "belmert". Deshalb würde ich meine Zähler df=belmert01, df=belmert02 usw... nennen. Sie können natürlich auch Namen wie z.B. df=belmert_index usw... verwenden. Aber bitte mit Ihrer eigenen Kennung. :-)

Wichtig ist uns nur, daß Ihre Benutzerkennung im Dateinamen auftaucht, damit wir die Zähler zuordnen können. Selbstverständlich dürfen auch keine deutschen Umlaute verwendet werden.

Legen wir jetzt noch das Design fest, z.B. dd=blueodo (dd = digit directory) und entfernen den Rahmen mit ft=0 (ft = frame thickness).

<img src="/cgi-bin/count-cgi/Count.cgi?df=beispiel&dd=blueodo&ft=0">

Wie bereits eingangs erwähnt, haben wir unseren Zähler als reinen Hit-Counter eingerichtet. Um aus ihm einen richtigen Zugriffszähler zu machen, ist es nötig, ein reload=N einzufügen.

<img src="/cgi-bin/count-cgi/Count.cgi?df=beispiel&dd=blueodo&ft=0&reload=N">

Das Zählerprogramm Count.cgi befindet sich im Verzeichnis /cgi-bin/count-cgi/, weshalb es auch mit /cgi-bin/count-cgi/Count.cgi aufgerufen werden muß.

<code><img src="/cgi-bin/count-cgi/Count.cgi?ft=0"></code>

Das Programm weiß weder, welcher Zählerstand anzuzeigen ist, noch weiß es, wie (mit welchem Design). Deshalb wird ohne Angabe einer Datendatei immer eine zufällige Zahl als Bild zurückgegeben. Der angegebene Parameter <code>ft=0</code> bewirkt nur, dass kein Rahmen um den Zähler gelegt wird.

Setzen wir doch einfach noch eine Datendatei ein und lassen uns den Wert dieser Datei anzeigen. Wir verwenden die Datei <code>beispiel</code>.

<code><img src="/cgi-bin/count-cgi/Count.cgi?df=beispiel"></code>

df=beispiel bewirkt, dass die Datei beispiel als Datendatei (engl. data file, "df") verwendet wird.

Bitte beachten Sie, dass die restliche Dokumentation die Datei sample (=beispiel) verwendet.

Wichtig ist uns nur, daß Ihre Benutzerkennung im Dateinamen auftaucht, damit wir die Zähler zuordnen können. Selbstverständlich dürfen auch keine deutschen Umlaute verwendet werden.

Legen wir jetzt noch das Design fest, z.B. dd=blueodo (dd = digit directory) und entfernen den Rahmen mit ft=0 (ft = frame thickness).

<code><img src="/cgi-bin/count-cgi/Count.cgi?df=beispiel&dd=blueodo&ft=0"></code>

Wie bereits eingangs erwähnt, haben wir unseren Zähler als reinen Hit-Counter eingerichtet. Um aus ihm einen richtigen Zugriffszähler zu machen, ist es nötig, ein <code>reload=N</code> einzufügen.

<code><img src="/cgi-bin/count-cgi/Count.cgi?df=beispiel&dd=blueodo&ft=0&reload=N"></code>

Design "asam"

<code><img src="/cgi-bin/count-cgi/Count.cgi?df=beispiel&dd=asam&ft=0"></code>

Normal, ohne Rahmen, Design B

<img src="/cgi-bin/count-cgi/Count.cgi?df=sample&dd=B&ft=0">

Normal, ohne Rahmen, Design blueodo

<img src="/cgi-bin/count-cgi/Count.cgi?df=sample&dd=blueodo&ft=0">

Normal, ohne Rahmen, Design C

<img src="/cgi-bin/count-cgi/Count.cgi?df=sample&dd=C&ft=0">

Normal, ohne Rahmen, Design D

<img src="/cgi-bin/count-cgi/Count.cgi?df=sample&dd=D&ft=0">

Normal, ohne Rahmen, Design E

<img src="/cgi-bin/count-cgi/Count.cgi?df=sample&dd=E&ft=0">

Normal, ohne Rahmen, Design F

<img src="/cgi-bin/count-cgi/Count.cgi?df=sample&dd=F&ft=0">

Rahmen mit Standardfarbe und Breite

<img src="/cgi-bin/count-cgi/Count.cgi?df=sample">

So wird ein versteckter Zähler eingebaut

Nachfolgendes Beispiel verwendet einen versteckten Zähler, d.h. kein Bild wird angezeigt. Den Zählerstand kann man unter http://www.asamnet.de/~count/Counter/data/sample abrufen.
Setzen Sie einfach statt dem Namen "sample" Ihren eigenen Zählernamen ein.

<img src="/cgi-bin/count-cgi/Count.cgi?df=sample&sh=F">

Countdown

<img src="/cgi-bin/count-cgi/Count.cgi?display=countdown&ft=0&dd=cd&negate=T">

Countdown zum Jahr 2000 in New York

<img src="/cgi-bin/count-cgi/Count.cgi?display=countdown&dd=cdr&timezone=GMT-0500&sfd=T">

Countdown zu einem speziellen Datum

<img src="/cgi-bin/count-cgi/Count.cgi?cdt=1999;1;3;24;0;0&sfd=T&dd=cd&ft=0&prgb=000000">

Countdown von GMT-0500 zum Jahr 2000

<img src="/cgi-bin/count-cgi/Count.cgi?display=countdown&dd=cd&timezone=GMT-0500&sfd=T&prgb=0000ff">

Countdown zum vergangenen 1. Februar 1998

<img src="/cgi-bin/count-cgi/Count.cgi?ft=3&df=sample&dd=D">

digit style E,frame-thickness=0,white transparent

<img src="/cgi-bin/count-cgi/Count.cgi?trgb=ffffff&ft=0&df=sample&dd=E">

Red frame with default thickness

<img src="/cgi-bin/count-cgi/Count.cgi?df=sample&frgb=ff0000">

Literal string with comma

<img src="/cgi-bin/count-cgi/Count.cgi?lit=94032048040320&comma=T&dd=D&ft=2">

Literal string, make black transparent

<img src="/cgi-bin/count-cgi/Count.cgi?lit=0123456789,:-ap&tr=T&dd=D&ft=2">

Frame color can be Red,Green and Blue triplets

<img src="/cgi-bin/count-cgi/Count.cgi?lit=0123456&frgb=0;0;255">

Frame color can be hex as well,using blue here

<img src="/cgi-bin/count-cgi/Count.cgi?lit=0123456&frgb=0000ff">

Change green digit-color to default pen color

<img src="/cgi-bin/count-cgi/Count.cgi?lit=1234567&chcolor=T">

Change green digit-color to red

<img src="/cgi-bin/count-cgi/Count.cgi?lit=1234567&srgb=00ff00&prgb=ff0000">

Change green digit-color to yellow

<img src="/cgi-bin/count-cgi/Count.cgi?lit=1234567&srgb=00ff00&prgb=ffff00">

Change green digit-color to FF7700

<img src="/cgi-bin/count-cgi/Count.cgi?lit=1234567&srgb=00ff00&prgb=ff7700">

Gray frame color

<img src="/cgi-bin/count-cgi/Count.cgi?lit=1234567&frgb=c0c0cc0">

NavyBlue frame color

<img src="/cgi-bin/count-cgi/Count.cgi?lit=1234567&frgb=000080">

Show time (12 hr format)

<img src="/cgi-bin/count-cgi/Count.cgi?display=clock">

Show time (24 hr format)

<img src="/cgi-bin/count-cgi/Count.cgi?display=clock&tformat=24">

Show time of Dhaka (GMT+0600),Bangladesh

<img src="/cgi-bin/count-cgi/Count.cgi?display=clock&timezone=GMT+0600">

Show date (MM-DD-YY)

<img src="/cgi-bin/count-cgi/Count.cgi?display=date">

Show date (DD-MM-YY)

<img src="/cgi-bin/count-cgi/Count.cgi?display=date&dformat=ddmmyy">

Show date (DD-MM-YYYY) use YYYY to show full year

<img src="/cgi-bin/count-cgi/Count.cgi?display=date&fy=T&dd=cd&dformat=ddmmyyyy">

Show date (DD-MM-YY) use fy show full year

<img src="/cgi-bin/count-cgi/Count.cgi?ft=0&df=sample&trgb=00ff00">

Make the green color transparent,no frame

<img src="/cgi-bin/count-cgi/Count.cgi?ft=0&df=sample&trgb=00ff00">

Make the black color transparent,frame-thickness=2

<img src="/cgi-bin/count-cgi/Count.cgi?ft=2&df=sample&trgb=000000">

Make the black color transparent,change green color to a shade of gray,frame-thickness=2

<img src="/cgi-bin/count-cgi/Count.cgi?srgb=00ff00&prgb=101010&ft=2&df=sample&trgb=000000">

Make the black color transparent,change green color to a shade of gray,frame-thickness=0

<img src="/cgi-bin/count-cgi/Count.cgi?srgb=00ff00&prgb=101010&ft=0&df=sample&trgb=000000">

Display Lenna's image wrapped with a nice frame

<img src="/cgi-bin/count-cgi/Count.cgi?display=image&dd=D&image=lenna.gif&frgb=8B6508&ft=20">

Composite the counter at location 3,95 of the image

<img src="/cgi-bin/count-cgi/Count.cgi?display=image&ft=0&image=peng.gif&df=sample&incr=T&xy=3;95&comma=T">

Composite the counter at the center of the image

<img src="/cgi-bin/count-cgi/Count.cgi?display=image&ft=0&image=lenna.gif&dd=D&lit=1234&incr=T&align=center">

Composite the counter left justified

<img src="/cgi-bin/count-cgi/Count.cgi?display=image&ft=0&image=lenna.gif&dd=D&lit=1234&align=left">

Composite the counter right

<img src="/cgi-bin/count-cgi/Count.cgi?display=image&image=lenna.gif&incr=F&ft=0&lit=1234&align=right&dd=D">

Rotate 270 degrees. Note, degrees are implied here

<img src="/cgi-bin/count-cgi/Count.cgi?ft=0&df=sample&rotate=T&dd=D">

Auf den Kopf stellen

(Drehung um 180 Grad); wird vom Internet Explorer der Fa. Microsoft nicht richtig aufgerufen.

<img src="/cgi-bin/count-cgi/Count.cgi?ft=0&df=sample&dd=D&degrees=180">

Drehung um 90 Grad

<img src="/cgi-bin/count-cgi/Count.cgi?ft=0&df=sample&degrees=90&dd=D&prgb=ffff00">

Muhammad A Muquit
Generated on: Wed Jan 6 20:50:31 CET 1999 by <code>testcount-sh (1.2)</code>
(Linux asrv 2.0.33 #63 Wed Apr 22 10:13:49 MEST 1998 i686 unknown)
Übersetzt und für ASAMnet angepaßt: Thomas Belmer
Letzte Änderung: 16.7.1999