Kinosuche-Plugin
----------------

Autor:      rich
Version:    0.05
Datum:      07.01.2007


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

Das Plugin dient zur Suche, welche Filme gerade im Kino laufen. Man kann
entweder eine Stadt zur Auswahl manuell eingeben oder die Stdte fest
eintragen, in denen man die Vorschau des Kinoprogramms suchen mchte.
Die Termine sowie eine Filmbeschreibung werden ebenfalls angezeigt,
wenn vorhanden auerdem ein Foto des Films.

Mit diesem Plugin knnen alle Kinos und Filminfos, die man auf der Internetseite
http://www.heutekino.de findet, gesucht werden.


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

Zur Dateneingabe wird das Input-Plugin, zur Bildausgabe wird das New-Tuxwetter-
Plugin bentigt. Falls die Bildausgabe nicht gewnscht ist, kann die Installation 
des New-Tuxwetter-Plugin entfallen. 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 Filmbeschreibung 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:
-------------

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
-----------------------------------------------------------------------------------------------------------------------
kino_heute.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        optional nur zur Bildanzeige
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

Optional kann das Plugin von blauen Taste ber das Features-Men gestartet werden.
----------------------------------------------------------------------------------
kino_heute            /var/tuxbox/plugins/            755        ja          optional
kino_heute.so         /var/tuxbox/plugins/            755        ja          optional
kino_heute.cfg        /var/tuxbox/plugins/            644        ja          optional

In der Datei shellexec.conf mssen folgende Eintrge eingefgt werden:

MENU=Kino-Suche-Plugin
    COMMENT=Favoriten-Liste
    INCLUDE=/var/tuxbox/config/kino_suche.conf
    COMMENT=*
    DEPENDON=-&Alte Kino-Programmliste anzeigen,shellexec /tmp/kino_kino.flx || rm /tmp/kino_kino.flx,/tmp/kino_kino.flx
    COMMENT=*
    ACTION=&Alle Kino-Neustarts anzeigen,/var/plugins/kino_heute.sh NEUE
    COMMENT=*
    ACTION=&Kino-Suche in ...,/var/plugins/kino_heute.sh SUCHE
    DEPENDON=-&Altes Suchergebnis anzeigen,shellexec /tmp/kino_heute.flx || rm /tmp/kino_heute.flx,/tmp/kino_heute.flx
    COMMENT=*
    ACTION=&Kino-Suche in Reutlingen,/var/plugins/kino_heute.sh SUCHE "Reutlingen"
    ACTION=&Kino-Suche in Stuttgart,/var/plugins/kino_heute.sh SUCHE "Stuttgart"
    ACTION=&Kino-Suche in T~ubingen,/var/plugins/kino_heute.sh SUCHE "Tbingen"
    COMMENT=*
ENDMENU

Diese Beispieldatei ist in diesem Archiv in
'/var/tuxbox/config/in shellexec.conf einfuegen' enthalten.

Die Stdtenamen knnen natrlich gendert werden, dabei ist folgendes zu beachten:

Damit die Namen im Flexmen richtig angezeigt werden, sind folgende Sonderzeichen
nach dem Eintrag 'Kino-Suche in' entsprechend folgender Tabelle zu ersetzen:

  ~a
  ~o
  ~u
  ~A
  ~O
  ~U
  ~z

Die Eintrge nach dem Begriff 'SUCHE' knnen normal mit den Umlauten geschrieben werden,
und sind in " " einzusetzen.

Die Eingaben mssen mit einem Unix-Editor im Linux-Format gemacht werden.
-------------------------------------------------------------------------

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

Alternativer Start der Kino-Suche ber das Features Men (blaue Taste)
----------------------------------------------------------------------

Wenn man das Plugin nur ber die blaue Taste starten will, mssen die oben 
beschriebenen nderungen in der Datei '/var/tuxbox/plugins/kino_suche' gemacht 
werden. Die Eintrge in '/var/tuxbox/config/shellexec.conf' knnen dann entfallen. 
Dazu sind die Dateien 'kino_suche', 'kino_suche.cfg' und 'kino_suche.so' nach
'/var/tuxbox/plugins/' zu kopieren und mit den oben beschriebenen Rechten zu 
versehen.


Bedienung:
----------

