Skip to content
KLXMPublic

About

Kalender-Addon für REDAXO: RFC-5545-Wiederholungen, iCal, CalDAV, eigene Felder, Migration von forcal

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

scheduler

Termine, Serien, Kalender und Orte für REDAXO. Mit Wiederholungen nach RFC 5545, einem Editor im Stil gängiger Kalender-Apps, CalDAV, ICS-Feeds, eigenen Feldern per Formbuilder und fertigen Frontend-Modulen.

scheduler ist der eigenständige Nachfolger von forcal. Beide Addons laufen nebeneinander, ein Import holt die Daten herüber.

Wiederholungen täglich bis jährlich, mehrere Wochentage, „erster Montag im Monat“, Ende nach Datum oder Anzahl, Ausfälle und verschobene Einzeltermine, jede RRULE als Text
Editor Ganztägig-Schalter, Zeitzone, Wiederholen-Menü mit Klartext und Vorschau, Serien-Dialog „nur dieser / dieser und folgende / alle“
Kalenderansicht Schnellanlage per Klick, Verschieben und Verlängern per Drag, lädt nur den sichtbaren Zeitraum
CalDAV lesen und schreiben mit Apple Kalender, Thunderbird, DAVx⁵ und anderen, über das Addon dav
ICS Feeds mit ETag, Einzeltermin-Download, Import aus Datei oder URL, fremde Kalender als Abo mit regelmäßigem Abgleich
Eigene Felder visueller Formbuilder für Termine, Kalender und Orte, versioniert, als JSON deploybar, mit Verknüpfung zu YForm-Tabellen
Rechte je Kalender, eigene und fremde Termine, Freigabe-Ablauf, Löschen
Frontend drei Module, anpassbare Fragmente, JSON-Schnittstelle, schema.org-Daten
Leistung vorberechneter Vorkommens-Index, Filtern und Blättern vollständig in SQL

Voraussetzungen

  • REDAXO ab 5.18, PHP ab 8.4 (intl, json, mbstring, xml)
  • MySQL ab 5.7 oder MariaDB ab 10.2
  • Addon dav. Es ist die Zentrale für CalDAV und bringt die sabre-Bibliotheken mit, die scheduler auch für ICS nutzt. scheduler selbst liefert nur noch die RRULE-Bibliothek aus.

Optional, wird automatisch genutzt, wenn installiert:

Addon Wirkung
a11y_datetime_addon barrierefreier Datums- und Zeitpicker statt der nativen Browserfelder, im Editor, in der Wiederholung und in eigenen Feldern
vector_maps Kartenpicker mit Adresssuche für die Koordinaten eines Ortes, Karte auf der Termin-Detailseite
cronjob Cronjob-Typen für den Planungshorizont der Serien und für abonnierte Kalender
yform Feldtyp, der Datensätze aus YForm-Tabellen auswählt und direkt neu anlegt
builder Element Scheduler-Termine

Installation aus dem Repository

Das Repository enthält den Ordner vendor nicht. Zuerst das Addon dav installieren, dann scheduler nach redaxo/src/addons/scheduler klonen und im Addon-Ordner ausführen:

composer install --no-dev

Schnellstart

  1. Addon installieren.
  2. Scheduler › Kalender verwalten: einen Kalender anlegen.
  3. Scheduler › Kalender: in einen Tag klicken, Titel eingeben, Anlegen.
  4. Scheduler › Module: die drei Module installieren. Einen Artikel mit scheduler: Termin als Detailseite anlegen, dann scheduler: Terminliste oder scheduler: Kalender einbauen.

Oder im eigenen Code:

use KLXM\Scheduler\Scheduler;

foreach (Scheduler::occurrences()->upcoming()->inCalendars(1)->limit(10)->get() as $occurrence) {
    echo $occurrence->start->format('d.m.Y H:i'), ' ', rex_escape($occurrence->title()), '<br>';
}

Dokumentation

Im Ordner docs/ und im Backend unter Scheduler › Hilfe.

Kapitel Für wen
1. Installation und Einrichtung Administratoren
2. Termine pflegen Redaktion
3. Rechte und Freigabe Administratoren
4. Ausgabe im Frontend Entwickler
5. Eigene Felder Administratoren, Entwickler
6. ICS und CalDAV Administratoren, Redaktion
7. Umzug von forcal Administratoren, Entwickler
8. API-Referenz Entwickler
9. Architektur und Entwicklung Entwickler

Lizenz und Credits

MIT, KLXM Crossmedia GmbH. scheduler baut auf sabre/vobject, sabre/dav, rlanvin/php-rrule und FullCalendar. Das Vorgänger-Addon forcal stammt von Joachim Dörr und Friends Of REDAXO.

About

Kalender-Addon für REDAXO: RFC-5545-Wiederholungen, iCal, CalDAV, eigene Felder, Migration von forcal

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages