內容簡介
總結：Universal Control for TaHoma 是一個功能強大且輕量的 WordPress 外掛，可以直接將您的 Somfy TaHoma 智能家居整合到您的網站中。通過使用官方的 Overkiz (Somfy) Cloud API，該模塊提供了一種無縫控制燈光、插座、百葉窗和大門的方式。
問題與答案：
1. 這個外掛的主要功能有哪些？
- 全局設定：在 WordPress 設置中輸入一次您的憑據，並在所有模塊中重複使用。
- 智能狀態追蹤：即時顯示裝置狀態（開啟/關閉、位置 %）直接顯示在按鈕上。
- 智能切換模式：智能切換，根據當前狀態決定發送“開啟”或“關閉”。
- 性能優先：內置的會話緩存（Transient API）以防止 Somfy 伺服器的速率限制和 IP 封鎖。
- 多伺服器支援：與標準的 TaHomalink 和歐洲 Overkiz HA1 伺服器配合運作。
- 隱私與安全：通信由伺服器端處理。您的憑據永遠不會暴露於前端。
2. 這個外掛連接到哪些外部服務？
- 這個外掛連接到 Somfy TaHoma / Overkiz Cloud API，用於控制智能家居設備。
- 服務：Somfy TaHoma Cloud (Overkiz API)。
- 使用：用於驗證用戶，列出可用設備，並發送執行命令（例如開啟/關閉百葉窗）。
- 發送的數據：用戶登錄憑據（電子郵件和密碼）、伺服器偏好以及設備識別符（URL）。憑據通過 HTTPS 加密發送。
3. 如何取得這個外掛的源代碼和建置指示？
- 這個外掛的人類可讀源代碼包含在 src/ 目錄中。要從源代碼構建外掛：
1. 安裝 Node.js 和 npm。
2. 在外掛目錄中運行 npm install。
3. 運行 npm run build 以生成生產文件在 build/ 目錄中。
外掛標籤
開發者團隊
② 後台搜尋「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.