Das Plugin wird ber das Flexmen aufgerufen. Im Flexmen den Eintrag
'Kino-Suche-Plugin' suchen, und OK drcken.
Jetzt entweder einen Eintrag fr die Kino-Suche in der entsprechenden Stadt mit
OK-Taste auswhlen oder den Eintrag 'Kino-Suche in ...' aussuchen.
Wird die Suche darber aufgerufen, erscheint eine Eingabebox, in die die Stadt
eingeben wird. Es knnen auch nur die ersten Buchstaben der zu suchenden Stadt
eingegeben werden, eventuell werden dann mehrere Stdte angezeigt.
Dann die OK-Taste drcken.
Nach kurzer Zeit sollte jetzt eine Vorschauliste mit den Kinos und den Filmen
erscheinen. Klickt man jetzt mit OK auf den Film, erscheint eine Messagebox mit
der Filmbeschreibung. Unten sind jetzt noch die Schaltflchen 'EXIT', 'Seite 2'
und 'Bild-Info' zu sehen, die man mit den Pfeiltasten umschalten und dann mit OK
auswhlen kann. Beim Aufruf von 'Seite 2' erscheint der Rest der Filmbeschreibung,
'Bild-Info' ruft das Tuxwetter-Plugin auf um ein Foto des Films auf dem Bildschirm
anzuzeigen. Mit OK oder Home wird die Bildanzeige verlassen, und wieder in die
Messagebox zurckgesprungen. 'EXIT' mit OK-Taste oder Home verlsst die Messagebox,
und springt wieder zurck in die Kinovorschau. Jetzt knnen Filminfos der anderen
Filme aufgerufen werden oder mit Home zurck ins Auswahlmen gesprungen werden,
noch mal Home zurck ins Grundmen usw. .
Die Vorschauliste ist meistens auf mehrere Seiten verteilt, man siehts an dem
Rollbalken rechts.

Ruft man im Men den Menpunkt fr das Kino auf, so wird oben ein Menpunkt mit
Informationen ber das Kino wie Anzahl der Pltze, Leinwnde, Adresse und
Telefonnummer angezeigt.
Ruft am diesen auf, so kann man hier mit 'Ausblenden' die Kinodetails in der
Kino-Information ausblenden und mit 'Einblenden' diese wieder aktivieren. Mit
'Hinzufgen' legt man fest, ob man das Kino direkt in eine Favoritenliste im
Kino-Suche Men aufnehmen mchte. War das Kino schon in der Favoritenliste
eingetragen, so wird stattdessen die Schaltflche 'Entfernen' angezeigt. Bettigt
man diese, wird das Kino wieder aus der Favoritenliste entfernt. Mit 'EXIT' oder
Home gehts wieder ins vorherige Men.
Darunter werden die Filme angezeigt, die in der laufenden Programmwoche in diesem
Filmtheater gezeigt werden.
Klickt man jetzt auf einen Film, so werden die Termine der laufenden Woche fr
diesen Film des ausgewhlten Kinos angezeigt. Darunter steht die Telefonnummer
des Kinos, was bei Kartenvorbestellungen ntzlich ist, da man alles Notwendige
auf einen Blick vor sich hat. Die Schaltflche 'Film-Info' ruft wieder die
Filmbeschreibung auf. Mit der Schaltflche 'Kino-Info' werden alle Informationen
ber das Filmtheater angezeigt. Mit 'EXIT' oder Home gehts wieder ins vorherige
Men.

Mit dem Menpunkt 'Alle Kino-Neustarts anzeigen' werden alle Neustarts der
laufenden Programmwoche angezeigt. Durch Auswahl eines Films und der Besttigung
mit 'OK', wird eine kleine Kurz-Information zu diesem Film angezeigt. Von hieraus
kann wieder mit 'Film-Info' die komplette Beschreibung angezeigt werden. Mit
'Film-Suche...' kann man sich nach Auswahl einer Stadt, die Kinos anzeigen lassen, in 
denen dieser Film im Spielplan ist. Die Auswahl der Stadt wird dadurch erleichtert, indem
automatisch bei vorhanden sein einer Favoritelnliste, die darin enthaltenen Stdte zur
Auswahl angeboten werden. Ist die gewnschte Stadt nicht enthalten, kann diese ber
'Stadt eingeben...' eingegeben werden. Ist keine Favoritelnliste vorhanden, gelangt man
direkt zur Eingabemaske fr die Stadt, in der gesucht werden soll.
Nach kurzer Zeit werden alle gefundenen Kinos mit diesem Film angezeigt. Ist der Film
nicht in den Kinos dieser Stadt im Spielplan, wird dies ber eine entsprechende Ausgabe
angezeigt. Mit 'EXIT' gehts zur vorherigen Flexmenebene und mit Home wieder zum
vorherigen Anzeigefenster zurck.

Die Favoriten werden in der Datei '/var/tuxbox/config/kino_suche.conf' auf der
Box gespeichert.

Hat man seit dem letzten Einschalten der Box bereits eine Suche
durchgefhrt, so stehen beim Aufruf des Kino-Suche-Mens noch die Menpunkte
'Alte Kino-Programmliste anzeigen' und 'Altes Suchergebnis anzeigen'
extra zur Verfgung. Ruft man diese auf, so werden die Daten nicht neu
eingelesen und berechnet, sondern direkt angezeigt, was natrlich schneller geht.
Da die Daten fr diese Menpunkte im RAM-Speicher der Box im Verzeichnis
'/tmp/' gespeichert werden, stehen sie direkt nach einem Neustart der Box
nicht zur Verfgung, da der RAM-Speicher der Box beim Ausschalten gelscht
wird.


Credits:
--------

Vielen Dank an rich fr die Erstellung des Kinosuche-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.

Viel Spa mit dem Kinosuche-Plugin wnscht Euch DrStoned :-) :-) :-)
