Docs
Docs
Allesda
DE | EN
Plugins
Allesda
DE | EN
Plugins

KALENDER

Dokumentation
Zurück

KALENDER

Wofür ist das?

Das KALENDER-Plugin zeigt die Termine Ihrer Mandanten-Daten (in der Regel Verträge) als Kalender und kann die Termine als ICS-Datei für externe Kalender-Programme exportieren (Outlook, Apple Kalender, Google Kalender …).

Es gibt zwei Spielarten:
1. Internes Kalender-View (/kalender) – schnelle Übersicht im Browser.
2. ICS-Abo / Datei – Termine in einen externen Kalender abonnieren oder als Datei einbinden.

> Das Plugin braucht keine eigene Datenbank-Tabelle – es liest direkt aus den Verträgen. Voraussetzung ist also ein aktives VERTRAG-Plugin.

Typische Aufgaben (Alltag)

  • Kalenderansicht öffnen
  • ICS-Einstellungen (Sichtbarkeit, Felder) konfigurieren
  • ICS-Datei generieren / aktuell halten (manuell oder automatisch)
  • ICS-Link an Mitarbeiter geben, damit Outlook/Apple/Google die Termine zieht

Schritt-für-Schritt

1) Kalenderansicht

1. Kalender im Menü öffnen (/kalender).
2. Verträge erscheinen je nach Zeitraum als Termine.

2) ICS-Einstellungen

1. Admin → Kalender → ICS (/settings/admin/kalender/ics).
2. Konfigurieren Sie:

  • welche Verträge in den ICS-Export sollen (z.B. nur abgeschlossene, alle, bestimmter Status)
  • welche Felder im Termin-Titel/-Body stehen
  • Zeitfenster (z.B. nur die letzten 12 Monate / nächste 12 Monate)

3. Vorschau über /settings/admin/kalender/ics/preview.
4. Speichern (POST /settings/admin/kalender/ics).

3) ICS-Datei generieren

  • Manuell: POST /kalender/generate-ics.
  • Automatisch: über AUTOMATE läuft regelmäßig ein Task, der die ICS-Datei aktualisiert.

4) ICS in externen Kalender einbinden

1. Den ICS-Link kopieren (Form: /ical/<dateiname>.ics).
2. Im externen Kalender als „Kalender-Abo“ oder „Internetkalender hinzufügen“ einfügen.
3. Outlook / Apple / Google aktualisieren die Termine periodisch automatisch.

> Bei Apple-/Google-Kalendern dauert die Aktualisierung gelegentlich mehrere Stunden – das ist normal.

5) Termine korrigieren

Termine kommen aus den Verträgen. Wenn ein Termin im Kalender falsch ist, korrigieren Sie ihn am Vertrag (Plugin VERTRAG), nicht am Kalender.

Häufige Fragen / Probleme

„Im externen Kalender erscheint nichts“

  • Stimmt die ICS-URL?
  • Liefert /ical/... etwas (im Browser öffnen)?
  • Im externen Kalender Aktualisierung erzwingen.

„Es taucht ein alter Termin auf, den es längst nicht mehr gibt“

  • Verträge soft-gelöscht? Eventuell noch im ICS bis zur nächsten Generation.
  • Über die ICS-Einstellungen Filter prüfen.

„Termin-Titel ist nichtssagend“

  • ICS-Einstellungen → Titel-Feldformat anpassen.

Technische URLs (Kurzreferenz)

Nutzerbereich:

  • GET /kalender – Kalenderansicht
  • POST /kalender/generate-ics – ICS jetzt erzeugen
  • GET /ical/{filename:.+} – ICS-Datei abrufen (öffentlich, sofern aktiv)

Admin:

  • GET /settings/admin/kalender/ics
  • GET /settings/admin/kalender/ics/preview
  • POST /settings/admin/kalender/ics

Hinweise

  • Der ICS-Endpoint wird oft ohne Login aufgerufen, damit externe Kalender-Apps zugreifen können. Behandeln Sie den Link daher wie ein „kleines Geheimnis“.
  • KALENDER funktioniert nur mit aktivem VERTRAG-Plugin.
  • Für regelmäßige Aktualisierung empfiehlt sich der zugehörige AUTOMATE-Task.