XTX Integration for Netatmo

Änderungsprotokoll

2.1.0

• Added: [naws_sparkline] — eine Kurve so groß wie ein Wort, neben der Zahl im Fließtext: die Rohmessungen der letzten Stunden oder eine Spalte der Tagesübersicht, Regen als Balken, das Band zwischen Tagestief und Tageshoch, eine Sprechblase mit Uhrzeit und Wert beim Überfahren. layout="tile" zeichnet sie als Karte mit Wert, Tief und Hoch, layout="month" als Block aus Tagesmitteln mit dem Regen pro Tag. Serverseitiges SVG, vollständig ohne JavaScript; acht Farben auf einem neuen Reiter im Erscheinungsbild, Sparkline.
• Added: [naws_sparkline_tiles] — die Sparkline-Karten als Raster, das von selbst umbricht: ab Werk Temperatur, Luftfeuchte, Luftdruck, Wind, Regen und CO2 (params, hours).
• Added: Sparklines im Seitenleisten-Widget. Ein Schalter unter Erscheinungsbild › Seitenleisten-Widget oder sparklines="1" am Shortcode fügt eine 24-Stunden-Kurve unter der Temperatur und fünf Kacheln für Luftfeuchte, Luftdruck, Wind, Regen und CO2 hinzu. Ab Werk aus.
• Changed: Die Farben der Vorhersage lassen sich auf einem neuen Reiter im Erscheinungsbild einstellen, Vorhersage; Texte, Rahmen und Kartenhintergrund folgen dem Basis-Theme. Die Reiter im Erscheinungsbild sind jetzt WordPress-Reiter, brechen auf schmalen Bildschirmen um und bleiben nach dem Speichern offen.
• Changed: Der REST-Endpunkt /daily liefert humidity_avg, wind_avg, co2_avg und noise_avg, wenn sie verlangt werden.
• Fix: Zahlen folgen der Sprache der Seite — „23,4 °C“ und „1.019,1 mbar“ auf einer deutschen Seite — im Widget, in den Tabellen, in Einzel- und Rechenwerten, in der Infoleiste, der Heatmap, den E-Mails und in Achsen und Sprechblasen der Diagramme.
• Fix: Die Heatmap färbt den heutigen Tag nicht mehr. Das laufende Mittel eines Tages, der noch nicht vorbei ist, sah aus wie ein fertiger Tag; die Zelle bekommt ihre Farbe jetzt am nächsten Tag.
• Fix: [naws_current] zeigt seine Symbole wieder statt ihres SVG-Quelltexts als Text.
• Fix: „11 Minuten ago“ — relative Zeitangaben sind jetzt übersetzbar („vor 11 Minuten“).

2.0.2

• Added: Aufbewahrung der Rohmessungen, schaltbar. Die Einstellungsseite versprach „alle Daten werden dauerhaft gespeichert“, während die Seitenleiste des Dashboards eine „Datenhaltung: 365″ zeigte, die nirgends galt. Die Aufbewahrung ist jetzt eine echte Funktion, in einem eigenen Abschnitt der Einstellungsseite und ab Werk aus: einschalten, eine Zahl von Tagen setzen (Vorgabe 365, nie unter 30), und einmal pro Nacht, nach der Tagesverdichtung, löscht das Plugin die Rohmessungen, die älter sind, und vermerkt den Lauf auf der Einstellungsseite und im Cron-Protokoll. Es gehen nur die Rohmessungen — die Zehn-Minuten-Werte hinter dem Live-Dashboard, [naws_table], [naws_chart], der Windrose und dem REST-Endpunkt readings. Die Tagestabelle bleibt unangetastet, Verlauf, Heatmap, Rekorde und Klimaindizes behalten ihren vollen Zeitraum. Das Einschalten und die Bereinigung von Hand fragen noch einmal nach und sagen, was verloren geht. Ein Update ändert nichts: der Schalter bleibt aus, bis du ihn einschaltest.
• Fix: Die Windkacheln des Live-Dashboards ignorierten jede Farbeinstellung. [naws_live] zeichnete Kompass, Zeiger und die Halbkreis-Skala für Wind und Böen mit festen Farben; die Farbe „Kompassnadel“ ging als Variable in die Seite, die nichts las, und für Wind und Böen gab es gar kein Feld. Die beiden Kacheln nehmen ihre Farben jetzt aus einem eigenen Reiter, Erscheinungsbild › Live-Dashboard: Wind — Hintergrund (Kompassfläche und leerer Teil der Skala), Kompass-Rose, Kompass-Zeiger (das alte Feld „Kompassnadel“, gleicher Schlüssel, ein gespeicherter Wert bleibt), Skala Wind, Skala Böen, Skala Tagesspitze der Böen — mit einer Vorschau aus dem echten Kompass und der echten Skala. Die Vorgaben sind die Farben, die das Dashboard schon immer verwendet hat.
• Fix: Die Windrose meldete „keine Windmessungen“ für einen Zeitraum mit Messungen — alle davon Windstille. Sie sagt jetzt „Die ganze Zeit Windstille: 20 Messungen, alle unter 1 km/h.“
• Fix: Die Übersetzerkommentare kamen nie in den Katalogen an; der Extraktor suchte sie innerhalb der Klammern des Aufrufs, wo WordPress sie nie hinschreibt. .pot und beide .po tragen sie jetzt.

