.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt =========================== EXT: Search within a radius =========================== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Kerstin Huppenbauer :Changed: 2011-01-13T21:39:06.180000000 :Author: Kerstin Huppenbauer :Email: k.huppenbauer@mapseven.de :Info 3: :Info 4: .. _EXT-Search-within-a-radius: EXT: Search within a radius =========================== Extension Key: **geosearch** Copyright 2000-2002, Kerstin Huppenbauer, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.com .. _Table-of-Contents: Table of Contents ----------------- **EXT: Search within a radius 1** **Einführung 1** Was macht die Extension? 1 Screenshot 1 **User Handbuch 2** Installation 2 Geodaten importieren 2 Objekte anlegen 2 Plugin einfügen 3 .. _Einfhrung: Einführung ---------- .. _Was-macht-die-Extension: Was macht die Extension? ^^^^^^^^^^^^^^^^^^^^^^^^ Die Umkreissuche ermöglicht die Suche aller Objekte (z.B. Händler) im Umkreis einer Postleitzahl.Der User gibt seine Postleitzahl und den Umkreis ein, wählt gegebenenfalls das Land, und erhält eine Trefferliste aller Objekte dieses Gebietes.Werden nur die ersten Ziffern der Postleitzahl eingegeben, werden alle Objekte dieses Postleitzahlbereichs angezeigt. Der Umkreis bleibt hierbei unberücksichtigt. .. _Screenshot: Screenshot ^^^^^^^^^^ |img-1| .. _User-Handbuch: User Handbuch ------------- .. _Installation: Installation ^^^^^^^^^^^^ Bei der Installation der Extension über den Extension-Manager werden die Tabellen tx\_geosearch\_objects und tx\_geosearch\_coordinates angelegt. Die Tabelle tx\_geosearch\_coordinates enthält die Georeferenzierung der Postleitzahlen, tx\_geosearch\_objects enthält die Objekte, die durch die Geosearch ermittelt werden sollen. Sollten Sie bereits eine frühere Version der Extension im Einsatz haben, so löschen Sie vor dem Update die Tabelle tx\_geosearch\_coordinates da sich die Struktur geändert hat. .. _Geodaten-importieren: Geodaten importieren ^^^^^^^^^^^^^^^^^^^^ Es ist Ihnen freigestellt, welche Daten Sie für die Georeferenzierung verwenden. Die Tabellenstruktur von tx\_geosearch\_coordinates ist für die GeoNames-Daten vorbereitet, die Sie unter `http://download.geonames.org/export/zip/ `_ herunterladen und z.B. Über phpmyadmin importieren können. Beachten Sie dabei die Lizenzbedingungen. Selbstverständlich können auch andere Daten (z.B. Von OpenGeoDB) verwendet werden, sofern die Struktur beibehalten wird. .. _Objekte-anlegen: Objekte anlegen ^^^^^^^^^^^^^^^ Die Objekte können auf einer beliebigen Seite angelegt werden. Haben Sie das Plugin auf mehreren Seiten oder in unterschiedlichen Sprachen im Einsatz, so können Sie die Objekte z.B. auf mehrere Sysfolder verteilen. Wählen Sie im Listenmodul der Seite “Neuen Datensatz anlegen” und dort “Objekte”, tragen Sie hier die Daten Ihrer Objekte ein. Die Postleitzahl und das Land muss dabei eingetragen sein. Sollten Sie eine frühere Version dieser Extension im Einsatz haben, so müssen Sie in ihren bisherigen Objekten das Land nachpflegen. Die Felder Laitude und Longitude werden beim ersten Aufruf des Plugins im Frontend automatisch gesetzt. |img-2| .. _Plugin-einfgen: Plugin einfügen ^^^^^^^^^^^^^^^ Fügen Sie zunächst ein belieges Seitenelement in Ihre Seite ein. Wählen Sie dann als Typ “Plugin einfügen” und als Erweiterung die “Umkreissuche”. Alle Optionen können bei den Plugin-Options eingestellt werden. Es sind keine TypoScript-Anpassungen notwendig. Unter den Allgemeinen Einstellungen können Sie ein individuelles HTML- Template sowie eine eigene CSS-Datei hochladen und die Seite mit Ihren Objekten angeben. Liegen die Objekte auf der gleichen Seite wie das Plugin, kann der Startingpoint leer bleiben. Unter den Sucheinstellungen legen Sie fest, ob die Suche nur bei vollständig eingegebenen Postleitzahlen Ergebnisse liefern soll. Andernfalls werden bei unvollständigen Postleitzahlen auch Objekte des Postleitzahlbereichs ohne Berücksichtigung des Radius angezeigt.Wählen Sie außerdem die Länder, für die die Suche angeboten werden soll. Ist kein Land ausgewählt, wird standardmäßig nur in Deutschland gesucht. Stellen Sie sicher, daß die georeferenzierten Daten für diese Länder in der Tabelle tx\_geosearch\_coordinates vorhanden sind.Zudem können Sie einen maximalen Radius angeben innerhalb dessen gesucht wird und die Einheit festlegen. Bei den Listeneinstellungen können Sie letztlich noch die Anzahl der angezeigten Objekte in einer Ansicht einstellen. |img-3| |img-4| EXT: Search within a radius - 3 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 268 .. :id: Grafik1 .. :name: Grafik1 .. :width: 141 .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 553 .. :id: Grafik4 .. :name: Grafik4 .. :width: 223 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 274 .. :id: Grafik2 .. :name: Grafik2 .. :width: 389 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102