Kalender
Zeigt anstehende Termine – entweder aus einer Instanz des ioBroker-Adapters ical oder direkt von einer iCal-URL. Mehrere Quellen mit eigener Farbe und Name sind möglich. Wichtige Termine werden per Stichwort oder iCal-Priorität hervorgehoben.
Layouts
Default
Liste der nächsten Termine mit farbigem Punkt, Titel, Datum und Ort — für mittlere Zellen. Passen nicht alle Termine in die Zelle, scrollt die Liste.
Agenda
Kompakte Terminliste mit farbigem Balken je Quelle — für viele Termine auf wenig Platz. Scrollt wie Default. Die Kalendernamen bilden eine Spalte, damit alle Termin-Titel auf einer Kante beginnen — Breite per calNameWidth.
Card
Nur der nächste Termin groß als Karte mit Datum, Ort und „+N weitere" — für prominente Anzeige.
Compact
Eine Zeile mit Icon, nächstem Termin und Datum — für Listen.
Minimal
Nur die Anzahl der Termine als große Zahl zentriert — für sehr kleine Zellen.
Custom
Terminfelder frei in einer Zellenmatrix platzieren — siehe Custom-Layout und Custom-Layout: Felder. Startet auf Wunsch aus dem bisherigen Layout (Aus Layout übernehmen); dafür die Komponenten events-list, events-agenda, next-event (Karte), next-row (Kompakt), count (Minimal) und refresh.
Einstellungen
Alle Optionen werden im Editor unter Widget bearbeiten gesetzt.
Quellen
Kalender hinzufügen öffnet ein Formular mit zwei Quellarten:
| Quellart | |
|---|---|
| ical-Adapter | Liest die Tabelle einer vorhandenen ical.N-Instanz. Kein eigener Abruf, keine URL – Termine kommen live aus dem Adapter. Optional auf einen einzelnen Kalender der Instanz einschränken |
| iCal-URL | Das Widget ruft die .ics-URL selbst über den Aura-Adapter ab |
| Option | Standard | |
|---|---|---|
calendars | [] | Liste der Quellen |
calendars[].type | url | adapter · url |
calendars[].datapoint | — | adapter: Tabellen-Datenpunkt, z. B. ical.0.data.table |
calendars[].calFilter | — | adapter: nur Termine dieses Kalendernamens (leer = alle) |
calendars[].url | — | url: iCal-URL |
calendars[].name | — | Anzeigename; bei adapter leer = Kalendername aus dem Adapter |
calendars[].color | — | Farbe der Quelle |
calendars[].icon | — | Lucide-Icon dieser Quelle; leer = kein Icon |
calendars[].showName | true | Name dieser Quelle anzeigen |
Abruf
| Option | Standard | |
|---|---|---|
refreshInterval | 30 | Minuten zwischen Abrufen (0 = kein Auto-Refresh) |
maxEvents | 5 | maximale Anzahl angezeigter Termine (1–100) |
daysAhead | 14 | Vorschau-Zeitraum in Tagen |
refreshInterval gilt nur für url-Quellen; adapter-Quellen aktualisieren sich bei jeder Änderung der Tabelle. daysAhead kann bei adapter-Quellen nur so weit reichen wie der Vorschau-Zeitraum der ical-Instanz selbst.
Anzeige
| Option | Standard | |
|---|---|---|
showTitle | true | Titel anzeigen |
showIcon | true | Icon anzeigen |
icon | CalendarDays | Lucide-Icon |
iconSize | 20 | px |
titleAlign | left | left · center · right |
calFontScale | 1 | Schrift-Skalierung |
calNameWidth | 0 | Agenda: Breite der Kalender-Spalte in % der Zeile; 0 = automatisch (breitester sichtbarer Name, max. 45 %) |
showCalName | true | Kalendername anzeigen |
calNameAlways | false | Kalendername im Default-Layout auch bei nur einer Quelle; Agenda/Card/Compact zeigen ihn immer |
calNameAlign | left | left · center · right; wirkt, wo der Name eine eigene Zeile oder Spalte hat (Default, Card, Agenda mit festem calNameWidth) |
showCalIcon | true | Icon der Quelle anzeigen (nur Quellen mit icon) |
calIconSize | 0 | Größe des Kalender-Icons in px; 0 = Größe des Layouts (Default 12, Agenda/Card 11, Compact 13, Custom 20) |
showCalDot | true | Farbige Markierung vor dem Termin: Punkt (Default), Balken (Agenda). Card/Compact haben keine |
showWeek | false | Kalenderwoche anzeigen: Default/Agenda am ersten Termin der Woche, Card/Compact am angezeigten Termin |
showDate | true | Datum anzeigen |
showEndTime | false | Endzeit an das Datum anhängen (Morgen, 09:00 – 10:30); nur bei Terminen mit Uhrzeit, die am selben Tag enden |
showLocation | true | Ort anzeigen (Default/Card) |
showSummary | true | Termin-Titel anzeigen (Card) |
showMore | true | „+N weitere" anzeigen (Card) |
autoHeight | false | Höhe folgt dem Inhalt statt der eingestellten Zellenhöhe (nicht bei Custom); die eingestellte Höhe wird dann überschrieben — unter Darstellung |
CSS-Klassen
Für eigenes CSS unter Einstellungen › CSS & JS. Die Klassen sitzen genau auf dem jeweiligen Element, in allen Layouts.
| Klasse | |
|---|---|
.aura-cal-name | Kalendername |
.aura-cal-summary | Terminname |
.aura-cal-date | Datum / Uhrzeit |
.aura-cal-location | Ort |
.aura-cal-dot | Farbpunkt (Default); der nächste Termin zusätzlich [data-calendar-dot="next"] |
.aura-cal-bar | Farbbalken (Agenda) |
.aura-cal-source-icon | Icon der Kalenderquelle |
.aura-cal-week | Kalenderwoche |
.aura-cal-badge | Badge „läuft“ / „noch N T“ |
.aura-cal-more | „+N weitere“ (Card) |
.aura-cal-event | Terminzeile; zusätzlich .aura-cal-event-today bzw. .aura-cal-event-next |
Eine Terminzeile trägt außerdem [data-calendar-event] mit upcoming, today, next oder today,next, die KW [data-calendar-week] mit first oder repeat.
Mehrtägige Termine
| Option | Standard | |
|---|---|---|
multiDayDisplay | both | off · span (Start – Ende) · badge („läuft“ / „noch N T“) · both |
multiDaySplit | false | ein Eintrag je Tag statt einer Zeile für die ganze Laufzeit |
Bei multiDaySplit zählt jeder Tag einzeln gegen maxEvents, und das Badge nennt den Tag der Laufzeit („Tag 2/5“) statt der Restlaufzeit.
Custom-Layout: Felder
Jedes Feld gilt für einen Termin. Die Zellen-Konfiguration hat dafür ein Feld Termin: 1 ist der nächste Termin, 2 der darauf folgende usw. Der Schlüssel bekommt die Nummer angehängt (summary → summary2); eine Terminliste entsteht als eine Rasterzeile je Termin.
| Feld | |
|---|---|
summary | Terminname |
date | Datum / Zeit wie in der Liste („Morgen, 09:00“) |
time | Uhrzeit von |
endtime | Uhrzeit bis (leer bei ganztägigen Terminen) |
timespan | 09:00 – 10:30 |
calname | Kalendername |
location | Ort |
running | „läuft“ / „noch N T“ bzw. „Tag 2/5“ bei multiDaySplit |
week | Kalenderwoche als Zahl |
kw | KW 36 |
kwnew | KW 36, nur beim ersten Termin der Woche |
day · daycount | Tag der Laufzeit / Tage gesamt bei multiDaySplit |
count | Anzahl angezeigter Termine (gilt für das ganze Widget, ohne Nummer) |
| Komponente | |
|---|---|
icon | Widget-Icon |
cal-icon | Icon des Kalenders, aus dem der Termin stammt |
Mehr Termine als maxEvents gibt es nicht; Felder ohne Termin bleiben leer.
Hervorhebung
Färbt wichtige Termine und blendet optional ein Symbol ein.
| Option | Standard | |
|---|---|---|
highlightEnabled | true | Hervorhebung aktiv |
highlightPriority | true | iCal-PRIORITY 1–4 gilt als wichtig |
highlightKeywords | — | Stichwörter, kommagetrennt |
highlightColor | #f59e0b | Hervorhebungsfarbe |
importantOnly | false | nur wichtige Termine zeigen |
hideImportantIcon | false | Symbol ausblenden |
importantIcon | Star | Lucide-Icon für wichtige Termine |