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

KALENDER

Documentation
Back

KALENDER

What is this for?

The KALENDER plugin shows the appointments from your tenant data (typically Contracts) as a calendar and can export them as an ICS file for external calendar applications (Outlook, Apple Calendar, Google Calendar, and so on).

There are two flavors:
1. Internal calendar view (/kalender) – a quick overview in the browser.
2. ICS subscription / file – subscribe to the appointments in an external calendar or embed them as a file.

> The plugin needs no database table of its own – it reads directly from the contracts. An active VERTRAG plugin is therefore required.

Typical day-to-day tasks

  • Open the calendar view
  • Configure the ICS settings (visibility, fields)
  • Generate / refresh the ICS file (manually or automatically)
  • Share the ICS link with staff so Outlook/Apple/Google can pull the appointments

Step by step

1) Calendar view

1. Open Calendar in the menu (/kalender).
2. Contracts appear as appointments according to their date range.

2) ICS settings

1. Admin → Calendar → ICS (/settings/admin/kalender/ics).
2. Configure:

  • which contracts should be included in the ICS export (for example, only completed ones, all of them, or a specific status)
  • which fields appear in the appointment title/body
  • the time window (for example, only the past 12 months / the next 12 months)

3. Preview via /settings/admin/kalender/ics/preview.
4. Save (POST /settings/admin/kalender/ics).

3) Generate the ICS file

  • Manually: POST /kalender/generate-ics.
  • Automatically: a scheduled task in AUTOMATE refreshes the ICS file regularly.

4) Subscribe in an external calendar

1. Copy the ICS link (format: /ical/<filename>.ics).
2. Add it in the external calendar as a "calendar subscription" or "Add internet calendar".
3. Outlook / Apple / Google will refresh the appointments periodically on their own.

> With Apple and Google calendars the refresh sometimes takes several hours – that is normal.

5) Correcting appointments

Appointments come from the contracts. If an appointment is wrong in the calendar, fix it on the contract (the VERTRAG plugin), not on the calendar.

Common questions / problems

"Nothing shows up in the external calendar"

  • Is the ICS URL correct?
  • Does /ical/... return something (try opening it in the browser)?
  • Force a refresh in the external calendar.

"An old appointment that no longer exists keeps showing up"

  • Are the contracts soft-deleted? They may still be in the ICS until the next generation.
  • Check the filters in the ICS settings.

"The appointment title is meaningless"

  • ICS settings → adjust the title field format.

Technical URLs (quick reference)

User area:

  • GET /kalender – calendar view
  • POST /kalender/generate-ics – generate the ICS now
  • GET /ical/{filename:.+} – fetch the ICS file (public, when active)

Admin:

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

Notes

  • The ICS endpoint is often called without login so that external calendar apps can access it. Treat the link as a "small secret".
  • KALENDER only works with the VERTRAG plugin enabled.
  • For regular updates, we recommend the matching AUTOMATE task.