Ebay-WAP-Plugin
----------------

Autoren:    barabas
            rich ( Einbau des Erinnerungstimers fr die Dbox2 ) 
            DrStoned ( Einbau der optionalen Soundausgabe, 
                       bei Ausfhrung Erinnerungstimer )
Version:    1.4g
Datum:      29.03.2008


Zweck des Plugins:
------------------

Das Plugin dient zur Suche und Beobachtung von Artikeln, die bei Ebay zu finden 
sind. Es luft sowohl auf der Dbox2, als auch auf der Dreambox.

Mit diesem Plugin knnen Begriffe, Artikelnummern und Ebay-Mitgliedsnamen gesucht 
und beobachtet werden, die man auf der Internetseite von http://wap.ebay.de findet.
Es werden die kompletten Artikeldaten wie Verkufer, Bieter, aktueller Preis, 
Auktionsbeginn, Auktionsende und Ort angezeigt. Mit Hilfe des Tuxwetter-Plugins 
kann auch ein Foto des Artikels und die Artikelbeschreibung angezeigt werden. 
Ab Version 1.1c ist auch noch die Programmierung eines Erinnerungstimers enthalten, 
der kurz vor Auktionsende, bei der gewnschten Zeit, eine Meldung auf dem 
TV-Bildschirm ausgibt. 

Bei der Version 1.4g wurde von mir fr die Dbox noch eine optionale Soundausgabe 
bei der Ausfhrung des Erinnerungstimers eingebaut. Dies hat den Vorteil, dass man 
beim Ausfhren des Timers akustisch sofort mitbekommt, dass die beobachtete 
Auktion in die entscheidende Phase tritt, auch wenn man gerade nicht auf die 
Glotze schaut.

Vorraussetzungen:
-----------------

Zur Dateneingabe wird das Input-Plugin, zur Bildausgabe und Artikelbeschreibung 
wird das New-Tuxwetter-Plugin bentigt. Fr den Menaufbau wird das Flexmen 
(shellexec) bentigt. Diese Plugins sind nicht im Archiv enthalten und mssen 
extra runtergeladen und installiert werden. Auerdem wird zur Artikelanzeige und 
Fehlerausgabe noch die Messagebox bentigt, die aber im aktuellen JtG-Image 
seit Ende August 2006 enthalten ist.

Diese zustzlichen Plugins knnen alle im JtG-Plugin-Forum herunterladen werden.
Deren Installation ist in den entsprechenden readme.txt dieser Archive beschrieben.

Auerdem muss die Box unbedingt ber einen Internetzugang verfgen.


Installation:
-------------

Achtung : Diese Installationsanleitung gilt nur fr die Dbox2
-------------------------------------------------------------

Die folgenden Dateien sind per FTP im BINR-Modus auf die Box in die entsprechenden
Verzeichnisse zu bertragen, und die Rechte so zu vergeben, wie sie angegeben sind.

Dieser Hinweis gilt besonders fr Benutzer des FTP-Programms Filezilla.
-----------------------------------------------------------------------


Bentigte Dateien:
------------------

Datei                  Verzeichnis auf Dbox          Rechte    im Archiv   unbedingt bentigt
-----------------------------------------------------------------------------------------------------------------------
ebaywap.sh             /var/plugins/                  755        ja          ja
input                  /var/bin/                      755        nein        ja
msgbox                 /var/bin/                      755        nein        im aktuellen JtG-Image in /bin/ enthalten
tuxwetter              /var/plugins/tuxwet/           755        nein        ja
shellexec.so           /var/tuxbox/plugins/           755        nein        ja
shellexec.cfg          /var/tuxbox/plugins/           644        nein        ja
shellexec              /var/plugins/                  755        nein        ja
shellexec.conf         /var/tuxbox/config/            644        nein        ja

Dateien fr zustzliche Soundausgabe beim Erinnerungstimer:
-----------------------------------------------------------

Datei                  Verzeichnis auf Dbox          Rechte    im Archiv   unbedingt bentigt
-----------------------------------------------------------------------------------------------------------------------
Ebay-Alarm.sh          /var/tuxbox/plugins/           755        ja          nein
Ebay-Alarm.cfg         /var/tuxbox/plugins/           644        ja          nein
tuxcal_timer.wav       /var/tuxbox/config/tuxcal/     644        ja          nein


In der Datei shellexec.conf muss folgender Eintrag eingefgt werden:

ACTION=Ebay WAP Suche,( /var/plugins/ebaywap.sh makemainmenu ; if [ -f /tmp/ebaywap_main.inc ] ; then /var/plugins/shellexec /tmp/ebaywap_main.inc ; rm /tmp/ebaywap* ; else msgbox popup='Fehler bei der Ermittlung der Daten' timeout=5 ;fi )

Diese Beispieldatei ist in diesem Archiv in
'/var/tuxbox/config/in_shellexec.conf_einfuegen' enthalten.


Der Eintrag muss mit einem Unix-Editor im Linux-Format gemacht werden.
----------------------------------------------------------------------

Falls Ihr noch keine Erfahrung mit dem Flexmen und dessen Menstruktur habt,
bitte unbedingt die readme.txt dieses Plugins durchlesen.


Suchlisten:
-----------

Die Suchlisten werden in folgenden Dateien gespeichert:

artikelliste=/var/tuxbox/config/ebaywap_artikelliste.txt
suchtextliste=/var/tuxbox/config/ebaywap_suchtextliste.txt
memberliste=/var/tuxbox/config/ebaywap_memberliste.txt
meine_ebayliste=/var/tuxbox/config/ebaywap_meinebayliste.inc

