# Kalender

Die Kalender-App setzen Sie ein, wenn eine Fläche die Termine eines bestehenden Kalenders zeigen soll — es genügt die ICS-Adresse des Abos, ein Konto wird nicht verbunden.

> **Typ:** app
> **Für wen:** alle, die Szenen gestalten und Termine auf einem Display zeigen wollen.
> **Voraussetzung:** Ihr Paket enthält die Pro-Apps, sonst steht im Store **Ab Pro**. Die App ist installiert. Sie dürfen Szenen bearbeiten. Die ICS-Adresse des Kalender-Abos liegt Ihnen vor.
> **Ort im Portal:** **Apps** › **Apps entdecken** › **Kalender**; nach der Installation im Szenen-Editor in der Palette unter **Nachrichten & Infos**.

## Was die App zeigt

Die App bringt ein Widget mit: **Kalender**. Es liest ein Kalender-Abo und zeigt die Termine der nächsten zwei Wochen — mit Titel, Zeit und, soweit hinterlegt, Ort. Wiederholungen, Ausnahmen und einzeln verschobene Termine sind dabei berücksichtigt.

Drei Darstellungen stehen zur Wahl:

- **Tagesliste** — Termine nach Tagen gruppiert, je Gruppe eine Überschrift (**Heute**, **Morgen**, sonst Wochentag mit Datum). Der heutige Tag steht in der Akzentfarbe, ein laufender Termin trägt einen Punkt.
- **Wochenraster** — sieben Spalten von Montag bis Sonntag. Ein Termin erscheint in jeder Spalte, die sein Zeitraum berührt. Das Raster zeigt immer eine ganze Woche.
- **Nächster Termin groß** — der Termin, um den es jetzt geht, in voller Größe mit Rest-Zeit darüber (**in 25 Min.**, **läuft seit 10 Min.**); darunter stehen bis zu drei folgende klein.

Auf der Seite der App im Store heißen die Darstellungen genauso. Beim Einfügen bietet der Editor drei Platzierungen an: **Vollbild**, **Seitenspalte** und **Breites Band**.

Für Flächen im Kundenbereich gibt es den diskreten Modus: Er ersetzt jeden Titel durch **Belegt** und lässt Orte weg, sodass nur die Belegung sichtbar bleibt.

Zwei Beispiele: Eine Praxis zeigt im Wartebereich die **Tagesliste** mit dem diskreten Modus — die Patienten sehen, wie voll der Tag ist, aber keine Namen. Ein Verein stellt im Foyer das **Wochenraster** mit den Belegungszeiten der Räume auf.

## Einstellungen

Die Einstellungen finden Sie im Reiter **Inhalt**, sobald das Widget ausgewählt ist. Sie sind in drei Abschnitte geteilt: **Kalender**, **Darstellung** und **Farben**. Felder, die in der gewählten Darstellung nichts bewirken, blendet der Editor aus; ihr Wert bleibt erhalten.

![Das Einstellungs-Fenster eines Kalender-Widgets im Szenen-Editor: die noch leere Kalender-Adresse (ICS) mit ihrem Hilfetext (1), die Zeitzone (2), der Schalter Diskret (3) sowie Darstellung und Zeitraum (4)](/docs/apps/bilder/9939616c-calendar-einstellungen.png)

| Einstellung | Bedeutung | Standard |
|---|---|---|
| **Kalender-Adresse (ICS)** | Die ICS-Adresse des Kalender-Abos, etwa `https://…/basic.ics`; auch `webcal://` wird angenommen. Nicht die Adresse aus der Adressleiste des Browsers. Wir lesen den Kalender nur und schreiben nie hinein. Höchstens 500 Zeichen. | leer |
| **Zeitzone** | Eine Suche über alle Zeitzonen, auf Deutsch oder Englisch, etwa „Berlin“ oder „Wien“. Der erste Eintrag **Zeitzone Ihrer Organisation** steht für deren Standard-Zeitzone. Bestimmt Uhrzeiten und Tagesgrenzen. | Berlin |
| **Diskret: Titel durch „Belegt“ ersetzen** | Ersetzt jeden Titel und lässt Orte weg. | Aus |
| **Darstellung** | **Tagesliste**, **Wochenraster** oder **Nächster Termin groß**. | Tagesliste |
| **Zeitraum** | **Heute**, **3 Tage** oder **Woche** — wie weit die Anzeige nach vorn schaut, gezählt ab dem nächsten Tag mit Terminen. Das Wochenraster zeigt immer eine ganze Woche. | 3 Tage |
| **Höchstzahl Termine** | 1 bis 30; gilt für **Tagesliste** und **Nächster Termin groß**. | 8 |
| **Akzent (heute, laufender Termin)** | Farbe für den heutigen Tag, den Randstrich und den laufenden Termin. | Blaugrün |
| **Textfarbe** | Die Schriftfarbe der Fläche. | Dunkelblau |
| **Hintergrund** | **Transparent** oder **Farbe**. Transparent lässt die Szene durchscheinen. | Transparent |
| **Hintergrundfarbe** | Nur bei **Farbe**: die Fläche. | Weiß |

## Grenzen

