####################################################################################
####                     ICQWatch Version 0.20  
####                     Wer ist im ICQ online?
####                                
####          Das New-Tuxwetter-Team: SnowHead und Worschter
####################################################################################

Vorraussetzung:
---------------

Die Vorraussetzung fr die korrekte Funktion des Plugins, ist eine funktionierende 
Internetverbindung. Diese kann entweder ber einen Router oder ber einen PC mit ICS 
(Internet Connection Sharing = Internetverbindungsfreigabe) erfolgen. 
Laufen schon andere Plugins mit Internetanbindung (z.B. Tuxmail, Newsticker etc.),
sollte das Plugin normalerweise ebenfalls funktionieren.
Nutzer eine Proxservers knnen diesen dem Plugin mit folgenden Eintrgen in der Datei
icqwatch.conf bekanntmachen

 ProxyAdressPort=ProxyAdresse:ProxyPort
 ProxyUserPwd=Username:Passwort

 Beispiel:
 ProxyAdressPort=192.168.0.128:8080
 ProxyUserPwd=username1:passwort1


Installation fr jffs-only-Images:
----------------------------------

Die Verzeichnis-Struktur gibt den Ort der Dateien im Image eigentlich schon vor,
also icqwatch.cfg und icqwatch.so (Rechte auf 755) nach /lib/tuxbox/plugins/.
Den Ordner "icqwatch" (einschlielich des Ordners selbst) nach /var/plugins/ kopieren.
icqwatch braucht die Rechte 755.
Bei Images mit cramfs ist der Ordner /lib/tuxbox/plugins/ nicht per FTP beschreibbar.
In diesem Fall mu die root-Partition (cramfs) ber die Expertenfunktion der Box aus-
gelesen, auf dem PC mit den NewTuxBoxFlashTools die beiden Dateien eingefgt werden
(Rechte 755 fr icqwatch.so nicht vergessen) und dann wieder mittels der Experten-
funktion geflasht werden.

Alternativ kann bei einigen cramfs- und squashfs-Images auch versucht werden, die .so 
und .cfg Datei in den Ordner /var/tuxbox/plugins zu kopieren. Manche Images suchen auch 
dort nach Plugins.

Installation fr Jack-the-Grabber-Teamimages oder Yadi-Images:
--------------------------------------------------------------

Im Verzeichnis /var/ den Ordner /plugins/ erstellen. Dann nach /var/plugins/ wechseln,
und dorthin den Ordner "icqwatch" mit allen enthaltenen Dateien (einschlielich des
Ordners selbst) kopieren.
Die Datei icqwatch braucht die Rechte 755.
Danach in den Ordner /var/tuxbox/plugins wechseln, dorthin mssen die Dateien
icqwatch.cfg und icqwatch.so (icqwatch.so braucht die Rechte 755)

Die einzigen Einstellungen mssen in der "icqwatch.conf" vorgenommen werden.

Der Parameter

 InetConnection=ISDN

teilt dem Plugin mit, da der Internetzugang per ISDN erfolgt. Statt ISDN kann auch ANALOG
eingetragen werden. Fr DSL ist kein Eintrag notwendig (default). Anhand dieses Parameters
werden beim Download von Dateien die Timeouts fr Verbindungsaufnahme und Gesamtdownload-
Zeit sowie die Dateigre berechnet, ab welcher der Fortschrittsbalken im LCD angezeigt wird.

Fr die Auswahl des Textfonts ist der Eintrag:

  FONT=/share/fonts/micron_bold.ttf
  
zustndig. Hier kann der gewnschte im Image verfgbare Font eingetragen werden.
Wird dieser Eintrag weggelassen, wird standardmig der Font "pakenham.ttf" ver-
wendet, welcher in jedem Image vorhanden ist.

Um bei einem whlbaren Font die Textgre anzupassen, ist der Eintrag:

  FONTSIZE=19
  
entsprechend zu modifizieren. Dieser Wert hngt stark vom verwendeten Font ab.
Wurde der Eintrag "FONT=" bereits weggelassen, sollte auch dieser Eintrag nicht verwendet 
werden, damit das Plugin den zum "pakenham.ttf" passenden Wert von 30 verwendet.

