Beschreibung
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.
Screenshots
Global Settings page in the WordPress admin. 
The TaHoma block in the Gutenberg editor with device selection. 
Live button on the frontend showing a Light status.
Blöcke
Dieses Plugin bietet 1 Block.
- Universal Control for TaHoma Control Somfy TaHoma devices worldwide via Cloud API.
Installation
- Upload the plugin folder to the
/wp-content/plugins/directory. - Activate the plugin through the ‚Plugins‘ menu in WordPress.
- Go to Settings > TaHoma Control and enter your Somfy credentials.
- Add the Universal Control for TaHoma block to any page or post using the Gutenberg editor.
FAQ
-
Why does my device not appear in the list?
-
Ensure your device is supported. The plugin currently supports On/Off Plugs, Lights, Roller Shutters, Venetian Blinds, Gates, and Garage Doors.
-
Check your credentials in the Global Settings. If you have too many blocks polling at once, Somfy might temporarily rate-limit your requests. The plugin uses caching to minimize this risk.
Rezensionen
Für dieses Plugin gibt es keine Rezensionen.
Mitwirkende und Entwickler
„Universal Control for TaHoma“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:
Mitwirkende
„Universal Control for TaHoma“ wurde in 3 Sprachen übersetzt. Danke an die Übersetzer für ihre Mitwirkung.
Übersetze „Universal Control for TaHoma“ in deine Sprache.
Interessiert an der Entwicklung?
Durchstöbere den Code, sieh dir das SVN-Repository an oder abonniere das Entwicklungsprotokoll per RSS.
Änderungsprotokoll
1.0.4
- New plugin name and slug
1.0.3
- Non-compiled version included in src folder
- Use of wp_enqueue commands
- Documented use of an external service in readme file
1.0.2
- Direct access protection.
1.0.1
- Screens inserted.
1.0.0
- Initial release.