README

Beschreibung

Dieses Contao Modul erlaubt das Synchronisieren von Veranstaltungen aus dem Freizeitkalender (https://www.freizeitkalender.eu) über die JSON API-Schnittstelle in die Contao Events.

Event-Modul

Im Contao-Event Modul kann im entsprechenden Kalender die Synchronisation mit dem Freizeitkalender aktiviert werden. Hierfür muss die vollsändige API-URL angegeben werden, z.B.: https://www.freizeitkalender.eu/api/json/XXX. Diese URL muss im Backend des Freizeitkalenders erstellt werden.

Synchronisation

Standardmäßig vergleicht die Synchronisation die Daten anhand der Änderungszeiten.

In den Events des entsprechenden Kalenders befindet sich auch der Punkt "Synchronisere Daten aus Freizeitkalender". Damit kann jederzeit händisch ein Abgleich der Veranstaltungsdaten durchgeführt werden. Dabei entsteht auch ein ausführliches Protokoll.

Sollen immer alle Events vollständig synchronisiert werden (auch wenn keine Änderung stattgefunden hat), gibt es die Möglichkeit die Synchronisation zu forcieren. Dies wird ausdrücklich nicht empfohlen, sondern sollte nur für Fehlersuche/Test verwendet werden.

Anhänge

Es besteht die Möglichkeit ein Teaser Bild aus der Veranstaltung in das Contao Dateisystem zu importieren. Dieses wird auch dem Event zugeordnet. Hierfür muss man im Kalender selbst das entsprechende Verzeichnis in Contao angeben.

Cron-Job

Die Events können automatisch einmal täglich über Cron synchronisiert werden. Hierfür muss die Option "Synchronisation aktivieren" im Contao-Kalender aktiviert sein.

Beta-Testphase

Das Modul befindet sich derzeit in aktiver Entwicklung. Fehler und Änderungen sind jederzeit möglich.

Lizenz

MIT-Lizenz