2.0.1

• Fix: Die 24-Stunden-Regenmenge in der Regenkachel des Dashboards war viel zu niedrig. Die Kachel summiert die eigenen Rain-Messwerte der letzten 24 Stunden, weil Netatmos sum_rain_24 um Mitternacht auf null springt und die Kachel einen rollenden Tag verspricht. Der Regenmesser meldet aber alle fünf Minuten, jede Meldung trägt den Regen genau dieser fünf Minuten, und getstationsdata zeigt nur die neueste Meldung — ein Abruf alle zehn Minuten speicherte also jede zweite, und die Kachel zeigte 1,6 mm an einem Tag mit 3,9 mm; ein Abruf alle 30 oder 60 Minuten verlor noch mehr. Nach jedem Abruf holt das Plugin jetzt per getmeasure die Fünf-Minuten-Meldungen seit der letzten, die es hat, und speichert sie unter ihren eigenen Zeitstempeln; der erste Abruf nach dem Update schließt die letzten 24 Stunden in einem Aufruf. Eine trockene Stunde braucht keinen zusätzlichen Aufruf. Tages-, Monats- und Jahressummen waren nie betroffen — sie kommen aus Netatmos eigenem Tageszähler. Die Regenregel der E-Mail-Benachrichtigungen, die dieselbe rollende Summe nutzt, ist mit der Kachel korrigiert.
• Changed: [naws_live] zeigt keinen eigenen Vorhersage-Streifen mehr. Das Dashboard holte die Vorhersage selbst und rendert eine Kopie der Tageskarten, die [naws_forecast] zeigt, und auf einer Seite mit beiden Shortcodes stand die Vorhersage doppelt. Wer die Vorhersage unter dem Dashboard möchte, setzt [naws_forecast] darunter — dieselben Karten, dieselben Einstellungen. Die Einstellung „Vorhersagetage“ beschreibt sich jetzt als Vorgabe für [naws_forecast].
• Changed: Die Heatmap baut sich erst auf, wenn sie ins Bild kommt, nicht schon beim Laden der Seite. Auf einer Seite, auf der [naws_heatmap] unterhalb des sichtbaren Bereichs steht, war die Welle der Kacheln vorbei, bevor jemand hingescrollt hat. Die Kacheln bleiben jetzt verborgen, bis die Oberkante der Karte die Bildschirmmitte erreicht — oder bis die Seite bis zum Ende gescrollt ist, für eine Karte am Fuß einer kurzen Seite; dann läuft die Welle einmal. Wer reduzierte Bewegung wünscht, und der Druck, bekommt die Karte sofort; ohne JavaScript wird nichts verborgen.

2.0.0

