README

Contao-Bundle zur Verwaltung von Imkern und Bienenschwarmfängern. Ermöglicht die Erfassung von Imker-Einträgen mit Geo-Koordinaten sowie die öffentliche Suche über PLZ/Ort mit Kartenansicht.

Voraussetzungen

Installation

composer require srhinow/schwarmalarm-bundle

Nach der Installation:

php vendor/bin/contao-console contao:migrate
php vendor/bin/contao-console cache:clear

Backend-Module

Das Bundle fügt unter Schwarmalarm folgende Backend-Bereiche hinzu:

CSV-Export

Im Imker-Modul steht ein CSV-Export aller Einträge zur Verfügung (Button in der Kopfzeile der Liste).

Frontend-Module

Suchformular

Das Suchformular (beekeeper_search_form) speichert PLZ/Ort, Entfernung und ermittelte Geo-Koordinaten in der Contao-Session. Alle anderen Module lesen diese Session aus, sodass Formular und Ergebnisliste/Karte auf verschiedenen Seiten oder Seitenbereichen platziert werden können.

Die Autocomplete-Suche greift auf die tl_zip_coordinates-Tabelle zurück und liefert Vorschläge ab zwei eingegebenen Zeichen.

Schwarmzeit-Einschränkung

Die Ergebnisliste kann auf eine konfigurierbare Schwarmzeit eingeschränkt werden. Start und Ende werden im Backend-Modul als Datum im Format TT.MM (z. B. 01.04 für den 1. April) hinterlegt. Außerhalb der Saison zeigt das Modul einen Hinweistext statt der Ergebnisse.

Templates

Alle Frontend-Templates liegen als Twig-Dateien in contao/templates/ und können in der Contao-Templateverwaltung überschrieben werden:

Alle sichtbaren Texte in den Templates werden über Sprachdateien definiert (TL_LANG['MSC']['bk_*']) und sind in Deutsch und Englisch enthalten.

Sprachdateien

Das Bundle liefert vollständige Sprachdateien für Deutsch (de) und Englisch (en) für alle DCA-Tabellen sowie Frontend-Texte.

Notification Center — Insert Tags

Das Bundle stellt folgenden Insert Tag für das Notification Center bereit:

E-Mail-Verifizierung (beekeeper_verify_link)

Das Modul liest den URL-Parameter ?key=... aus, sucht den zugehörigen Imker-Eintrag und setzt bei Erfolg verified = 1. Sind darüber hinaus Geo-Koordinaten vorhanden (lat und lon ≠ 0), wird der Eintrag automatisch auf published = 1 gesetzt und erscheint damit in den Suchergebnissen.

Konfigurierbare Meldungen im Modul:

• Kein/ungültiger Key — message_false_url
• Eintrag nicht gefunden — message_no_entry
• Bereits verifiziert — message_allready_verified
• Weiterleitung — optionale jumpTo-Seite nach erfolgreicher Verifizierung

Der Aktivierungslink wird über das Notification Center versendet. Der Verifikations-Key wird serverseitig bei der Formularabgabe über den prepareFormData-Hook generiert (bin2hex(random_bytes(16))) und steht in NC-Nachrichten als ##form_key## zur Verfügung:

{{link_url::PAGE_ID}}?key=##form_key##

{{beekeeper_edit_link::EMAIL}}

Erzeugt einen absoluten Backend-Deeplink zur Bearbeitung des Imker-Eintrags mit der angegebenen E-Mail-Adresse.

Verwendung in NC-Benachrichtigungen:

{{beekeeper_edit_link::##form_email##}}

Das NC ersetzt ##form_email## zuerst durch die tatsächliche E-Mail-Adresse, anschließend löst Contao den Insert Tag auf und gibt eine vollständige URL zurück, z. B.:

https://example.com/contao?do=tl_schwarmalarm_beekeeper&act=edit&id=42

Wird keine übereinstimmende E-Mail gefunden, gibt der Tag eine leere Zeichenkette zurück.

Services

Entwicklung

composer install
vendor/bin/phpunit

Lizenz

LGPL-3.0-or-later — siehe LICENSE.