Zum Inhalt der Seite


FEN: Free-Net Erlangen-Nürnberg-Fürth e.V.

FEN: Free-Net Erlangen-Nürnberg-Fürth e.V.

FEN Startseite > Services > Counter > Parameter

Parameter Übersicht

Jeder Counter kann mit einer Vielzahl von Parametern sehr individuell eingestellt werden. Auch die Anzeige von Countdowns und Uhrzeiten ist möglich. Weiterhin können Farben angegeben und verändert werden und das Counterbild kann rotiert werden.

Die allgemeine Syntax für die Parameter lautet:

<img src="http://counter.fen-net.de/cgi-bin/Count.cgi?
df=ihrusername&param1&param2...">

D.h., die Parameter werden an die URL des Counters angehängt und mit dem Zeichen & voneinander getrennt.

Hier nun eine Übersicht der wichtigsten Parameter mit Beispiel:

Counter Parameter

cache und expires Caching-Verhalten des Browsers einstellen.
chcolor Eine Farbe des Counterbildes verändern.
cdt Countdown-Zieldatum.
cdf Countdown-Ab-Datum.
comma Komma nach jeder dritten Ziffer (von rechts) anzeigen.
dd Schriftart.
degrees oder angle Rotationswinkel des Counterbildes.
df Counter Daten-Datei (data file).
dformat Datumsformat.
display Counter, Uhrzeit oder Countdown anzeigen.
frgb Rahmenfarbe.
ft Rahmenbreite
fy Jahreszahl vierstellig.
incr Counter hochzählen ja/nein.
lit Zeige feste Zahl an.
md Maximale Anzahl Ziffern.
negate Counterbild bezüglich der Farbwerte negieren.
pad Linksseitiges Auffüllen mit Nullen ein/aus.
reload Page-Reload (Seite neuladen) mitzählen ja/nein.
rotate Counterbild rotieren.
sdhms Tag, Stunde, Minute, Sekunde im Countdown anzeigen ja/nein.
sfd Countdown-Ab-Datum unterhalb des Countdowns anzeigen ja/nein.
sh Counter anzeigen oder unsichtbar machen.
srgb, prgb Einen Farbwert in einen anderen ändern.
st Startwert des Counters.
tformat Zeit im 12- oder 24-Stunden-Format.
timezone Datum/Uhrzeit einer anderen Zeitzone verwenden.
tr Transparenz ein/aus.
trgb Transparente Farbe.

Bei einigen Parametern können Sie Farbwerte im sogenannten RGB-Format angeben. Informationen dazu, sowie Tabellen mit Farbnamen und -werten finden Sie auf den Seiten von Selfhtml von Stefan Münz unter dem Stichwort "Farben". Selfhtml kann man übrigens kostenlos herunterladen und als HTML-Referenz auf dem eigenen Rechner installieren.

Tip: Wenn Sie beim Counteraufruf anstatt eines Farbwertes einen Standardfarbnamen auf Englisch angeben, dann zeigt Ihnen der Counter den zughörigen numerischen Wert an.

Beispiel Parameter Name Voreinstellung

 

ft=7

ft=X Frame Thickness
(Randbreite)
ft=0
Ohne Rand

Beschreibung:
Sie können den Counter von einem Rand mit der Breite X in Pixeln umgeben lassen. Benutzen Sie 0 für die Darstellung ohne Rand. Werte über 5 liefern einen netten 3-D Effekt.

Beispiel Parameter Name Voreinstellung

 
Zähler
frgb=69;139;50

Zähler
frgb=255;0;0

Zähler
Standard

frgb=R;G;B Frame Color
(Randfarbe)
frgb=100;139;216
Türkis

Beschreibung:
Bestimmt die Farbe des Randes in RGB (rot/grün/blau) Format. Jede Farbkomponente, R, G, B, rangiert von Farbe 0 bis 255. Wenn Sie ft=# ohne den frgb= Parameter benutzen, wird die Standardfarbe verwendet.

Wenn Sie frgb= ohne den Parameter ft=# benutzen, ist die Randbreite = 5. Alle Beispiele zeigen ft=5.

Beispiel Parameter Name Voreinstellung
Zähler
md=5
Zähler
md=5
Beispiel mit 9 Stellen
md=X Max Digits
(Maximale Stellen)
md=10
Ohne Padding

Beschreibung:
Legt die Anzahl der anzuzeigenden Stellen fest. Irgendein Wert zwischen 5 und 10 ist erlaubt. Nullen werden automatisch hinzugefügt; grössere Zählungen werden an den gegeben Wert X angepasst.

Beispiel Parameter Name Voreinstellung
Zähler
pad=Y
Mit dem Standard md=10
Zähler
md=5&pad=N
Kein Paddingwert kürzer als max. 5.
Zähler
md=5&pad=N
9 Stellen ohne Padding.
pad=B No Padding
(kein Padding)
pad=N
Ohne die md= Spezifizierung


pad=Y
Mit md= Spezifizierung

Beschreibung:
Ein/Ausschalten von Padding in Verbindung mit der md= Option.

Gültige Werte für den Boolean Parameter B sind Y, N, T, F, 1, oder 0.

(Wie in den Beispielen gezeigt, gibt es einige Bugs beim Padding-Feature. Diese werden baldmöglichst behoben.)

Beispiel Parameter Name Voreinstellung
(Kein Beispiel darstellbar.) st=X Start count
(Start Zählung)
st=1
Counter startet bei 1

Beschreibung:
Wenn Sie einen Counter zum ersten Mal benutzen, so können Sie mit diesem Parameter den Startwert des Counters angeben.

Beispiel Parameter Name Voreinstellung
Zähler
Hier drüber ist ein unsichtbarer Counter!
sh=B Show digits
(Zeige Zahlen)
sh=Y
Zeige Counter.

Beschreibung:
Wird benutzt um die Darstellung der Zahlen ein/auszuschalten. Benutzen Sie dazu den Boolean B. Wenn sh=T ist, werden die Zahlen wie in den anderen Beispielen angezeigt. Falls aber sh=F ist, werden keine Zahlen angezeigt, aber der Counter wird stets weiterzählen; statt den Zahlen wird ein transparentes 1x1 Pixel GIF Bild angezeigt.

Gültige Werte für den Boolean Parameter B sind Y, N, T, F, 1, oder 0.

Beispiel Parameter Name Voreinstellung
Zähler
Eine zufällige Zahl.
df=file Data File for counting
(Counter-Datenfile)
df=RANDOM
Schmeiss die Würfel! ;)

Beschreibung:
Bestimmt den Namen der Datei, in der die Zählungen abgelegt werden sollen. Dieser Dateiname muss mit ihrem FEN-Usernamen beginnen.

Ein anderes Feature ist die ZUFALLS Funktion (df=Random).

Beispiel Parameter Name Voreinstellung
Zähler
incr=F&df=username.dat
Zähler
incr=F&df=username.dat
Dieser Counter wird nicht hochzählen, ausser wenn ein anderer User zur gleichen Zeit auf ihn zugreift.
incr=B Increment count
(Addiere zu Counter)
incr=T

Beschreibung:
Macht es möglich, den aktuellen Wert eines Counterfiles auszugeben ohne eine Zählung hinzuzufügegen.

Gültige Werte für den Boolean Parameter B sind Y, N, T, F, 1, oder 0.

Beispiel Parameter Name Voreinstellung
Zähler
lit=123
Fast alle Beispiele auf dieser Seite wurden mit lit=X gemacht
lit=X Display literal
(Zeige Placebo)
Keine

Beschreibung:
Macht es möglich, einen vorgegebenen Wert anzeigen zu lassen.

Gültige Werte für den String X in Zahlen.

Beispiel Parameter Name Voreinstellung
Zähler
tr=N

Zähler
tr=Y
tr=B Transparency On/Off
(Transparenz Ein/Aus)
tr=N
Keine Transparenz

Beschreibung:
Sie können, falls ihr Counter-Bild eine transparente Farbe hat, diese mit dem Boolean B bestimmen. Also bedeutet tr=Y dass die transparente Farbe dargestellt werden wird und tr=N bedeutet das Gegenteil. Es macht nichts, wenn die GIF Dateien für den Counter transparent sind; wie schon gesagt, Sie müssen genau die Farbe bestimmen, die im GIF-File als transparent eingetragen ist.

