Title: IoT Data Widget Author: wpveloxa Published: octubre 5, 2026 Last modified: octubre 12, 2026 --- Search plugins ![](https://ps.w.org/iot-data-widget/assets/banner-772x250.png?rev=3728391) ![](https://ps.w.org/iot-data-widget/assets/icon-256x256.png?rev=3728391) # IoT Data Widget By [wpveloxa](https://profiles.wordpress.org/wpveloxa/) [Download](https://downloads.wordpress.org/plugin/iot-data-widget.1.0.4.zip) * [Details](https://es-uy.wordpress.org/plugins/iot-data-widget/#description) * [Reviews](https://es-uy.wordpress.org/plugins/iot-data-widget/#reviews) * [Installation](https://es-uy.wordpress.org/plugins/iot-data-widget/#installation) * [Development](https://es-uy.wordpress.org/plugins/iot-data-widget/#developers) [Support](https://wordpress.org/support/plugin/iot-data-widget/) ## Description IoT Data Widget lets you embed live values from smart home sensors and devices — temperature, humidity, tank levels, device status, anything with a numeric or text value — on any WordPress page or post. Activating the plugin drops you straight into a guided setup wizard that gets you from «no connection» to a working widget and a ready-to-paste shortcode in a few clicks. The free version is fully functional, not a crippled trial: unlimited connections, Home Assistant, push mode, Generic REST, the Card/Status list/Gauge display styles, the shortcode and Gutenberg block, the setup wizard, and the diagnostics page all work with no time limit and no license. Pro adds more data sources, history graphs and alerts — see «What’s included in Free vs Pro?» in the FAQ below for the full breakdown. ### External services This plugin connects to two services that are **not** the smart-home API/device you configure yourself: * **Freemius** (licensing, update delivery, and — if you opt in — basic usage analytics). On first activation you’re asked whether to allow anonymous diagnostic data ( server environment, WordPress/PHP version, plugin version, site URL) to be sent— you can decline, and review/opt out again later from your account on freemius. com. No data about your connections, entities, or the values they return is ever included. [Terms of Service](https://freemius.com/terms/), [Privacy Policy](https://freemius.com/privacy/). * **Open-Meteo** (optional, user-triggered) — clicking «Try it with demo data» in the setup wizard fetches live weather for a Warsaw coordinate pair from [Open-Meteo](https://open-meteo.com), purely to show a working example widget. No account or personal data involved. [Terms & Privacy](https://open-meteo.com/en/terms). Skip this step and no request is ever made. Every other outbound request goes only to the URL/host **you** configure for a connection. ## Screenshots [⌊Card, gauge and list widgets showing live values on a page.⌉⌊Card, gauge and list widgets showing live values on a page.⌉[ Card, gauge and list widgets showing live values on a page. [⌊The setup wizard previews the widget and gives you a ready-to-paste shortcode.⌉⌊ The setup wizard previews the widget and gives you a ready-to-paste shortcode.⌉[ The setup wizard previews the widget and gives you a ready-to-paste shortcode. [⌊Insert the IoT Widget block and choose the connection, entity and style in the sidebar.⌉⌊Insert the IoT Widget block and choose the connection, entity and style in the sidebar.⌉[ Insert the IoT Widget block and choose the connection, entity and style in the sidebar. [⌊The wizard starts by asking where your site runs, so the device and WordPress can actually reach each other.⌉⌊The wizard starts by asking where your site runs, so the device and WordPress can actually reach each other.⌉[ The wizard starts by asking where your site runs, so the device and WordPress can actually reach each other. ## Blocks This plugin provides 1 block. * IoT Data Widget Displays a live value from Home Assistant (or another configured source) on your page. ## Installation 1. Upload the `iot-data-widget` folder to `/wp-content/plugins/`, or install the zip through **Plugins Add New Upload Plugin**. 2. Activate the plugin through the **Plugins** screen — this opens the **setup wizard** automatically (skip this step by activating several plugins at once, or by clicking« Skip the wizard» on its first screen). 3. Follow the wizard: pick a connection type, configure and test it live, choose an entity, and copy the ready-made shortcode from the preview screen — or configure a connection manually under **IoT Data Widget** in the admin menu instead: 4. * **Home Assistant**: enter your instance URL (e.g. `http://homeassistant.local: 8123`) and a Long-Lived Access Token. Generate one in Home Assistant under your profile page **Security** **Long-Lived Access Tokens** **Create Token**. If the URL is a local network address, also turn on **Settings Allow local network addresses** (the wizard’s «Same network as my devices» option does this for you). * **Push mode**: no URL/credentials to enter — the wizard generates a channel and a ready-to-paste snippet for your device instead. * **Generic REST, advanced mode**: enter the full URL of a JSON endpoint. Leave Authorization empty for public APIs, or enter a full header (e.g. `Authorization: Bearer xxx` or `X-API-Key: xxx`) if the API requires one. 5. Add the widget to a page (the wizard already does this for you, with a shortcode ready to paste): 6. * **Gutenberg**: insert the «IoT Data Widget» block, pick your connection and entity in the sidebar — for Home Assistant, search and filter by domain instead of typing an entity ID. * **Shortcode**: use `[iotdw_widget]` directly — see the FAQ below for examples. ## FAQ ### Where’s the human-readable source for the minified JavaScript? blocks/iot-widget/build/index.js (the Gutenberg block editor script) is a compiled bundle. Its full, human-readable source is included in this plugin’s ZIP at `blocks/ iot-widget/src/` — build it yourself with `npm install && npm run build` (standard`@ wordpress/scripts` toolchain, see `package.json`). ### What’s included in Free vs Pro? Free (no time limit, no license, unlimited connections): Home Assistant, push mode, Generic REST data sources; Card/Status list/Gauge display styles; status rules ( a text and a status colour for a value or range); the setup wizard, shortcode, Gutenberg block, and diagnostics page. Pro adds: * **More data sources** — device presets for Shelly, Tasmota and ESPHome (pick the device, enter its IP, no JSONPath needed; Shelly Gen1 and ESPHome presets are in beta), Shelly Cloud, and MQTT (polled every 2 minutes, or real-time with the optional server-side listener, which requires SSH access). * **History graphs** — Chart and Mini trend (sparkline) display styles, plus Grid for entities from different connections in one widget. * **Alerts and reports** — email or webhook alerts when a value crosses a threshold, and recurring email reports with min/max/average. * **Embed and export** — a token-protected public embed page without the site theme, and CSV export of recorded history. * **Manually tracked entities** — history and alerts for widgets placed outside post content, e.g. in theme templates. Agency adds white-label branding on top of Pro. You can compare plans and upgrade from **IoT Data Widget Upgrade** in your WordPress admin. ### What shortcode examples are there? Card (single value): `[iotdw_widget connection="Home" entity="sensor.living_room_temperature"]` Status list (several entities at once): `[iotdw_widget connection="Home" style=" list" entities="sensor.temperature,sensor.humidity,sensor.battery"]` Gauge (numeric value with a min/max range): `[iotdw_widget connection="Home" style ="gauge" entity="sensor.tank_level" min="0" max="100"]` Generic REST (entity is a JSONPath into the JSON response): `[iotdw_widget connection ="Weather API" entity="current_weather.temperature"]` ### Can a widget show «Running» with a green dot instead of 1? Yes — add status rules. In the block, open **Status rules** in the sidebar; in a shortcode, use the `states` attribute. Each rule is `condition:text:colour`, rules are separated by `;`, up to 5 per widget, and the first matching rule wins: * A relay: `[iotdw_widget connection="Home" entity="switch.pump" states="0:Off: red;1:Running:green"]` * Temperature thresholds, keeping the number and adding only a colour dot: `states ="..18::grey;18..24::green;24..::red"` A condition is a number (`1`), a range `18..24` (from 18, below 24), `..18` (below 18) or `24..` (24 and above). Colours: green, yellow, red, grey. Rules work in the Card, Status list and Gauge styles (in Gauge the status is shown under the dial). A widget without rules looks exactly as before. Entities with a non-numeric state (a relay’s on/off, a presence sensor’s home/away…) show their real state («ON», «home») in Card and Status list styles; a raw true/ false from a JSON API shows as «On»/»Off». ### I don’t want to use the setup wizard — can I skip it? Yes, every wizard screen has a «Skip the wizard, I’ll configure manually» link that takes you straight to the regular Connections page, where everything works exactly as it did before the wizard existed. Nothing about manual configuration changed or was removed. ### Can I run the setup wizard again after my first connection? Yes — click «Run the setup wizard again» on the Connections page. It always creates a brand-new connection through the same guided steps; it never edits or overwrites one you already have. ### Why didn’t activating the plugin open the setup wizard? If you activated several plugins at once (the «bulk actions» checkbox list on the Plugins screen), the wizard intentionally doesn’t open — a redirect in the middle of a bulk action would be disruptive. Open it anytime from **IoT Data Widget Setup Wizard** in the admin menu. ### How do I get a Home Assistant Long-Lived Access Token? In Home Assistant, click your username in the bottom-left corner to open your profile, scroll to **Security**, then **Long-Lived Access Tokens** **Create Token**. Copy it immediately — Home Assistant only shows it once. Home Assistant doesn’t let you limit what a token can do — it inherits the full permissions of whichever account created it, and it never expires until you revoke it. We recommend creating a separate, non-administrator account in Home Assistant just for this token. If your WordPress site is on external/shared hosting, also consider push mode instead — it never stores a Home Assistant token at all. ### How are my device credentials protected? Credentials you enter (Home Assistant tokens and Generic REST authorization headers— plus, in Pro, MQTT broker passwords and Shelly Cloud keys) are encrypted before being stored in your WordPress database, using a key derived from your site’s own configuration. This protects them if the database itself leaks — a backup, a database dump, a SQL injection in an unrelated plugin on the same install, or a staging clone. It does **not** protect against someone who has already fully compromised your server, since the encryption key lives on that same server. If you ever uninstall the plugin, we recommend also revoking the Home Assistant token (and rotating any other credentials you entered) from the device/service side. Push mode sidesteps this entirely: the plugin never stores any credentials to your devices, because your device sends data to the plugin instead of the other way around. ### My device is on the same network as WordPress, but the connection is refused For security, the plugin doesn’t connect to local network addresses (like 192.168. x.x or homeassistant.local) unless you allow it. If WordPress runs on the same network as your devices — a Raspberry Pi, NAS or home server — turn on **IoT Data Widget Settings Allow local network addresses** (on a multisite network, only a network administrator can). Choosing «Same network as my devices» in the setup wizard does this for you. If your site is hosted externally, use push mode instead: it can’t reach your home network anyway. ### Does this work with any REST API, or only Home Assistant? Both. The Generic REST connector (free) works with any API that returns JSON over HTTP(S), authenticated or not. ### Does the plugin send my data anywhere else? No. The values shown in your widgets never leave your own WordPress installation to any third party — the plugin only connects to the URL you configure in each connection. See «External services» below for the small number of exceptions. ### What happens if a connection or entity is misconfigured? The widget fails gracefully: site visitors simply see nothing where the widget would be, while logged-in administrators see a clear error message in its place. ### Will this hit my Home Assistant instance on every page view? No — responses are cached for 60 seconds by default (not configurable per widget in this version), so repeated page views within that window are served from cache. ### Something isn’t working — what’s the fastest way to get help? Go to **IoT Data Widget Diagnostics** and click «Copy diagnostic report», then paste it into your support email or ticket. Tokens, keys and passwords are never included in the report. ### What languages does the plugin come with? English (default) and Polish. The Polish translation is included in the plugin and loads automatically on WordPress 6.7 or newer when your site language is Polish. Other languages can be contributed on [translate.wordpress.org](https://translate.wordpress.org/)— any string not yet translated falls back to English. ### What’s the plugin’s privacy policy? No telemetry beyond the opt-in Freemius diagnostics (see «External services» below); the plugin author never sees your data or connection details. Credentials are encrypted at rest. Fetched values are cached temporarily (WP Transients, 60s default), not logged or retained beyond that. Uninstalling leaves your data in place unless you check «Remove all plugin data» under Settings first. If the external API/instance you connect to processes personal data, your site’s own privacy policy should disclose that connection. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “IoT Data Widget” is open source software. The following people have contributed to this plugin. Contributors * [ wpveloxa ](https://profiles.wordpress.org/wpveloxa/) “IoT Data Widget” has been translated into 1 locale. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/iot-data-widget/contributors) for their contributions. [Translate “IoT Data Widget” into your language.](https://translate.wordpress.org/projects/wp-plugins/iot-data-widget) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/iot-data-widget/), check out the [SVN repository](https://plugins.svn.wordpress.org/iot-data-widget/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/iot-data-widget/) by [RSS](https://plugins.trac.wordpress.org/log/iot-data-widget/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.4 * Added: status rules — show a text and a coloured status dot for a value or a range (for example «Running» with a green dot for a relay, or green/red for temperature thresholds); up to 5 rules per widget, in the block sidebar or with the shortcode’s` states` attribute. Works in the Card, Status list and Gauge styles. Widgets without rules look exactly as before. * Fixed: a unit set in the shortcode (`unit="°C"`) no longer disappears when the widget refreshes its value after the page loads. #### 1.0.3 * Added: Polish translation of the whole plugin — admin screens, setup wizard, widgets, the block editor, and the licensing screens (opt-in, account, upgrade)( WordPress 6.7 or newer). * Changed: Pro-only styles in the block’s style list are marked «(Pro)». #### 1.0.2 * Security: requests to local network addresses (192.168.x.x, 10.x.x.x, homeassistant. local…) are now blocked unless «Allow local network addresses» is turned on under Settings; cloud metadata and link-local addresses are always blocked, including via redirects. If this site already connects to a device on your local network, the setting is turned on automatically during the update — nothing stops working. Choosing «Same network as my devices» in the setup wizard turns it on too. * Added: widgets placed in classic theme widget areas (sidebars, footers) now load their styles and refresh live — previously they appeared unstyled and never updated. * Fixed: widgets line up with the content column in classic themes such as Twenty Twenty-One. Widgets placed one after another now stack vertically — use a Row or Columns block to place them side by side. * Fixed: «Test connection» (and alert e-mails in Pro) show «On»/»Off» instead of« true»/»false» for on/off devices such as Shelly relays. * Fixed: the free version no longer schedules or lists Pro-only background tasks( MQTT polling, email reports, value history); updating removes them. * Fixed: the setup wizard labels Shelly Cloud and Supla as Pro, and shows an accurate message if the demo connection can’t be saved. #### 1.0.1 * Added: «Upgrade» link in the plugin menu and the plugin list, and an upgrade link next to Pro-only styles (visible to administrators only). * Fixed: database error when the same widget appears twice on a page — saving the page in the block editor no longer fails. * Fixed: widget alignment in block themes such as Twenty Twenty-Five — Card and Gauge now line up with the content column, with even spacing between widgets. * Fixed: the setup wizard now continues to entity selection after you configure a connection, instead of returning to the Connections list. #### 1.0.0 Initial release. * Home Assistant, push mode, and Generic REST connectors — all free, with no connection limit. * Guided setup wizard: pick a connection type, configure and test it live, choose an entity, and get a ready-to-paste shortcode before anything is saved. * Card, Status list and Gauge display styles — free. Chart, Mini trend/sparkline, and Grid (recorded history) — Pro. * `[iotdw_widget]` shortcode and a Gutenberg block with a searchable entity browser and live preview. * Connection credentials are encrypted at rest. * Built-in response caching, always on. * Appearance personalization — site-wide defaults with a live preview, and per- widget overrides in the block editor. * Diagnostics page with environment info, scheduled-task status, per-connection health (including push channel activity), and a one-click «Copy diagnostic report» button. ## Meta * Version **1.0.4** * Last updated **2 días ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.1.3** * PHP version ** 8.1 or higher ** * Languages * [English (US)](https://wordpress.org/plugins/iot-data-widget/) y [Polish](https://pl.wordpress.org/plugins/iot-data-widget/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/iot-data-widget) * Tags * [home assistant](https://es-uy.wordpress.org/plugins/tags/home-assistant/)[iot](https://es-uy.wordpress.org/plugins/tags/iot/) [shortcode](https://es-uy.wordpress.org/plugins/tags/shortcode/)[smart-home](https://es-uy.wordpress.org/plugins/tags/smart-home/) * [Advanced View](https://es-uy.wordpress.org/plugins/iot-data-widget/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/iot-data-widget/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/iot-data-widget/reviews/) ## Contributors * [ wpveloxa ](https://profiles.wordpress.org/wpveloxa/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/iot-data-widget/)