XTX Integration for Netatmo
| 开发者 | xylaender |
|---|---|
| 更新时间 | 2026年11月13日 22:27 |
| 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), with your own display name for each module
- 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 and supermoon (computed after Meeus), next lunar eclipse
- 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
- 20 Shortcodes – Dashboard, current readings, infobar, single value, computed value, sparkline, sparkline tiles, history charts, heatmap, records, this day in earlier years, month review, module comparison, sun path, wind rose, forecast, rain radar, table, widget, weather icon
- Nothing from other servers in the visitor's browser – charts, symbols, radar images, map tiles and fonts all come from your own site
- 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
- 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)
[naws_live]– Live sensor tiles with 24h trend charts and wind rose[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 (supportsyearparameter)[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_month_review]– A month in review: temperature, rain and gust against the same month in earlier years, with a headline for what stands out; visitors page through the months without reloading (month,years,title)[naws_compare]– Two daily series from any modules in one chart over months and years, e.g. indoor against outdoor humidity; a second unit gets its own axis. A builder on the Shortcodes page writes the shortcode (a,b,from,to,months,title,height)[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_sparkline]– A curve the size of a word: the raw readings of the last hours or a column of the daily summary, rain as bars, the band between daily low and high, time and value on hover; as a card or a month block too (param,hours,days,module,width,height,show,type,band,layout,title)[naws_sparkline_tiles]– The sparkline cards side by side in a grid that wraps by itself: temperature, humidity, pressure, wind, rain and CO2 by default (params,hours)[naws_forecast]– Multi-day weather forecast[naws_radar]– Animated rain radar around the station: Deutscher Wetterdienst in Germany (last hour plus two-hour nowcast), RainViewer elsewhere, on a grey OpenStreetMap map. Images are fetched by your server and served from your site (width,height,km,source). Must be switched on under Settings → Rain radar.[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 (days3 or 5,width250–500,schemelight, dark or transparent,sparklines0 or 1)[naws_weather_icon]– Just the animated icon for the current weather state (size); renders nothing when the state is unknown
安装:
- Upload the
xtx-integration-for-netatmofolder to/wp-content/plugins/ - Activate the plugin in WordPress Admin > Plugins
- Go to XTX Netatmo > Settings
- Create a Netatmo developer app at dev.netatmo.com
- Enter your Client ID and Client Secret
- Set the Redirect URI in your Netatmo app to:
https://yoursite.com/wp-admin/admin.php?page=naws-settings - Click "Connect to Netatmo" and authorize
- Data syncs automatically – add shortcodes to any page
屏幕截图:
常见问题:
How do I get Netatmo API credentials?
Visit dev.netatmo.com, log in with your Netatmo account, create a new application and copy the Client ID and Client Secret.
How often does data update?
Netatmo sensors transmit every 5 minutes. The plugin sync interval is configurable (5–1440 minutes). Night mode reduces polling between 23:00–06:00.
Can I import historical data?
Yes. The plugin includes a chunk-based historical importer that fetches data from the Netatmo getmeasure API without hitting rate limits.
Is the REST API secure?
Yes. Every endpoint is read-only, rate-limited, and requires an API key generated in the admin panel. The key is accepted in the X-NAWS-Key header only — never as a query parameter, so it cannot end up in access logs, the Referer header, browser history or a proxy along the way.
Are my Netatmo credentials safe?
All sensitive data (OAuth tokens, client ID, client secret, API keys) is encrypted with AES-256-GCM before being stored in the database.
Can I customize the appearance?
Yes. The Appearance page offers 130+ configurable colors with live preview, 4 icon sets, per-sensor colors, chart theming and year comparison palettes.
Can I back up my weather data?
Yes. The Export/Import feature lets you download weather data, module configs and all settings as JSON. Ideal for migrating to a new WordPress installation.
Which forecast providers are supported?
Open-Meteo (global, default) and Yr.no / MET Norway (optimized for Northern Europe). Both are free and require no API key.
I don't receive notification e-mails
Open XTX Netatmo → Notifications and press "Send test mail". If the page reports that the mail could not be sent, your server sends no mail at all: an SMTP plugin or your hosting provider fixes that, not the plugin. If the test mail arrives but no notifications do, check that the master switch and the rule are switched on and look at the log on the same page. Notifications go out only when a state changes; a battery that has been low since before you switched the rule on is reported at the next fetch, not again afterwards.
更新日志:
2.2.0
- Added:
[naws_month_review]— a month in review: mean, highest and lowest temperature, rain and the strongest gust, each against the same month in earlier years, with a headline for what stands out. Visitors page through the months without reloading. - Added:
[naws_compare]— two daily series from any modules in one chart over months and years, e.g. indoor against outdoor humidity. A builder on the Shortcodes page writes the shortcode and shows a live preview. - Changed: the plugin's own pictograms instead of emoji on the site, the same on every device. WordPress no longer fetches emoji images from s.w.org for them, so nothing reaches another server from the visitor's browser.
- Fix: Yr.no forecast — rain of the first two or three days was about six times too high, the last day repeated the day before, and the precipitation probability showed a fixed 0 % (MET Norway gives one only for the Nordic countries; without it no figure is shown).
- Fix: moon — the supermoon date was off and lunar eclipses were misclassified; full moons are now computed after Meeus and eclipses come from NASA's canon.
- Fix: the wind card's compass points are translated,
[naws_table]grouped by day shows seven calendar days in local time in a stable order,[naws_current]shows its values without JavaScript, and SVG symbols keep their viewBox.
- Added: display names for modules. Type a name under a module on the Modules page and it replaces the Netatmo name everywhere — the cards, badges and chart titles of
[naws_live],[naws_current],[naws_table], the admin pages and the e-mail notifications;[naws_current]then shows only that name, without the type badge. An empty field keeps the Netatmo name. The REST API addsdisplay_namebesidemodule_name. - Fix:
GET /naws/v1/modulesfailed with HTTP 500 on every call. - Fix: switching a module off on the Modules page did not grey out its row until the page was reloaded.
- Changed: the charts of
[naws_live]and[naws_history]and the cards of[naws_current]and[naws_live]build up when the visitor scrolls to them, not while the page loads out of sight. The curve rises from the floor as a soft wave and the chart fades in; the cards ease in. With reduced motion switched on in the system, everything is there at once. - Fix: the legend of
[naws_radar]showed RainViewer's colours on the DWD map. With DWD as the source it now runs from cyan through green, yellow and orange to red, like the map.
- Security: the public chart endpoints took repeated fields — a single visitor request could build hundreds of megabytes and run PHP out of memory, the starting point of CVE-2026-109618/109619 ("PHP2Shell"). Repeats are dropped and unknown fields refused; the daily-data endpoint is for logged-in users only and no longer stores a cache entry for every date pair it is sent. The fix in PHP itself comes from your host: PHP 8.2.35, 8.3.36, 8.4.27, 8.5.12 or a build with the backport.
- Fix: the hourly rain chart showed rain half an hour late. Each bar is now the sum of the rain gauge's reports in that hour; the bars of a day add up to the 24-hour total.
- Fix: grouped rain in
[naws_table]and the REST API was a twelfth of what fell — it is a sum now, not an average. - Fix: the y-axis of the rain chart repeated its labels (0, 0.1, 0.1, 0.2); the steps are at least 0.1 mm now.
- Added: Cron Log › Error Log — the errors and warnings the plugin has always collected (database, Netatmo connection, weather services), which no page showed; the dashboard only counted them. A button clears the log, and the error count on the dashboard links to it.
- Added: Cron Log › Support Report — plugin, WordPress, PHP and database versions, whether the plugin tables exist, the cron state and the newest log entries, with a "Copy report" button for support requests. It contains no passwords, tokens or API keys.
- Fix: a sync whose data the database refused reported "Sync OK – 0 readings saved". It now fails with the database's own message, in the cron log, on the "Sync now" button and for the e-mail notification on failed syncs. An account without a weather station gets its own message instead of "Sync OK".
- Fix: "Sync now" fetched twice and showed the next run on the second of the last one; the next fetch now follows one interval later, and manual syncs appear in the cron log. An overdue next run reads "overdue by …" instead of "in …". Older versions: the complete changelog since 1.0.0 is kept in CHANGELOG.md on GitHub.