Wenn Sie trgb=, bestimmt haben, brauchen Sie nicht tr=Y zu bestimmen.

Gültige Werte für B sind Y, N, T, F, 1, oder 0.

Beispiel Parameter Name Voreinstellung
Zähler
trgb=0;255;0

(grün)
Zähler
trgb=0;0;0
(schwarz)
trgb=R;G;B Transparent Color
(Transparente Farbe)
frgb=0;0;0
Schwarz

Beschreibung:
Hier legen Sie die Farbe, die als transparent gelten soll, im rot/grün/blau Format fest.

Wenn Sie ein trgb= bestimmt haben, können Sie den Parameter tr=Y überspringen; er wird automatisch für Sie eingeschaltet.

Hier noch eine Beschreibung weiterer Einstellungsmöglichkeiten (ohne Beispiel).

Parameter Name Voreinstellung
reload=B Zählt Page-Reloads (Seite neuladen) mit. Default ist 1. reload=T
Page-Reloads (Seite neuladen) werden mitgezählt.

Beschreibung:
Gültige Werte für reload sind Y, N, T, F, 1 oder 0.

Parameter Name Voreinstellung
cdt=
jahr;mnt,tag;std;min;sek
Countdown zum angegebenen Datum anzeigen. Kein Default

Beschreibung:
Der Parameter cdt spezifiziert das Countdown Zieldatum. Zulässiger Wert für diesen Parameter sind 6 Zahlen, durch Semikolon getrennt. Die erste Zahl spezifiziert das Jahr, z.B. 2000. Monate und Tage werden ab "1" gezählt. Ds Jahr kann nicht kleiner als 1970 sein. Stunden werden zwischen 0 und 23 angegeben, Minuten und Sekunden zwischen 0 und 59. Countdown zum 1.1.2001 ist z.B. cdt=2001;1;1;0;0;0. Wenn Sie keine Zeitzone mit dem Parameter timezone angeben, so wird ab der Zeitzone unseres Webservers gerechnet. Wenn Sie z.B. ab GMT rechnen wollen dann spezifiezieren Sie die Zeitzone folgendermaßen timezone=GMT+0000. Dieser Parameter funktioniert nur mit Schriftarten, die die Symbole ",-DHSM" enthalten.

Parameter Name Voreinstellung
cdf=
jahr;mnt;tag;std;min;sek
Berechne Countdown ab diesem Datum. Die lokale Zeit des Webservers.

Beschreibung:
Dieser Parameter spezifiziert ab welchem Datum der Countdown gezählt werden soll. Defaultmäßig wird ab dem aktuellen lokalen Datum oder dem aktuellen Datum der mit dem Parameter timezone angegebenen Zeitzone gezählt. Die gültigen Werte für diesen Parameter sind 6 Zahlen durch Semikolon getrennt. Die erste Zahl gibt da Jahr an. Z.B. 1999. Monate und Tage werden ab 1 gezählt, das Jahr kann nicht kleiner als 1970 sein. Stunden werden im Bereich von 0 bis 23 angegeben. Minuten und Sekunden zwischen 0 und 59.

Parameter Name Voreinstellung
sdhms=B Schalter, ob Stunde, Minute und Sekunde im Countdown angezeigt werden. sdhms=T

Beschreibung:
Mit diesem Parameter kann man einstellen, wie der Countdown angezeigt wird. Die gültigen Werte für diesn Boolschen Parameter sind Y, N, T, F, 1 oder 0. Voreingestellt ist T, was bedeutet, daß der Countdown als Tag, Stunde, Minute und Sekunde angezeigt wird. Wenn Sie nur die Tage anzeigen wollen, geben Sie F, als Wert an.

Parameter Name Voreinstellung
sfd=B Zeigt das Countdown-Ab-Datum unter dem Countdown an. sfd=F