- *Nur lesen, nie schreiben.* Die App legt keine Termine an, ändert und löscht nichts. Ein Konto wird nicht verbunden, eine Freigabe nicht erteilt.
- *Nur Abo-Adressen.* Ein Kalender ohne Abo-Adresse lässt sich nicht einbinden. Behandeln Sie die Adresse wie ein Kennwort: Viele Abo-Adressen tragen einen Zugang im Pfad und öffnen den Kalender für jeden, der sie kennt.
- *Zwei Wochen nach vorn.* Angezeigt werden Termine von heute bis in vierzehn Tage. Laufende Termine bleiben stehen, abgelaufene fallen heraus.
- *Keine Beschreibungstexte.* Übertragen werden Titel, Zeit und Ort — mehr nicht. Zugangsdaten aus der Terminbeschreibung landen so nie auf einem Display.
- *Wiederholungsregeln teilweise.* Gelesen werden tägliche, wöchentliche, monatliche und jährliche Serien mit Intervall, Wochentagen ohne Ordnungszahl, festen Monatstagen sowie Ende nach Datum oder Anzahl. Alles Weitere — etwa „jeder letzte Freitag im Monat“ — wird nicht geraten: Dann erscheint nur der Basis-Termin.
- *Zeitzonen pragmatisch.* Übliche Zonennamen werden verstanden. Trägt das Abo einen unbekannten Namen, gilt die Zeit als UTC, und die Termine stehen um den Versatz verschoben.
- *Abruf alle 15 Minuten.* Der Takt ist fest und nicht einstellbar; ein Abo-Kalender ändert sich in der Größenordnung von Tagen. Alle Widgets desselben Abos teilen sich einen Abruf.
- *Den Abruf übernehmen wir, nicht das Display.* Höchstens 4 MiB je Abruf und zwölf Sekunden Zeitlimit.

## Typische Fehler

| Symptom | Bedeutung | Lösung |
|---|---|---|
| **Keine Kalender-Adresse** mit dem Zusatz, die ICS-Adresse einzutragen | Das Feld **Kalender-Adresse (ICS)** ist leer. | Im Reiter **Inhalt** die Abo-Adresse des Kalenders einfügen. |
| **Die Adresse liefert keinen Kalender. Bitte die ICS-Adresse des Abos verwenden.** | Die Adresse liefert eine Webseite, meist die Freigabe- oder Anmeldeseite. | Im Kalender-Programm die Abo- beziehungsweise ICS-Adresse kopieren, nicht die Adresse aus der Adressleiste. |
| **Die Kalender-Adresse ist keine gültige Web-Adresse.** | Die Eingabe ist keine Adresse. | Die Adresse vollständig kopieren, ohne Leerzeichen am Anfang oder Ende. |
| **Die Kalender-Adresse muss mit https:// beginnen.** | Die Adresse trägt ein nicht erlaubtes Übertragungsverfahren. | Eine Adresse mit `https://` verwenden; `webcal://` wird umgesetzt. |
| **Der Kalender-Server hat den Zugriff abgelehnt.** | Der Zugang der Abo-Adresse gilt nicht mehr. | Im Kalender-Programm eine neue Abo-Adresse erzeugen und eintragen. |
| **Der Kalender-Server hat nicht rechtzeitig geantwortet.** | Die Antwort kam nicht innerhalb von zwölf Sekunden. | Abwarten; hält es an, den Anbieter des Kalenders prüfen. |
| **Der Kalender ist zu groß für die Anzeige.** | Die Datei überschreitet 4 MiB, meist durch jahrelange Historie. | Einen eigenen Kalender nur für die Anzeige führen und abonnieren. |
| **Keine Termine im Zeitraum** | Der Abruf war erfolgreich, im gewählten Zeitraum steht nichts an. | **Zeitraum** auf **Woche** stellen oder das **Wochenraster** wählen. |
| Termine stehen eine Stunde daneben. | Im Feld **Zeitzone** steht eine andere Zone als die des Standorts, oder das Abo trägt einen unbekannten Zonennamen. | Im Feld **Zeitzone** die Zone des Standorts wählen. |
| Eine Serie zeigt nur einen einzigen Termin. | Die Wiederholungsregel wird nicht gelesen. | Die Serie im Kalender-Programm einfacher fassen, etwa als wöchentliche Wiederholung. |
| Auf der Fläche steht überall **Belegt**. | Der diskrete Modus ist eingeschaltet. | **Diskret: Titel durch „Belegt“ ersetzen** ausschalten. |
| Das Widget lässt sich nicht einsetzen. | Die App ist nicht installiert, ein Update wartet auf Ihre Entscheidung, oder sie steht auf **Nicht in Ihrem Paket**. | Unter **Apps** den Status prüfen ([Wenn eine App nicht läuft](/docs/apps/wenn-eine-app-nicht-laeuft)). |

## Weiterführendes

- [Widgets konfigurieren](/docs/inhalte/widgets-konfigurieren) — der Reiter **Inhalt** und die Vorschau im Editor.
- [Apps entdecken](/docs/apps/apps-entdecken) — Kategorien, Sammlungen und Filter im Store.
- [Tagesfenster, Mitternacht und Zeitzonen](/docs/programme/zeitfenster-und-zeitzonen) — woher die Zeitzone der Organisation kommt.