Der Aufbau der Mens erfolgt ber die Eintrge "MENU=" als Anfangskennung und "ENDMENU" als
Endekennung. Diese knnen beliebig tief verschachtelt und auch mit normalen Eintrgen gemischt
werden. Im einfachsten Fall knnte "MENU=ICQWatch Versionsnummer" am Anfang und "ENDMENU" am 
Ende der Liste stehen. Mindestens eine Menebene ist zwingend notwendig. Innerhalb einer aktu-
ellen Menseite aufrufbaren Untermens sind in der Anzeige durch ein vorangestelltes ">" ge-
kennzeichnet. 
Zur optischen Trennung der Eintrge kann vor den "Anzeigetext im Men" ein "*" gesetzt werden.
Unterhalb eines solchen Eintrages wird ein Trennstrich im Men gezogen.

Zum Einfgen von Info-Zeilen und Trennungen knnen Eintrge in der Form

    COMMENT=[*][Informationstext]

an beliebiger Stelle im Men eingefgt werden. "Informationstext" wird dabei auf der Menzeile
in kleinerer Schrift und in der Farbe inaktiver Eintrge angezeigt. Wird der "Informationstext"
weggelassen, wird eine Leerzeile erzeugt. Der "*" vor dem Text bedeutet, da die Zeile unter-
strichen werden soll. Steht nur ein "*" hinter dem Eintrag, wird die Unterstreichung in die
Mitte der Leerzeile verschoben, um eine gleichmigere Aufteilung zu erzielen.

Nun sind die Nutzer einzutragen, fr welche man auf ihren Onlinestatus im ICQ abfragen mchte. 
Der Eintrag der Nutzer erfolgt in der Form: 
    
    USER=[*]Nutzername,ICQ-Nummer

Die ICQ-Nummer kann dabei wahlweise mit oder ohne Trennzeichen eingetragen werden, also sowohl
"123-456-789" wie auch "123456789" oder "123 456 789" ist mglich. Als Trennzeichen knnen alle
Zeichen auer "," verwendet werden. Auch hier kann der Nutzereintrag durch voranstellen eines
"*" unterstrichen werden.

Bei mehr als zehn eingetragenen Nutzern werden immer zehn auf einer Seite angezeigt. Mittels der
Rechts- / Links-Tasten auf der Fernbedienung knnen die Seiten vor- bzw. zurckgeblttert werden.
Mit der "?"-Taste wird der Online-Status der gerade angezeigten Seite aktualisiert. 

Bedingt durch die relative langsame Antwort des ICQ-Servers knnen beim Aufbau des Onlinestatus
unterschiedlich lange Verzgerungen auftreten. Das ist leider serverbedingt und vom Plugin nicht
zu beeinflusssen.

Aus diesem Grund wird der Status auch nicht mehr sofort beim Aufruf einer Seite abgefragt, da das
die Navigation extrem verzgern wrde. Mchte man den Status der auf einer Seite angezeigten User
erfahren, mu die Taste "?" gedrckt werden. Damit wird die Abfrage gestartet und der jeweilige
Status hinter den Namen des Users geschrieben. Wurde der Status innerhalb eines Mens bereits ein-
mal abgefragt, bleibt er bis zum Verlassen des Mens erhalten und wird auch beim Blttern angezeigt.
Ein Update des angezeigten Status kann man ebenfalls mit der Taste "?" auslsen.
Mit der Home-Taste wird in die nchsthhere Menebene zurckgesprungen und auf der obersten Men-
ebene des Plugin beendet. Will man das Plugin aus einer tieferen Menebene heraus beenden, kann man
das mit der Standby-Taste tun. 

Der im Archiv enthaltene Ordner "Konfiguration ber FlexMen" enthlt alle ntigen Dateien fr die
Konfiguration von IVQWatch mittels des "Flexiblen Men-Plugins". Die Orte der dateien werden durch
die Ordnerstruktur bereits vorgegeben. Das Script "icqops" bentigt die Rechte 755. Die Datei 
"in shellexec.conf einfuegen" wird, wie der Name bereits sagt, in eine bestehende Konfigurations-
Datei des FlexMens eingefgt.

Also, viel Spa und viel Erfolg

Das New-Tuxwetter-Team
SnowHead und Worschter