Beschreibung:
Der Parameter sfd zeigt das Countdow-Ab-Datum unter dem Countdown an. Das Ab-Datum ist der Zeitpunkt der Ausführung des Counterprogramms oder der mit dem Parameter cdf angegebene Zeitpunkt. Die Zeit im Datum ist immer im 24 Stunden Format. Wenn Sie den Parameter timezone verwenden, dann wird die Zeitzone hinter dem Datum angezeigt. Die gültigen Werte für den Parameter sind Y, N, T, F, 1 oder 0.

Parameter Name Voreinstellung
display=X Spezifiziert, was anzuzeigen ist. display=counter

Beschreibung:
Gültige Werte für X sind: counter, clock, date, countdown oder version. Wenn countdown spezifiziert wird, ohne mit dem Parameter cdt eine Countdown-Zielzeit anzugeben, so wird als Zielzeit das lokale Serverzeit genommen. Damit können Sie zusammen mit dem Parameter cdf die vergangene Zeit ab einem bestimmten Zeitpunkt anzeigen lassen. Der Parameter date funktioniert nur mit Schriftarten, die die Symbole ",-" enthalten.

Parameter Name Voreinstellung
timezone=X Datum/Uhrzeit einer anderen Zeitzone verwenden. None.

Beschreibung:
Der Parameter timezone= ist nur mit folgenden anderen Parametern sinnvoll: display=clock, display=date oder display=countdown Verwenden Sie diesen Parameter um Datum und Uhrzeit einer anderen Zeitzone anzuzeigen oder um einen Countdown relativ zum Datum einer anderen Zeitzone zu berechnen. Die Zeitzone muß mit einem negativen oder positiven Offset als vierstellige Zahl angegeben werden. Z.B. timezone=GMT-0500 oder timezone=GMT+0000 oder timezone=GMT+0530.
Bemerkung: Sommerzeit wird nicht berücksichtigt. D.h. während der Sommerzeit muß, um die Zeit von New York anzugeben, timetone=GMT-0500 anstatt timezone=GMT-0400 spezifiziert werden.

Parameter Name Voreinstellung
tformat=X Zeit im 12 oder 24 Stunden Format. tformat=12

Beschreibung:
Dieser Parameter kann verwendet werden, um die Zeit im 12- oder 24-Stunden-Format anzuzeigen. Gültige Werte für X sind 12 oder 24.

Parameter Name Voreinstellung
dformat=X Spezifiziert das Datumsformat. dformat=MMDDYY

Beschreibung:
Dieser Parameter ist nur zusammen mit display=date sinnvoll. Gültige Werte für X sind alle Kombinationen von MMDDYY (Monat-Tag-Jahr). Z.B. dformat=ddmmyy oder dformat=YYMMDD. Um das Jahr vierstellig anzeigen zu lassen geben Sie einfach YYYY anstelle von YY an, z.B. dformat=MMDDYYYY. Um das Jahr vierstellig anzuzeigen können Sie auch den Parameter fy verwenden.

Parameter Name Voreinstellung
fy=B Jahreszahl vierstellig anzeigen. fy=F

Beschreibung:
Dieser boolsche Parameter gibt an, ob das Jahr vierstellig oder zweistellig angezeigt werden soll. Gültige Werte sind Y,N,T,F,1 oder 0.
Bemerkung: Ab dem Jahr 2000 ist die Voreinstellung T, vorher F. Siehe auch dformat.

Parameter Name Voreinstellung
dd=A Schriftart dd=A
Grüne LED-Ziffern

Beschreibung:
Acht Standardschriftarten werden unterstützt ( A,B,C,D,E,cd,cdd und cdr). Weiterhin werden die meisten der Schriftarten auf Digitmania unterstützt. Geben Sie dazu einfach den Dateinamen der Schriftart (ohne Dateiendung) an.

Parameter Name Voreinstellung
comma=B Ein Komma nach jeder dritten Ziffer anzeigen. comma=F

Beschreibung:
Der boolsche Parameter comma gibt an, ob ein Komma nach jeder dritten Ziffer angezeigt werden soll. Wenn Sie diesen Paramater auf wahr (T) setzen, wird das linksseitige Auffüllen mit Nullen ausgeschaltet.

Parameter Name Voreinstellung
srgb=R;G;B
oder
srgb=RRGGBB (in hex)

prgb=R;G;B
oder
prgb=RRGGBB (in hex)
Eine Farbe eines Bildes in eine andere Farbe umwandeln. srgb=00ff00
(0;255;0 Grün)

