XTX Integration for Netatmo -- WordPress 插件

开发者	xylaender
更新时间	2026年9月12日 18:18
PHP版本:	8.0 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

XTX Integration for Netatmo connects your Netatmo hardware to WordPress. It reads all sensor data via the official Netatmo API, stores readings in your local database and displays them with beautiful live dashboards, animated charts and weather forecasts. Key Features

Full Netatmo Integration – OAuth2 authentication, automatic sync, all module types supported (Base, Outdoor, Wind, Rain, Indoor)
Live Dashboard – Real-time sensor cards with animated counters, 24h trend charts, pressure trend indicator, wind compass, CO2 air quality levels
Astronomy – Sunrise/sunset, moon phase with illumination, next full moon
Derived Weather Data – Feels-like temperature, heat index, dew point, wind chill
Historical Charts – Year-over-year comparison for temperature, pressure and rainfall with interactive legend
Weather Forecast – 5-day forecast based on station coordinates via Open-Meteo or Yr.no
REST API – Read-only JSON API with key authentication and rate limiting for external tools (Google Charts, Grafana, etc.)
Encrypted Storage – All credentials (OAuth tokens, client secret, API keys) are AES-256-GCM encrypted at rest
Configurable Units – C/F, mm/inch, mbar/inHg/mmHg, km/h/m/s/mph/kn
Multilingual – Full German, English and Norwegian interface
15 Shortcodes – Dashboard, current readings, infobar, single value, computed value, history charts, heatmap, records, this day in earlier years, sun path, wind rose, forecast, table, widget, weather icon
Export / Import – Full backup and restore of weather data, modules and settings
E-Mail Notifications – battery, radio and Wi-Fi, station offline, failed syncs, frost, heat, gusts, rain, rain starting, CO₂; per-rule thresholds, one mail per state change and an all-clear when the state ends, and a master switch
Mobile-First Responsive – All views optimized for smartphones, tablets and desktops
130+ Configurable Colors – Full appearance customization with live preview
4 Icon Sets – Emoji, Outline, Filled, Minimal with per-sensor color control

Supported Modules

NAMain – Base Station (Temperature, Humidity, CO2, Noise, Pressure)
NAModule1 – Outdoor (Temperature, Humidity)
NAModule2 – Wind (Speed, Direction, Gusts)
NAModule3 – Rain Gauge (Hourly, Daily, Rolling 24h)
NAModule4 – Additional Indoor (Temperature, Humidity, CO2)

Shortcodes

[naws_live] – Live sensor tiles with 24h trend charts and forecast
[naws_current] – Current readings of one or all modules as tiles or a list (module_id, parameters, layout, title)
[naws_infobar] – Astronomy bar with sunrise, moon phase, felt temperature
[naws_value] – Single inline sensor value
[naws_calc] – Single computed value (dew point, felt temperature, sunrise, moon phase, …); full list on the Shortcodes page in the backend
[naws_history] – Year-over-year comparison charts (supports year parameter)
[naws_heatmap] – One year of outdoor daily average temperature as a calendar grid, one tile per day, with a year selector (year, title, legend)
[naws_records] – Fifteen records from the daily summary with their dates, as tiles or a table (year, records, layout, title)
[naws_on_this_day] – This calendar day in every earlier year, with the day's records marked (date, title)
[naws_sunpath] – The sun on its arc over the station, with sunrise, solar noon, sunset and the day length (title)
[naws_windrose] – Where the wind comes from and how hard, as a rose of 16 or 8 directions stacked by Beaufort class, with a period switcher (period, from, to, measure, sectors, show, switcher, size, title)
[naws_forecast] – Multi-day weather forecast
[naws_table] – Readings as a table over a period, grouped by hour, day, week, month or year (module_id, parameters, period, limit, group_by, title)
[naws_weather_widget] – Compact forecast widget for a sidebar (days 3 or 5, width 250–500, scheme light, dark or transparent)
[naws_weather_icon] – Just the animated icon for the current weather state (size); renders nothing when the state is unknown

2.0.0