Die folgenden Dateien werden im tmp-Verzeichnis der Box abgespeichert, da sie 
sehr gro werden knnen, was unter Umstanden zur Zerstrung des JFFS2-Dateisystems 
auf der Box gefhrt htte, wenn man sie nach /var/tuxbox/config/gespeichert htte. 
Allerdings werden diese Dateien beim Abschalten oder Neustart der Box gelscht, 
was dazu fhrt, dass die Menpunkte "Letzes Suchergebnis anzeigen" und 
"Letzte Mitgliedersuche anzeigen" nach einem Neustart der Box nicht mehr zur Verfgung
stehen.

letztesuchliste=/tmp/lastsearchliste_ebaywap.inc
letzte_membersuche=/tmp/lastmembersearch_ebaywap.inc

Alle diese Dateien werden zur Laufzeit des Plugins angelegt und mssen nicht unbedingt 
erstellt werden.


Alternative Speicherung der Suchlisten auf die eingebaute Festplatte der Dbox:
------------------------------------------------------------------------------

Hat man jedoch eine Festplatte in der Box eingebaut, so wie ich, kann man den 
Speicherort dieser Dateien auf die Festplatte verlegen. 
Dazu muss man das Verzeichnis /hdd/tuxbox/config/ auf der Festplatte anlegen, 
z.B. per Telnet mit:

mkdir /hdd/tuxbox/
mkdir /hdd/tuxbox/config/

Dadurch hat man den Vorteil, dass die Menpunkte "Letzes Suchergebnis anzeigen" und 
"Letzte Mitgliedersuche anzeigen" nach einem Neustart der Box wieder zur Verfgung
stehen.

Falls gewnscht wird, dass das Plugin diesen Vorgang bei eingebauter Festplatte 
selbststndig ausfhrt, bitte im Forum posten, ich knnte dann das Plugin 
dementsprechend umbauen.


Optionale Soundausgabe beim Ausfhren des Erinnerungstimers:
------------------------------------------------------------

Wie schon oben erwhnt, besteht die Mglichkeit, beim Ausfhren eines 
Erinnerungstimers eine optionale akustische Benachrichtigung zu erhalten. 
Dies wird durch die Erstellung eines zustzlichen Plugin-Timers erreicht, 
der dann bei der Ausfhrung das Shellskript 'Ebay-Alarm.sh' ausfhrt. Dieses 
Skript fhrt dann den Tuxmaild aus, der normalerweise in jedem aktuellen 
Image enthalten ist, der das Abspielen der Sounddatei 
'/var/tuxbox/config/tuxcal/tuxcal_timer.wav' erledigt. 

Habt Ihr Euer Soundfile woanders gespeichert, so msst Ihr den Speicherort 
mit einem Unix-Editor in der Datei '/var/tuxbox/plugins/Ebay-Alarm.sh' anpassen.
Wenn Ihr das Soundfile 'tuxcal_timer.wav' nicht, oder am falschen Platz auf die 
Box kopiert, wird von einer netten Frauenstimme beim Ausfhren des Timers der Text 
"Neue Nachrichten liegen auf dem Server" angesagt, ist es im richtigen Pfad 
installiert, wird der Weckruf einer Sdstaatenfanfare abgespielt ;-). 

Ihr knnt natrlich auch ein eigenes Soundfile installieren, es dabei aber wichtig, 
dass die Box nur PCM WAV-Dateien in 8 oder 16 Bit Mono, 12, 24, oder 48 KHz 
abspielen kann. Stereo geht auch, die Dateien dann aber entsprechend grer. 
Ich empfehle aus Platzgrnden deswegen 8 Bit Mono, 12 KHz, wenn Ihr die Sounddatei 
im Image speichert. Habt Ihr dagegen das Soundfile auf einem externen Medium, 
wie HDD, MMC, oder auf einem gemounteten Verzeichnis gespeichert, spielt die Gre 
aber keine Rolle.
 
Ausserdem ist noch wichtig, dass die aktuelle Version D1.48 von Tuxmaild im Image 
habt. Der sollte aber bei den aktuellen Images seit einem Jahr eingebaut sein. 
Sonst kracht es furchbar beim Abspielen.

Das Abspielen des Soundfiles funktioniert nur, wenn Ihr den Ton ber die Chinch-
bzw. Scartbuchse bertragt. Sollte ein Verstrker nur am optischem Digitalausgang 
der Box angeschlossen sein, funktioniert die Tonausgabe nicht.

Achtung:
--------

Bei meinen Tests mit diesem Plugin habe ich folgendes festgestellt.
Der Ebay-WAP-Server http://wap.ebay.de ist nicht stark belastbar. Sollte ab 
und zu einmal die Meldung 'der Ebay-Server ist nicht erreichbar' kommen, 
einfach spter nochmal versuchen. 


Credits:
--------

Vielen Dank an barabas fr die Erstellung des Ebay-Suche-Plugins.
Ebenfalls Danke an SnowHead vom New-Tuxwetter-Team fr die Programmierung
der Plugins Input, Messagebox, New-Tuxwetter und Flexmen, ohne die dieses
Plugin nicht mglich gewesen wre.
Vielen Dank auch an rich fr die Mglichkeit der Anzeige eines Erinnerungstimers. 

Viel Spa mit dem Ebay-WAP-Suche-Plugin wnscht Euch DrStoned :-) :-) :-)