Online-Anzeige eines INKA-Users

Wenn ein INKA-User diese Funktion freigeschaltet hat (geht über den Login-Button oben), dann kann man über ein CGI-Skript abfragen, ob dieser User online ist (d.h. ob er gerade mit dem Internet verbunden ist) oder nicht. Wenn er online ist, dann kann man auch herausfinden, welche IP-Nummer bzw. welchen Hostnamen er gerade verwendet.

Wenn Sie ein INKA-User sind, dann können Sie auf Ihrer Webseite eine Grafik einbauen, die immer automatisch anzeigt, ob sie Online oder Offline sind, bzw. welche IP-Nummer oder welchen Hostname Sie haben.

Aufruf des CGI-Skriptes

Das CGI-Skript wird unter der folgenden URL aufgerufen:

http://www.inka.de/cgi-bin/showlogin.cgi?bnum=BNUM&mode=MODE&show=SHOW

Dabei müssen Sie natürlich, die unten angegebenen Parameter entsprechend setzen. Wenn Sie eine eigene Webseite haben, in die Sie gerne eine Grafik mit dieser Information einsetzen wollen, dann setzen Sie an der passenden Stelle folgenden Text ein:

<IMG SRC="http://www.inka.de/cgi-bin/showlogin.cgi?bnum=BNUM&mode=gfx&show=SHOW">

Dabei setzen Sie für BNUM ihre eigene 4-stellige Benutzernummer ein und für SHOW eine der Werte "status", "ip" oder "name".

Parameter für das CGI-Skript

Parameter	Wert	Beschreibung
bnum	xxxx	Dies ist die die 4-stellige Benutzernummer des Users, dessen Informationen Sie abfragen wollen.
mode	text	Anzeige des Ergebnisses als normaler Text. (Content-Type: text/plain.) Dieser Modus eignet sich besonders zur automatischen Auswertung in einem Skript.
	gfx	Anzeige des Ergebnisses als Grafik. (Content-Type: image/gif.) Dieser Modus eignet sich besonders, um die Grafik in eine eigene Webseite einzubauen.
show	status	Es wird nur der Status ("Online" oder "Offline") angezeigt.
	ip	Es wird entweder "Offline" angezeigt oder die zur Zeit benutzte IP-Nummer des Users.
	name	Es wird entweder "Offline" angezeigt oder der zur Zeit benutze Rechnername des Users.

Hat der User die Anzeige nicht freigegeben oder ist der User nicht bekannt, so wird immer "Unbekannt" ausgegeben. Wenn ein Fehler aufgetreten ist, dann wird "Fehler" ausgegeben. In Fehlerfall würden wir uns an eine Nachricht an info@inka.de freuen.

Beispiele

	User ist online
	User ist offline
	User ist online. IP-Nummer dieses Users.
	User ist online. Rechnername dieses Users.
	Dieser User exisitiert nicht oder er hat die Ausgabe der Information nicht freigeschaltet
	Ein Fehler ist aufgetreten. Das kann bedeuten, daß Sie falsche Parameter angegeben haben.

Die Breite der Grafiken ist immer so, daß die Anzeige mit maximaler Länge für diesen Modus in die Grafik paßt.

Das Programm showlogin

Auf dem User-Rechner steht das Perl-Skript showlogin zur Verfügung. Mit seiner Hilfe kann diese Abfrage einfach automatisiert werden. Es kann natürlich auch auf einem anderen Rechner installiert werden. Dazu wird natürlich Perl und außerdem die libwww benötigt, die Sie auf einem CPAN- Archiv finden.

Aufgerufen wird das Programm einfach wie folgt:

showlogin [-i|-n] Benutzernummer

Dabei muß man immer die Benutzernummer angeben. Wenn man die Ausgabe einer IP-Nummer wünscht, dann gibt man die Option -i and, wenn man den Rechnernamen will, dann -n, sonst wird einfach nur "Online" ausgegeben. Der Exit-Code kann auch abgefragt werden. Weitere Details finden Sie am Anfang des Perl-Skriptes selber.

Zuletzt geändert
am 19.04.1999