• Added: E-Mail-Benachrichtigungen. Nach jedem Abruf prüft das Plugin bis zu dreizehn Regeln und verschickt bei jedem Zustandswechsel eine Mail — einmal, wenn er beginnt, und bei allen Regeln außer Regen einmal, wenn er vorbei ist; alle Wechsel eines Abrufs kommen in eine Mail. Sieben Regeln beobachten die Station: Batterie eines Moduls unter einem Prozentwert, schwache Funkverbindung eines Moduls, schlechtes WLAN der Basisstation, Basisstation meldet sich nicht bei Netatmo, Modul meldet sich nicht bei der Basisstation, drei gescheiterte Abrufe in Folge, verfallene Zugangsdaten. Sechs beobachten Wetter und Raumluft: Frost, Hitze, Böe über einer Schwelle, Regen der letzten 24 Stunden über einer Schwelle, Regenbeginn, CO₂ der Basisstation oder eines Innenmoduls über einer Schwelle. Funk, WLAN und die beiden Stille-Regeln warten eine Weile, bevor sie melden oder entwarnen; Frost und Böe warten eine Stunde unter der Schwelle bis zur Entwarnung; Regen entwarnt nicht. Alle Regeln sind bei Auslieferung aus, und ein Generalschalter setzt alle Mails aus, ohne die Regeln anzurühren. Die neue Seite XTX Netatmo → Benachrichtigungen enthält den Schalter, die Empfänger, die Regeln mit ihren Schwellen in deinen Einheiten, einen Testmail-Knopf und die letzten fünfzig Mails.
• Added: Die fünf Statusfelder, die Netatmo mit jedem Modul sendet, werden jetzt gespeichert (Schema 1.5): Batterie in Prozent, WLAN der Basisstation, ob ein Gerät erreichbar ist, wann die Basisstation zuletzt an Netatmo gemeldet hat und wann ein Modul zuletzt mit der Basisstation gesprochen hat. Die Modulseite zeigt Netatmos eigenen Batteriewert statt einer Schätzung aus der Spannung.
• Added: Zwei Aktionen für fremden Code — naws_sync_failed( $message, $consecutive_errors ) feuert bei jedem gescheiterten Abruf; naws_data_synced( $readings ) gab es schon und ist jetzt dokumentiert.
• Fix: Die Zeitraum-Knöpfe der Windrose wurden unter Hello Elementor rot, sobald die Maus darüber lag, und der aktive Knopf trug die Akzentfarbe „Primär“. Jede Regel für sie trägt jetzt zwei Klassen und setzt Ruhe-, Hover-, Fokus- und Aktivzustand selbst, und der aktive Knopf hat eine eigene Farbe — eine achte im Reiter „Windrose“ unter Erscheinungsbild.
• Fix: Erscheinungsbild: Speichern ohne Icon-Set in der Eingabe schreibt kein „Undefined array key“ mehr ins Log.

1.9.13

• Fix: [naws_records] und [naws_on_this_day] blieben auf einer Installation leer, deren Tagesübersicht eine andere Kollation trug als die Modultabelle. Die drei großen Abfragen verglichen module_id über zwei Tabellen hinweg; MySQL verweigert das, sobald die Kollationen abweichen, die Abfrage scheiterte, und das Plugin gab wortlos nichts zurück. Die aktiven Module wandern jetzt als ID-Liste aus PHP in jede Abfrage, kein Vergleich kreuzt mehr eine Tabelle — [naws_live], [naws_infobar] und der Verlauf werden genauso gelesen.
• Fix: Hat ein Block nichts zu zeigen, liest ein angemeldeter Redakteur im Block, warum — keine aktive Basisstation, keine Tageszeilen, eine gescheiterte Abfrage mit der Meldung der Datenbank, unbekannte Rekordnamen — und das Log bekommt eine Zeile. Besucher sehen, was sie vorher sahen. Ein unbekannter Name in records="…" wird mit einem Hinweis übersprungen, statt den ganzen Block zu leeren.
• Fix: Ein Modul unter Netatmo → Module ein- oder auszuschalten wirkt sofort im Frontend. Die Modulliste war eine Stunde zwischengespeichert, und nur das Backend las frisch.
• Fix: Attribute, die ein Seitenbaukasten mit HTML-Entities schreibt (value="dewpoint"), kommen wie gemeint beim Shortcode an; bisher wurden sie zu quotdewpointquot und fielen auf -- zurück. Alle fünfzehn Shortcodes dekodieren sie zuerst.
• Fix: Auf Android verkehrte Chromes automatisches Dunkeldesign Windrose und Sonnenbahn in schwarze Flächen. Die Blöcke deklarieren jetzt color-scheme: only light, was genau sie herausnimmt und die Seite in Ruhe lässt.

Ältere Versionen: der vollständige Changelog seit 1.0.0 liegt in CHANGELOG.md auf GitHub.