Apraksts
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.
Ekrānuzņēmumi
Bloki
Šis spraudnis nodrošina 1 bloku.
- Universal Control for TaHoma Control Somfy TaHoma devices worldwide via Cloud API.
Uzstādīšana
- 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.
BUJ
-
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.
Atsauksmes
Par šo spraudni nav atsauksmju.
Autori un izstrādātāji
“Universal Control for TaHoma” ir atvērtā pirmkoda programmatūra. Šo spraudni ir veidojuši šādi cilvēki.
Līdzdalībnieki
“Universal Control for TaHoma” ir tulkots lokalizācijās 3. Paldies tulkotājiem par ieguldījumu.
Tulkot “Universal Control for TaHoma” savā valodā.
Vai jūs interesē attīstība?
Pārlūkojiet kodu, apmeklējiet SVN krātuvi vai abonējiet attīstības žurnālu, ko izveidojis RSS.
Izmaiņu žurnāls
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.