WordPress 外掛程式整合指南
使用 WebLiveHub 串流 透過將您的網站連接到 WordPress，將 WebLiveHub 串流內容嵌入到 WordPress 中 託管後端.
WordPress 整合
使用 WebLiveHub Stream 嵌入流（區塊優先）
WebLiveHub Stream 是一個 WordPress 外掛程式，透過將您的網站連接到 WebLiveHub 來嵌入 WebLiveHub 串流內容 託管後端.
相容性
- 至少需要：WordPress
6.0 - 已測試：WordPress
6.9 - 需要 PHP：
8.0
它是如何運作的
- 您的 WordPress 網站連接到託管後端。
- 此外掛程式生成嵌入令牌 伺服器端 （將憑證保留在貼文/頁面之外）。
- 此頁面呈現 WebLiveHub 播放器。
開始前準備
你需要一個可管理的 WordPress 網站，以及已為主播準備好的 WebLiveHub 連線。
- 在 Console → Hosted Backends 複製要使用的後端服務 URL。該後端的 Allowed Origins 必須包含你的 WordPress 網站來源網址（origin）。
- 在 Console → Users 找出已授權的連線身分及主播的公開 User ID。連線密碼屬於該串流身分，不是 WordPress 管理員密碼，也不是 Google 登入密碼。
- 主播頁面須使用相符的主播帳戶。請直接在 WordPress 設定中輸入連線密碼；不要把密碼放在頁面內容或支援訊息中。
- 使用可存取攝影機和麥克風的瀏覽器，並在瀏覽器及作業系統權限中允許使用這兩項裝置。
如果帳戶、後端或主播身分尚未準備好，請透過聯絡頁面提供網站網址及預計用途。請勿傳送密碼或 token。
安裝與支援
原始碼版本： GitHub 上的 WebLiveHub Stream v1.1.0
請從 GitHub 發行頁下載 v1.1.0 原始碼 ZIP。在 WordPress 後台依序選擇「外掛 → 安裝外掛 → 上傳外掛」，選取 ZIP，按「立即安裝」，再啟用外掛。已在官方 WordPress Playground（WordPress 6.9／PHP 8.3）成功上傳、安裝、啟用並開啟設定頁；本次只驗證新安裝，未測試舊版升級、後端連線或直播。外掛目前未透過 WordPress.org 發行。
建立主播頁面
- 從 v1.1.0 Release 下載 Source code (zip)。在 WordPress 依序開啟 Plugins → Add New Plugin → Upload Plugin，安裝 ZIP 並啟用 WebLiveHub Stream。
- 開啟 Settings → WebLiveHub Stream。使用 Quick Setup 儲存 Hosted Backend 服務 URL，以及相符的連線身分和密碼。儲存只表示設定已寫入；仍須按下方步驟確認開播。
- 在建立頁面的區域選擇主播用途，輸入相符主播的公開 User ID，然後建立頁面草稿。若有多組連線，請明確選擇後端及身分。
- 檢查草稿中已填入的區塊，預覽頁面，確認後再發布。建立草稿不會自動發布頁面。
- 開啟主播頁面，在瀏覽器及作業系統中允許攝影機和麥克風，並使用頁面上的開始控制項進行本次活動。
- 確認載入遮罩已隱藏或取消，而且主播計時器已開始。活動結束時，使用介面結束直播。
下次有真實活動時，重用這個主播頁面，並再次確認上述開播訊號。
重用主播頁面
保留可正常使用的主播頁面供日後活動重用。需要更改主播或版面時，可編輯頁面中現有的 WebLiveHub Stream 區塊。
手動加入區塊、多組連線、短碼及自訂 CSS 仍可用於進階設定；使用 Quick Setup 和建立草稿的流程時，不必先做這些操作。
如果裝置權限遭拒或載入持續進行，請檢查瀏覽器及作業系統中的攝影機和麥克風權限。聯絡支援時，請說明進行到哪一步、外掛及瀏覽器版本，並提供已移除密碼和 token 的可見錯誤訊息。
主機標籤備忘錄
| 主機標籤 | 何時使用 |
|---|---|
| 連接 | 測試/PoC/一般預設 |
| 觀看 | 串流媒體/廣播模式（上游+控制） |
| 即時客戶端 | 檢視器模式（觀看） |
進階/舊版：簡碼使用
定位指南：將短代碼視為遺留工作流程的可選後備方案。
[weblivehub_stream streamer="STREAMER_USER_ID"][weblivehub_stream streamer="STREAMER_USER_ID" host_label="live" width="100%" height="600px"]
[weblivehub_stream streamer="STREAMER_USER_ID" host_label="live" style="width: 100%; height: 600px; display: block;"]安全說明： 僅將託管後端憑證儲存在 設定 → WebLiveHub 串流。不要將憑證貼到貼文/頁面中。
有真實的 WordPress 直播用途嗎？請聯絡我們討論設定。請附網站網址及預計首次使用日期；未定可寫「未定」。請勿傳送密碼或 token。