Telefonummernsuche-Plugin
=========================

Autor:      barabas
Version:    1.2a
Datum:      18.04.2007


Zweck des Plugins:
==================

Mit diesem Plugin knnen sowohl Telefonnummern gesucht werden, als auch Adressen 
von denen eine Telefonummer bekannt ist.
Als Quelle fr die Telefonnummern dient die Seite (c) GoYellow.de
Als Quelle fr die Ortsnamensuche dient www.deutschland-adressen.de
Die Suche funktioniert natrlich nur, wenn die Telefonnummer bei (c) GoYellow.de 
gespeichert ist. 
Wenn vorhanden, kann auch ein Stadtplan (Luftbild) der gesuchten 
Adresse, in 4 Zoomstufen angezeigt werden.


Vorraussetzungen:
=================

Zur Dateneingabe wird das Input-Plugin, zur Telefonnummernanzeige wird das 
New-Tuxwetter-Plugin bentigt. Fr den Menaufbau wird das Flexmen (shellexec) 
bentigt. Diese Plugins sind nicht im Archiv enthalten und mssen extra 
heruntergeladen und installiert werden. Auerdem wird zur 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.

Ausserdem muss die Box unbedingt ber einen Internetzugang verfgen. 
Eine Internet-Flatrate ist fr alle Plugins, die das Internet benutzen, ratsam. 


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
-----------------------------------------------------------------------------------------------------------------------
phone.sh               /var/plugins/                  755        ja          ja
input                  /var/bin/                      755        nein        ja
msgbox                 /var/bin/                      755        nein        ja 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

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

ACTION=&Telefonnummern Suche,( /var/plugins/phone.sh makemainmenu ; if [ -f /tmp/phone_main.inc ] ; then /var/plugins/shellexec /tmp/phone_main.inc ; rm /tmp/phone_* ; else msgbox popup='Fehler bei der Erstellung des Menus' 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.

Bedienung:
==========

Ruft man den Menupunkt Telefonnumern Suche im Flexmen auf, so hat man folgende 
Menupunkte zur Auswahl:

Suche nach Name:
----------------
Hier wird ein weiteres Men aufgerufen, dessen Funktion weiter unten erklrt wird.  

Suche nach Telefonnummer:
-------------------------
Hier kann bei einer bekannten Telefonnummer die Adresse des Teilnehmers gesucht 
werden.

Letztes Suchergebnis anzeigen:
------------------------------
Mit diesem Menpunkt wird das Ergebnis der letzten Suche angezeigt.

Darunter werden die Suchkriterien angezeigt, die man gerade abgespeichert hat.

Suche nach Name:
----------------
Bei der Suche nach Name hat man wieder mehrere Menpunkte zur Auswahl:

Ort ber PLZ ermitteln:
----------------------- 
Hier kann der Ortsname ber eine eingebene Postleitzahl gesucht werden.

Ort (A-Z) auswhlen:
--------------------
Hier kann der Ortsname aus einer Liste von Stdten bernommen werden, die in 
der Datenbank von www.deutschland-adressen.de enthalten sind. Der gewnschte Ort 
wird mit OK oder entsprechender angezeigter Taste in die Suchliste gespeichert.
Dann den Menupunkt mit 'Home' verlasssen, um wieder ins vorherige Men 
zurckzukehren.

Achtung:
--------
Je nach Anzahl der in der Datenbank enthaltenen Ortsnamen, kann diese Suche 
einige Zeit in Anspruch nehmen.

Ort eingeben /suchen:
---------------------
Hier kann der Ortsname oder Teilstring eingegeben werden, nach dem gesucht werden 
soll. Mit der Volume + bzw. Volume - Taste knnen einzelne Zeichen eingefgt bzw. 
gelscht werden. Das Ergebnis wird in der Suchliste gespeichert.

Name eingeben und Tel. suchen:
------------------------------

Hier wird der Name eingegeben, nach dem gesucht werden soll. Der Vorname wird zuerst 
eingegeben und mit einem Leerzeichen (Taste 0) vom Nachnamen getrennt. Gibt man 
nur den Nachnamen ein, so werden alle gefundenen Teilnehmer mit diesem Nachnamen 
angezeigt. Mit der Volume + bzw. Volume - Taste knnen einzelne Zeichen eingefgt 
bzw. gelscht werden. Die Suche achtet nicht auf Gro- und Kleinschreibung, die 
Anfangsbuchstaben eines Namens mssen also nicht gro geschrieben werden.

Suchergebnis:
-------------

Bitte beachten, dass bei einer Suche nach der Postleitzahl nur die Teilnehmer im 
ensprechenden Postleitzahlenbereich gesucht werden. Bei der Suche nach dem Ortsnamen, 
werden alle Teilnehmer des entsprechenden Orts aufgelistet. 

Ergebnisanzeige:
---------------- 

Das Suchergebnis wird ber das Tuxwetter-Plugin angezeigt. Bei Suche wird abgefragt, 
ob die Adressen als Liste, oder einzeln mit Stadtplan angezeigt werden sollen.  
Werden mehrere Adressen angezeigt, die nicht mehr auf eine Seite passen, kann mit 
Cursor-Rechts oder Cursor-Links in der angezeigten Liste geblttert werden.

Lsst man sich die Adressen einzeln anzeigen, so hat man, sofern vorhanden, auch 
noch die Wahlmglichkeit einer Stadtplananzeige in Form eines Luftbilds mit 4 
Zoomstufen.

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.

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