EXT: Search within a radius¶

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¶

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¶

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¶

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.

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.

EXT: Search within a radius - 3