Bitte beachte, dass sich diese Dokumentation auf die neuste Version dieser Erweiterung bezieht. Wenn eine ältere Version eingesetzt wird, kann diese abweichen. Die jeweils passende Dokumentation befindet sich im Dokumentation-Verzeichnis der Erweiterung.
Standort-Button einfügen
Mit einem Standort-Button kann der Besucher seinen aktuellen Standort über den Browser ermitteln lassen. Die ermitteltenGeo-Koordinaten werden anschließend direkt für die Umkreissuche verwendet.
Voraussetzungen
- Das Filter-Feld
Locationmuss im Such-Plugin aktiviert sein, damit die Felderaddress-location-field,address-latitude-fieldundaddress-longitude-fieldim Formular vorhanden sind. - Das JavaScript
AddressManagerGetGeoLocation.jswird über das TypoScript-Setup der Erweiterung automatisch eingebunden. - Browser stellen die Geolocation-API nur in einem sicheren Kontext (HTTPS) zur Verfügung.
- Der Besucher muss den Zugriff auf seinen Standort im Browser erlauben.
Button einfügen
Der Button wird über die ID get-location-button erkannt. Füge ihn z.B. in einem eigenen Template oder Partial(etwa in einer Kopie von Partials/Address/FilterFields/Location.html) ein:
<button type="button" id="get-location-button" data-location-text="Eigener Standort">
Meinen Standort verwenden
</button>
Über das Attribut data-location-text legst Du den Text fest, der nach erfolgreicher Ermittlung im Standort-Feldangezeigt wird. Verwende type="button", damit der Button das Formular nicht selbst abschickt.
Achtung:
Die ID
get-location-buttondarf pro Seite nur einmal vergeben werden.
Verhalten
Nach einem Klick (auf Touch-Geräten beim touchend-Event) wird der Standort des Besuchers abgefragt. Ist die Abfrageerfolgreich, werden Breiten- und Längengrad in die versteckten Formularfelder geschrieben und die Suche wird ausgeführt:
- Liste/Karte mit Suchformular: Die Suche wird per AJAX aktualisiert, genau wie beim Absenden des Suchformulars.Die Paginierung wird dabei auf die erste Seite zurückgesetzt und eine eventuell noch laufende Geo-Kodierung einerFreitext-Eingabe wird verworfen. Es findet keine Weiterleitung auf den JSON-Endpunkt statt.
- Such-Plugin mit Anzeigetyp „Nur Filter“ (
FilterOnly): Das Formularaddress-search-form-redirectwirdregulär abgeschickt und der Besucher wird auf die konfigurierte Listen-Seite (settings.list.defaultPid)weitergeleitet.
Unterstützt der Browser keine Geolocation, wird der Button automatisch ausgeblendet. Lehnt der Besucher die Abfrage aboder kann kein Standort ermittelt werden, wird eine Fehlermeldung als Browser-Hinweis ausgegeben.
Hinweis:
Wenn die Umkreissuche verwendet wird, wird immer nach Distanz sortiert!
