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¶m1¶m2...">
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=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 |
---|---|---|---|
|
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 |
---|---|---|---|
md=5 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 |
---|---|---|---|
pad=Y Mit dem Standard md=10 md=5&pad=N Kein Paddingwert kürzer als max. 5. md=5&pad=N 9 Stellen ohne Padding. |
pad=B | No Padding (kein Padding) |
pad=N Ohne die 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 |
---|---|---|---|
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 |
---|---|---|---|
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 |
---|---|---|---|
incr=F&df=username.dat 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 |
---|---|---|---|
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 |
---|---|---|---|
tr=N 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 |
---|---|---|---|
trgb=0;255;0 (grün) 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 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 °rees 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.