Added: e-mail notifications. After every fetch the plugin checks up to thirteen rules and mails every change of state — once when it begins and, for every rule but rain, once when it is over; all changes of one fetch go into one mail. Seven rules watch the station: battery of a module below a percentage, weak radio link of a module, poor Wi-Fi of the base station, base station not reporting to Netatmo, module not reporting to the base station, three failed fetches in a row, expired credentials. Six watch the weather and the indoor air: frost, heat, a gust above a threshold, rain of the last 24 hours above a threshold, rain starting, CO₂ of the base station or an indoor module above a threshold. Radio, Wi-Fi and the two silence rules hold for a while before they speak or clear; frost and gust wait an hour below the threshold before the all-clear; rain sends no all-clear. All rules ship switched off, and a master switch pauses every mail without touching the rules. The new page XTX Netatmo → Notifications holds the switch, the recipients, the rules with their thresholds in your units, a test-mail button and the last fifty mails.
Added: the five status fields Netatmo sends with every module are stored now (schema 1.5): battery percentage, Wi-Fi of the base station, whether a device is reachable, when the base station last reported to Netatmo and when a module last spoke to the base station. The Modules page shows Netatmo's own battery percentage instead of an estimate from the voltage.
Added: two actions for other code — naws_sync_failed( $message, $consecutive_errors ) fires wherever a fetch fails; naws_data_synced( $readings ) existed before and is documented now.
Fix: the wind rose's period buttons turned red under the mouse on Hello Elementor and took the "primary" accent colour when active. Every rule for them now carries two classes and sets rest, hover, focus and active state itself, and the active button has its own colour — an eighth one on the Wind Rose tab under Appearance.
Fix: Appearance: saving without the icon set in the input no longer logs "Undefined array key".

1.9.13

Fix: [naws_records] and [naws_on_this_day] stayed empty on an installation whose daily summary table carried a different collation than the modules table. The three big queries compared module_id across two tables; MySQL refuses that as soon as the collations differ, the query failed, and the plugin returned nothing without a word. The active modules now go into every query as an id list from PHP, so no comparison crosses a table any more — [naws_live], [naws_infobar] and the history are read the same way.
Fix: when a block has nothing to show, an editor who is logged in reads why in the block — no active base station, no daily rows, a failed query with the database's own message, unknown record names — and the log gets a line. Visitors see what they saw before. An unknown name in records="…" is skipped with a note instead of emptying the whole block.
Fix: switching a module on or off under Netatmo → Modules reaches the front end at once. The module list was cached for an hour, and only the admin read fresh.
Fix: attributes that a page builder writes with HTML entities (value="dewpoint") reach the shortcode as intended; they used to arrive as quotdewpointquot and fall back to --. All fifteen shortcodes decode them first.
Fix: on Android, Chrome's automatic dark theme inverted the wind rose and the sun's arc into black shapes. The blocks declare color-scheme: only light now, which takes exactly them out of that and leaves the page alone.

1.9.12

Added: [naws_windrose] — where the wind comes from, how often, and how hard: one ray per compass direction (16 or 8), its length the share of readings from there, stacked by Beaufort class from the centre outwards, calm in the hub. Below it the main directions, mean, peak and calm share, a legend, and a table for screen readers. Built from the raw ten-minute readings with one grouped query per period, cached as a transient. period (7d, 30d, 90d, year, all), from/to for a fixed range, measure (wind, gust, both), sectors, show, switcher, size, title. Every period of the switcher is rendered on the server; the script only swaps panels and dresses the tooltips. Seven colours on a new Appearance tab.
Added: the "Wind & Gusts" card of [naws_live] shows the day's strongest gust as a third value, in the configured wind unit, and the gauge gets a third, red needle for it.
Fix: the compass directions are translated. The forecast in [naws_live] and [naws_forecast] showed a German visitor "ESE" where "OSO" belongs; the sixteen codes go through gettext now, in German and Norwegian.
Fix: the frontend stylesheet and scripts carry the file's modification time in their version, so a changed file is fetched even when the plugin version stays the same — the admin assets have done this since 1.9.7.
Changed: this readme carries only the five most recent versions of the changelog; the full history since 1.0.0 lives in CHANGELOG.md on GitHub.

1.9.11

