Metainformationen zur Seite
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
plugins:caldav_4_lox:start [2022/09/10 15:42] – Michael Schlenstedt | plugins:caldav_4_lox:start [2024/03/19 05:56] (aktuell) – Struct-Daten geändert Michael Schlenstedt | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | ====== CalDAV-4-Lox | + | ====== CalDAV-4-Lox ====== |
- | Version History... | + | ++++ Version History...| |
**Version: 0.9.1** | **Version: 0.9.1** | ||
Zeile 50: | Zeile 50: | ||
* MQTT publishing bei installiertem MQTT-Gateway hinzugefügt | * MQTT publishing bei installiertem MQTT-Gateway hinzugefügt | ||
+ | ++++ | ||
---- | ---- | ||
Zeile 56: | Zeile 56: | ||
===== Konfigurationsoptionen ===== | ===== Konfigurationsoptionen ===== | ||
- | {{plugins: | + | {{plugins: |
- | + | ||
- | \\ | + | |
- | * Depth: Als einzige Einstellung lässt sich das Plugin mit dieser Option an den verwendeten CalDAV-Server anpassen. Einige Server erwarten für die Abfrage eine Abfragetiefe von 0, andere eine 1. Da neuere Server meistens Depth 1 verwenden ist dies als Standard hier eingestellt. Sollte trotz korrekter URL zum Kalender kein Termin gefunden werden, kann die Einstellung 0 hier zum Erfolg führen. | + | * '' |
===== Einrichtungshilfe ===== | ===== Einrichtungshilfe ===== | ||
Zeile 75: | Zeile 72: | ||
Wie funktioniert nun das Ganze? | Wie funktioniert nun das Ganze? | ||
- | Das Plugin so konzipiert, dass im Plugin selbst keine Einstellungen vorgenommen werden müssen. Alle Daten, die zum Abfragen des Kalenders benötigt werden, werden in der URL des HTTP-Einganges als Parameter angegeben. So ist es auch möglich verschiedene Kalender auf unterschiedlichen Servern abzufragen. | + | Das Plugin |
- | Solch eine URL sieht in etwas so aus: http: | + | Solch eine URL sieht in etwas so aus: |
+ | |||
+ | **'' | ||
Die einzelnen Angaben bedeuten folgendes: | Die einzelnen Angaben bedeuten folgendes: | ||
- | * http: | + | * '' |
- | * calURL - ist die URL des entsprechenden Kalenders so wie sie z.B. im Thunderbird/ | + | * '' |
- | * user - Euer Benutzername für den Kalender | + | * '' |
- | * pass - Euer Passwort für den Kalender | + | * '' |
- | * fwdays - da man keine Möglichkeit hat eine flexible Zeitspanne in die URL einzufügen, | + | * '' |
- | * delay (im Beispiel nicht benutzt) - ist die Anzahl der Minuten, die vor und nach der aktuellen Zeit nachgesehen wird. Wird der Parameter nicht angegeben, wird 60 bentzt. (Beispiel: ein Termin 14:30 - 15:00 Uhr im Kalender, wird zwischen 13:30Uhr und 16:00Uhr angezeigt wenn delay nicht angegeben wurde. | + | * '' |
- | * events - eine Liste der Terminnamen im Kalender, nach denen gesucht werden soll mit Pipe/ | + | * '' |
- | * cache (im Beispiel nicht benutzt) - ist die Anzahl der Minuten, die eine Google Kalenderabfrage auf dem LoxBerry zwischengespeichert und benutzt wird bis der Google Kalender erneut " | + | * '' |
Hier noch ein paar Infos für die Google Jünger: Eine richtige CalDAV Abfrage mit Username und Passwort ist gegen den Google Kalender nicht so einfach. Die Alternative dazu ist die Verwendung der Privatadresse des Kalenders - siehe [[https:// | Hier noch ein paar Infos für die Google Jünger: Eine richtige CalDAV Abfrage mit Username und Passwort ist gegen den Google Kalender nicht so einfach. Die Alternative dazu ist die Verwendung der Privatadresse des Kalenders - siehe [[https:// | ||
Zeile 94: | Zeile 93: | ||
Als Rückgabe erhält der virtuelle HTTP-Eingang Daten wie folgende: | Als Rückgabe erhält der virtuelle HTTP-Eingang Daten wie folgende: | ||
- | < | + | < |
{ | { | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
} | } | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
} | } | ||
- | </ | ||
- | |||
- | < | ||
" | " | ||
- | </ | ||
- | |||
- | < | ||
} | } | ||
</ | </ | ||
- | \\ | + | Das Ergebnis ist wird im JSON Format ausgegeben. Für jeden Suchbegriff gibt es ein Objekt. Gibt es zu dem Suchbegriff keine aktuellen Termin, so sind die Werte **-1** und Description **"" |
- | + | **//Description//** sind die Notizen zum Termin. Hier unterscheide ich z.B. welche Tonne abgeholt wird. **//fwDay//** ist der Tag in der Zukunft, an dem der Termin stattfindet. Rufst Du Montags ab und hast '' | |
- | Das Ergebnis ist dann im JSON Format. Für jeden Suchbegriff gibt es ein Objekt. Gibt es zu dem Suchbegriff keine aktuellen Termin, so sind die Werte -1 und Description | + | |
- | + | ||
- | Description | + | |
===== MQTT-Support ===== | ===== MQTT-Support ===== | ||
- | Mit Version 1.0.2 wurde der MQTT-Support eingefügt. Die MQTT Funktionalität bezieht sich in diesem Fall auf das Publizieren von Nachrichten. Für diese Funktion ist das installierte MQTT-Gateway Plugin von [[https:// | + | Mit Version 1.0.2 wurde der MQTT-Support eingefügt. Die MQTT Funktionalität bezieht sich in diesem Fall auf das Publizieren von Nachrichten. Für diese Funktion ist das installierte MQTT-Gateway Plugin von [[https:// |
- | Die verwendeten Topics folgen einem Schema. Das Topic beginnt mit '' | + | Die verwendeten Topics folgen einem Schema. Das Topic beginnt mit '' |
Einrichtung: | Einrichtung: | ||
Zeile 188: | Zeile 136: | ||
- Die Virtuellen Ausgangsbefehle auf eine Seite ziehen und einen Trigger anschließen (z.B. Stundenimpuls) | - Die Virtuellen Ausgangsbefehle auf eine Seite ziehen und einen Trigger anschließen (z.B. Stundenimpuls) | ||
- Im MQTT Gateway die " | - Im MQTT Gateway die " | ||
- | - Entsprechend [[plugins: | + | - Entsprechend [[konfiguration: |
Bitte beachten, dass das MQTT Gateway identische Daten nicht mehrfach an den Miniserver sendet (Cache). | Bitte beachten, dass das MQTT Gateway identische Daten nicht mehrfach an den Miniserver sendet (Cache). | ||
Zeile 202: | Zeile 150: | ||
===== Einrichtung eines iCloud Kalenders ===== | ===== Einrichtung eines iCloud Kalenders ===== | ||
- | Zuerst müsst ihr diese Anleitung abarbeiten: https:// | + | Zuerst müsst ihr diese Anleitung abarbeiten: |
- | (Arbeitszeit ca. 15 Minuten) | + | |
- | Apple arbeitet auch mit **Depth: | + | Apple arbeitet auch mit **Depth: |
- | \\ | + | |
- | Dann könnt ihr euren Link zu dem Kalender **URL des Kalenders: | + | |
- | **{{plugins: | + | {{plugins: |
===== Einrichtung eines Nextcloud Kalenders ===== | ===== Einrichtung eines Nextcloud Kalenders ===== | ||
- | Meldet euch in der Nextcloud an und öffnet euren Kalender. In der Kalender APP könnt ihr den Kalender über " | + | Meldet euch in der Nextcloud an und öffnet euren Kalender. In der Kalender APP könnt ihr den Kalender über " |
- | \\ | + | |
- | + | {{plugins: | |
- | {{plugins: | + | |
Den Wert " | Den Wert " | ||
Zeile 225: | Zeile 168: | ||
Die Felder " | Die Felder " | ||
- | {{plugins: | + | {{plugins: |
Wenn ihr nun auf " | Wenn ihr nun auf " | ||
- | {{plugins: | + | {{plugins: |
Die "**URL für den virtuellen HTTP-Eingang: | Die "**URL für den virtuellen HTTP-Eingang: | ||
- | {{plugins: | + | {{plugins: |
Den Abfragezyklus könnt ihr auf 86400 (ein Tag) einstellen. | Den Abfragezyklus könnt ihr auf 86400 (ein Tag) einstellen. | ||
Zeile 239: | Zeile 182: | ||
===== Einrichten eines Google Kalenders ===== | ===== Einrichten eines Google Kalenders ===== | ||
- | Depth: 1 | + | '' |
- | Auf https:// | + | Auf [[https:// |
User: und Passwort: leer lassen | User: und Passwort: leer lassen | ||
Zeile 254: | Zeile 197: | ||
===== Fehler melden ===== | ===== Fehler melden ===== | ||
- | |||
Fehlerberichte bitte direkt im [[https:// | Fehlerberichte bitte direkt im [[https:// | ||
- | |||
- | |||
- | |||
Zeile 266: | Zeile 205: | ||
pluginuebersicht.logo : : | pluginuebersicht.logo : : | ||
pluginuebersicht.status : STABLE | pluginuebersicht.status : STABLE | ||
- | pluginuebersicht.version : 1.0.2 | + | pluginuebersicht.version : 2.0.1.1 |
pluginuebersicht.min_lb_version : 1.2 | pluginuebersicht.min_lb_version : 1.2 | ||
- | pluginuebersicht.url_release : https:// | + | pluginuebersicht.url_release : https:// |
pluginuebersicht.url_prerelease : | pluginuebersicht.url_prerelease : | ||
pluginuebersicht.description : Das CalDAV Plugin bietet die Möglichkeit, | pluginuebersicht.description : Das CalDAV Plugin bietet die Möglichkeit, |