FNL_XH (Find Next Location)

Mit dieser Erweiterung kann man eine Umkreissuche gefiltert nach Entfernungen starten.
Entstanden ist das Plugin auf Anfrage zu einer Umkreissuche für Firmenstandorte eines Unternehmens.

Die Standortdaten, die es zu finden gilt, müssen in der Datei (/plugins/fnl/data/locations.json) im Format JSON (JavaScript Object Notation) abgelegt werden. Im Moment ist das leider noch nicht über das Backend möglich, aber das ist mit jedem Editor problemlos machbar.

Grundlage für dieses Plugin (ab Version 1.0 beta3) sind die Daten von OpenStreetMap.
OpenStreetMap Usage Policy License: Open-Database-Lizenz

Die Berechnung erfolgt anhand der angegebenen Zielkoordinaten (diese kann man z.B. von OpenStreetMap oder Google Maps entnehmen) in direkter Verbindung (Luftlinie). Die Entfernunsgangabe kann mit ausgegeben werden, ist aber natürlich entsprechend different zu der Angabe eines Routenplaners.

Die Formel zur Berechnung stammt aus Quellen wie etwa OpenGeoDB - Umkreissuche.
Da ich kein Mathematiker bin, hoffe ich das trotzdem entsprechend halbwegs korrekt umgesetzt zu haben.
Auch die Angabe des Erdradius variiert etwas. Das alles hat zur Folge, dass die Entfernungen als Näherungswerte zu betrachten sind.

Die eingepflegten Beispieldaten dienen nur als Vorlage und haben soweit natürlich nichts mit Firmenstandorten zu tun.

Informationen und Möglichkeiten zum Einbinden sind in der Plugin-Hilfe beschrieben. Die Ausgabe kann über die Plugin-Konfiguration und über Parameter beim Funktionsaufruf beeinflusst werden.

Demo 1, Demo 2

Im Plugin-Stylesheet ist ein gekennzeichneter Bereich, in dem man die Ausgabe anpassen kann.
Bei Auslieferung ist der Style beispielhaft und in einfacher Weise auf das Template "fhs-simple-2019" abgestimmt.

Installation

PHP ab Version 5.6
(Sie sollten min. Version 7.3 einsetzen!, Stand 04/2021)

Der Server muss cURL unterstützen.

Für CMSimple_XH Versionen ab 1.7.3.

Um das Plugin zu installieren, einfach den entpackten Ordner fnl in den Pluginordner laden.

Möglicherweise, abhängig vom Webserver müssen noch Dateirechte angepasst werden.
Wird PHP als CGI oder FastCGI ausgeführt, ist ein Anpassen der Dateirechte nicht notwendig.
Wenn PHP als Apache-Modul ausgeführt wird, müssen noch Rechte für

folgende Dateien:

geändert werden (0666), falls man diese über das Backend bearbeiten möchte.

Die Ordner:

benötigen 0777.

Alle Voraussetzungen lassen sich auf der Startseite des Plugins prüfen.

 https://filezilla-project.org

FileZilla Client Tutorial (de)


Logo FNL_XH Fragen, Hinweise, Fehlermeldungen zu FNL_XH

FNL_XH im CMSimple_XH Forum

Gern nehme ich auch Informationen entgegen, auf welchen Seiten das Plugin FNL_XH eingesetzt wird.
Ich möchte keine Statistik führen oder gar veröffentlichen. Es geht einfach darum, zu wissen, ob weiteres Arbeiten an diesem Plugin sinnvoll ist.

 

FNL_XH kann unter Einhaltung der GPLv3 verwendet werden.

 

Version 1.0 beta3 für CMSimple_XH Versionen ab 1.7.3

 

 

Softwareentwicklung ist teilweise sehr aufwendig und findet, für jede hier angebotene Software, in meiner Freizeit statt. Daher freue ich mich über jede Unterstützung. Zum Teil wird damit z.B. einfach diese Website finanziert.
Außerdem bringt eine kleine Anerkennung zwischendurch immer wieder etwas Schwung in die Entwicklung.

 Kaf­fee­kas­se

Stichwortliste: CMSimple_XH, FNL_XH, Plugin, Plugins, Umkreissuche