Added: [naws_records] — fifteen records from the daily summary, each with its date: hottest day, coldest night, warmest night, coldest day, largest daily range, warmest and coldest month, wettest day and month, longest dry and wet spell, strongest gust, longest frost period, longest heat wave and longest run of summer days. As tiles or a table, since the first day with readings or for one year (year="2025"), a subset with records="…". A tie goes to the earlier date, a month needs twenty days to compete, and a gap in the data breaks a run rather than bridging it.
Added: [naws_on_this_day] — this calendar day in every earlier year: low, high, mean and rain, newest year first, with the day's record marked in each column. The running year is left out.
Added: [naws_sunpath] — the sun on its arc over the station as an inline SVG: sunrise, solar noon and sunset, the part of the day already travelled, and the sun where it stands; at night below the horizon. Under it the day length, the change since yesterday and the year's longest and shortest day at the station's latitude. No script — a page cache shows the sun where it stood when the cache was filled.
Added: a colour scheme for the sidebar widget. [naws_weather_widget] was a white card whatever the sidebar looked like. It now has light, dark and transparent — the last draws no card at all and takes the sidebar's own colours. Chosen under Appearance → Sidebar widget, where the preview shows it on a dark ground, or per placement with scheme="dark".
Fix: the purge button under Settings → Manual Data Purge did nothing, and every admin page of the plugin threw "$ is not a function". Since 1.6.4 two handlers in admin.js stood behind the line that closes the jQuery block. The purge button works again, and its messages are translated instead of German literals in the script.
Fix: the bundled catalogue builder now writes plural forms, so "1 day / 2 days" reads right in German and Norwegian. Both bundled catalogues are complete at 735 strings.

1.9.10

Added: [naws_heatmap] — a year of outdoor daily mean temperatures as a calendar grid: twelve rows of months, thirty-one columns of days, one coloured tile per day, and a row of buttons to page through the years. What a curve makes you read, a grid lets you see: the cold fortnight in February and the hot week in July are shapes on the page rather than wiggles on a line. It reads the daily averages the annual chart already uses, so there is nothing to import. The ten colour stops are settings under Appearance → Heatmap Scale, values between two stops are interpolated, and they are anchored in Celsius even when the display is set to Fahrenheit, because the colour comes from the stored value and the tooltip from the unit you chose. Where a day has no stored average but does have a minimum and a maximum, the tile shows the mean of the two and its tooltip says so. The grid is a table rather than a drawing: the month column stays put while the days scroll sideways on a phone, colours are rendered on the server so the map is complete without JavaScript, and a screen reader reads "March, 14th, 8.2 °C" instead of "image". Attributes: year, title, legend.
Changed: the MAC addresses of your modules are no longer written into public pages. A module id in this plugin is the hardware address of a Netatmo module, and until now it travelled into every page carrying [naws_live] or [naws_history] — in the data block, on every chart configuration, in the data-module4, data-indoor and data-outdoor attributes — and it came back out with every request the dashboard made, whose reply carried the base station's address on every one of its thirty-odd readings as well. What travels now is a public reference: outdoor, indoor, wind, rain and in-<name>, resolved back on the server. Pages cached from before the update and the documented NAWS_Chart JavaScript interface both keep working.
Fix: the two language files 1.9.9 shipped were never read. German and Norwegian travelled along as .mo files so that an installation with a German interface would not find an English one the day the update arrived — but WordPress refused both, because the address of the hash table in the file header was wrong. A refused catalogue produces no warning, no log line and no visible difference except that everything stays English. Norwegian, which has no language pack yet, therefore read English throughout 1.9.9.
Fix: fourteen German and thirteen Norwegian strings had lost their translation in 1.9.9. The table columns from 1.9.8 — time, module, parameter, average — and the card-order screen came through the migration empty, so a German reader without a language pack saw English column headings in a German interface. The texts were taken from the 1.9.8 language files rather than written afresh, so nothing changed wording that a reader had already got used to.
Fix: three sentences in the chart script were German whatever language WordPress was set to — the chart that failed to render, the period with no readings, the request that came back with an error code. They sat in the JavaScript as literals, which the move to gettext in 1.9.9 never reached.
Fix: [naws_table] printed a MAC address in its module column when the reading's module was no longer in the modules table. Readings outlive the module they came from, so this was reachable rather than theoretical. The cell stays empty now, the way the chart legend does.
Fix: a chart request that left out group_by wrote a PHP notice into the log. The plugin's own scripts always send it; anything else calling the endpoint did not have to. Older versions: the complete changelog since 1.0.0 is kept in CHANGELOG.md on GitHub.

XTX Integration for Netatmo

标签

下载

详情介绍:

安装:

屏幕截图:

升级注意事项:

常见问题:

更新日志: