Universal Control for TaHoma

Universal Control for TaHoma is a powerful and lightweight WordPress plugin that allows you to integrate your Somfy TaHoma smart home directly into your website. Using the official Overkiz (Somfy) Cloud API, this block provides a seamless way to control lights, plugs, shutters, and gates.

Key Features:

• Global Settings: Enter your credentials once in the WordPress Settings and use them across all blocks.
• Smart Status Tracking: Real-time device status (On/Off, Position %) displayed directly on the button.
• Smart Toggle Mode: Intelligent switching that knows whether to send “Open” or “Close” based on current state.
• Performance First: Built-in session caching (Transient API) to prevent rate-limiting and IP bans from Somfy servers.
• Multi-server Support: Works with standard TaHomalink and European Overkiz HA1 servers.
• Privacy & Security: Communication is handled server-side. Your credentials are never exposed to the frontend.

External services

This plugin connects to the Somfy TaHoma / Overkiz Cloud API to control smart home devices.

• Service: Somfy TaHoma Cloud (Overkiz API)
• Usage: Used to authenticate the user, list available devices, and send execution commands (e.g., open/close shutters).
• Data sent: User login credentials (email and password), server preference, and device identifiers (URLs). Credentials are sent encrypted via HTTPS.
• Privacy and Terms:
  • Somfy Privacy Policy: https://www.somfy.com/en-en/privacy-policy
  • Somfy Terms and Conditions: https://www.somfypro.co.uk/general-conditions-of-sale

Source Code & Build Instructions

The human-readable source code for this plugin is included in the src/ directory. To build the plugin from source:
1. Install Node.js and npm.
2. Run npm install in the plugin directory.
3. Run npm run build to generate the production files in the build/ directory.