ioBroker.wochenplan

Wiederkehrende Wochenaufgaben abhaken: Düngung, Medikamente, Putzplan, Pflanzen gießen. Automatischer Reset Montag 00:00, ausgefallene Einträge werden rot markiert. Fertige Weboberfläche zum Einbinden in vis oder jarvis.

Installation

Der Adapter steht nicht im offiziellen ioBroker-Repository. Empfohlen ist der Weg über die Oberfläche, dann verhält er sich wie jeder andere Adapter.

Über die Oberfläche

Einmalig im Admin unter Einstellungen (Zahnrad) → Repositories eine Zeile anlegen und aktivieren:

| Feld | Wert | |------|------| | Name | Zengaja | | Link | https://raw.githubusercontent.com/Zengaja/ioBroker.wochenplan/main/sources-dist.json |

Danach Adapterliste neu laden. wochenplan steht jetzt in der Adapterliste und wird von dort installiert: Die Instanz wird automatisch angelegt, und neue Versionen erscheinen als gewohnter Update-Hinweis.

Über die Konsole

Auf dem ioBroker-Host als Benutzer iobroker genügt ein Befehl:

curl -fsSL https://raw.githubusercontent.com/Zengaja/ioBroker.wochenplan/main/install.sh | sh

Das Skript holt den Adapter, legt die Instanz an und lädt Weboberfläche und Widgets hoch. Beim Aktualisieren erkennt es eine vorhandene Instanz und legt keine zweite an. Dieselben Schritte einzeln:

iobroker url https://github.com/Zengaja/ioBroker.wochenplan
iobroker add wochenplan
iobroker upload wochenplan

Wer stattdessen im Admin über Adapter → Katzen-Icon → Reiter GitHub → Beliebig mit Zengaja/ioBroker.wochenplan installiert, muss die Instanz anschließend selbst über das + anlegen — bei einer GitHub-Installation macht ioBroker das absichtlich nicht.

Aktualisieren

Über die Oberfläche als normales Adapter-Update, über die Konsole durch erneutes Ausführen des Installationsskripts.

Konfiguration

Reiter Plan – Titel der Liste und eine Tabellenzeile je Eintrag:

| Feld | Bedeutung | |------|-----------| | ID | technischer Name für die Objekte (a-z, 0-9, _) | | Name | Anzeigename | | Zusatz | freier Hinweis, z. B. „morgens" | | Einheit | z. B. ml. Leer lassen bei Aufgaben ohne Menge | | Mo–So | Menge je Tag, 0 = an dem Tag nichts zu tun |

Aufgabe ohne Menge: Einheit leer lassen, an den fälligen Tagen 1 eintragen.

Reiter Verhalten – Bedienart (Häkchen setzen oder Eintrag antippen und durchstreichen), Uhrzeit des Tageswechsels, rote Markierung an/aus, Archiv der Vorwoche, vier Statusfarben.

Mehrere Listen: einfach mehrere Instanzen anlegen (wochenplan.0 Aquarium, wochenplan.1 Putzplan usw.).

vis-Widget (vis 1)

Die Widgets kommen mit dem Adapter mit; vis wird bei der Installation automatisch neu gestartet. Im vis-Editor einmal den Browser-Cache leeren (Strg+F5), dann erscheint im Widget-Auswahlfeld der Satz wochenplan mit zwei Widgets:

| Widget | Zweck | |--------|-------| | Wochenplan (ganze Woche) | alle sieben Tage, Spaltenzahl einstellbar | | Wochenplan (nur heute) | nur die heute fälligen Einträge |

Als Objekt-ID wird ein Datenpunkt eingetragen: wochenplan.0.info.json. Dort liegt der komplette Plan samt Status; das Widget baut sich daraus auf und schreibt beim Antippen direkt auf die jeweiligen Haken-Datenpunkte.

Widget-Attribute:

| Attribut | Wirkung | |----------|---------| | spalten | 1–7 Tage nebeneinander | | kompakt | ein Tag je Zeile: Tagname links, die Einträge des Tages daneben. Braucht etwa die halbe Höhe. Zusammen mit spalten = 1 ergibt das eine schmale Liste | | kopf | Titel der Liste anzeigen | | bilanz | Wochenmengen und Zahl der Ausfälle | | resetKnopf | Schaltfläche „Woche abschließen" |

Im kompakten Modus wird der Zusatz („morgens") ausgeblendet, weil er zu viel Breite kostet.

Ob Häkchen oder Durchstreichen angezeigt wird, kommt aus den Instanzeinstellungen und gilt für Widget und Weboberfläche gleichermaßen.

Weboberfläche

Wird vom web-Adapter ausgeliefert:

http://<ioBroker>:8082/wochenplan/?i=0

i ist die Instanznummer. In vis/jarvis über ein iframe-Widget einbinden oder direkt auf einem Tablet öffnen. Voraussetzung ist eine laufende web-Instanz (Port 8082). Ist dort Authentifizierung aktiv, muss man sich einmal anmelden.

Datenpunkte

wochenplan.0
  woche.<tag>.<eintrag>          Haken (boolean, schreibbar)
  woche.<tag>.<eintrag>_status   offen | erledigt | verpasst | nachgeholt | uebersprungen
  woche.<tag>.<eintrag>_farbe    Hex-Farbe zum Status (direkt in vis bindbar)
  woche.<tag>.<eintrag>_soll     Sollmenge des Tages
  heute.<eintrag>                hakt den heutigen Tag ab
  heute.<eintrag>_soll, heute.tag
  info.uebersicht                Textansicht der laufenden Woche
  info.vorwoche                  Bilanz der abgeschlossenen Woche
  info.verpasst, info.offen_heute
  info.<eintrag>_ist / _soll     Wochenmengen
  info.json                      Plan und Status als JSON (Basis von vis-Widget und Webseite)
  control.reset                  Button: Woche sofort abschließen

Logik

• Ein Tag gilt zur eingestellten Uhrzeit als abgelaufen. Fehlt der Haken, wird der Eintrag verpasst (rot).
• Nachträgliches Abhaken ergibt nachgeholt (orange) – der Ausfall bleibt sichtbar.
• Montag zur eingestellten Uhrzeit wird zuerst der Sonntag bewertet, dann die ganze Woche nach info.vorwoche geschrieben, danach zurückgesetzt.
• control.reset startet die Woche sofort neu; Tage davor gelten als uebersprungen und zählen nicht als Ausfall.

Entwicklung

Hinweise zu Tests und zum Veröffentlichen neuer Versionen stehen in ENTWICKLUNG.md.

Lizenz

MIT