prgb=00ffff
(0;255;255 Cyan)

Mit chcolor=T

Beschreibung:
Jede Farbe eines Bildes kann vor der Anzeige in eine beliebige andere Farbe umgewandelt werden. srgb spezifiziert die umzuwandelnde Farbe, prgb die Farbe in die umgewandelt werden soll. Die Werte für srgb und prgb können hexadezimal (z.B. srgb=ff0000) oder als Farbkomponentenwerte (z.B. srgb=255;0;0) angegeben werden.

Parameter Name Voreinstellung
chcolor=B Eine Farbe eines Bildes verändern. chcolor=F

Beschreibung:
Dieser Parameter wird für gewöhnlich dazu verwendet, um die Voreingestellte grüne Farbe in cyan umzuwandeln. Dies bedeutet, wenn Sie nur cgcolor=T angeben, brauchen Sie srgb und prgb nicht zu verwenden. Gültige Werte für chcolor sind Y, N, T, F, 1, oder 0.

Parameter Name Voreinstellung
negate=B Farbwert negieren negate=F
Nicht negieren

Beschreibung:
Negiert den Farbwert der Counterziffern. Der Rahmen ist von der Negation nicht betroffen. Gültige Werte für B sind Y, N, T, F, 1, oder 0.

Parameter Name Voreinstellung
degrees=X
oder
angle=X
Um X Grad rotieren degrees=270
Mit rotate=Y und ohne degrees=X
Rotiere 270 Grad im Uhrzeigersinn

Beschreibung:
Ermöglicht die Drehung des Counterbildes um X Grad. Gültige Werte für X sind 90, 180, 270 und 360.
Bemerkung: Microsoft MS Explorer interpretiert &degrees als das Grad-Zeichen (Fehler im MS IE); benutzen Sie deshalb besser den Parameter angle.

Parameter Name Voreinstellung
rotate=B Rotate On/Off rotate=F
Nicht rotieren

Beschreibung:
Schaltet das Rotieren ein oder aus. Wenn Sie degrees= benutzen, so wird dieser Parameter nicht benötigt. Gültige Werte für B sind Y, N, T, F, 1, oder 0.

Parameter Name Voreinstellung
cache=B
expires=X
Diese Parameter werden benutzt, um das "Image-Caching" (Zwischenspeichern der Bilder im Browser) zu steuern. Für display=clock:
cache=F
expires=0

Sonst:
cache=F
expires=180

Beschreibung:
Mit dem Wert des Parameters cache teilt man dem Browser mit, ob er das Counterbild zwischenspeichern soll oder nicht. Mit dem Wert des Parameters expires spezifiert man die Zeitdauer in Sekunden, die der Browser das Counterbild maximal zwischenspeichert. Geben Sie cache=F an, so wird der Browser das Counterbild die Anzahl von Sekunden zwischenspeichern, die Sie mit dem expires Parameter angegeben haben. Geben sie cache=F und expires=0 an, dann wird das Counterbild nicht zwischengespeichert und bei jedem Seitenaufruf von Server geladen. Achtung! Die Verwendung von cache=F und expires=0 ist im FEN ausschließlich zu Testzwecken erlaubt.
Normalerweise sollten Sie das Caching des Browsers mit cache=F nicht ausschalten, falls doch, so geben Sie bitte für expires einen Wert von mindestens 120 an. Die meisten Counter, die im Internet angeboten werden, sind so eingestellt, daß automatisch Zugriffe von der gleichen IP innerhalb von 300 Sekunden nicht gezählt werden, der FEN-Counter ist in dieser Beziehung also recht flexibel.
Kleinere Werte als 120 würden allerdings die Last auf unserem Counterserver zu stark ansteigen lassen (das Counterbild muß dann öfter erzeugt werden). Die gültigen Werte f¨r den boolschen Parameter cache sind Y,N,F,T 1 oder 0. Der gültige Wertebereich für den Parameter expires is 0 bis 604800 (7 Tage).

Dieser Parameter funktionieren mit Browsern, die den HTTP-Expires-Header unterstützen.


FEN-Counter