
語言 🇹🇼 繁體中文
重點摘要
Moodle 外掛安裝
Add Comments to Moodle Sites
FastComments 有一個專用的 Moodle 外掛,能為您的課程與活動新增即時留言功能。SSO 會自動處理 — 您的使用者可使用 Moodle 帳號留言,無需另外登入。
此外掛支援串狀留言、即時協作聊天室,以及多種 SSO 模式。可從 GitHub 儲存庫 取得。
快速上手 
- 從 GitHub 下載最新釋出 ZIP。
- 將它解壓縮到
<moodle-root>/local/fastcomments。 - 以網站管理員身分登入並前往 Site Administration > Notifications。Moodle 會偵測該外掛並執行安裝。
- 前往 Site Administration > Plugins > Local plugins > FastComments 進行設定。
- 在 FastComments 控制台 取得您的 Tenant ID 與 API Secret,並輸入。
就是這樣!留言將顯示在您的課程與活動頁面上。
安裝 
下載外掛
從 FastComments Moodle GitHub 儲存庫 下載最新發行的 ZIP。
解壓到你的 Moodle 目錄
將 ZIP 解壓到你的 Moodle 安裝目錄,讓外掛位於 <moodle-root>/local/fastcomments。外掛目錄應直接包含 version.php、lib.php,和其他外掛檔案(不可巢狀於子資料夾)。
例如:
/var/www/html/moodle/local/fastcomments/version.php
/var/www/html/moodle/local/fastcomments/lib.php
/var/www/html/moodle/local/fastcomments/settings.php透過 Moodle 管理介面安裝
以網站管理員身分登入,然後前往 網站管理 > 通知。Moodle 會偵測到新的外掛並提示您執行安裝。
設定外掛
安裝後,前往 網站管理 > 外掛 > 本地外掛 > FastComments 以輸入您的設定。請參閱 設定 區段以了解各選項的詳細說明。
設定 
外掛設定頁面位於 網站管理 > 外掛 > 本機外掛 > FastComments。可用選項如下:
Tenant ID
您的 FastComments 租戶 ID。可在 FastComments 儀表板 的帳戶設定中找到。
API Secret
您的 API 密鑰,使用安全 SSO 模式時必需。可在 我的帳戶 > API Secret 找到此項。
SSO Mode
選擇使用者的驗證方式。請參閱 SSO Modes 區段以了解各選項的詳細說明。
- Secure (recommended) - 伺服器端 HMAC-SHA256 簽章驗證
- Simple - 客戶端使用者資料,無簽章
- None - 匿名留言,未整合 Moodle 登入
Page Contexts
控制留言出現的位置:
- Course pages - 在課程主頁的留言
- Module/activity pages - 在個別活動與資源頁面的留言
- Both - 在所有頁面類型顯示留言
Commenting Style
選擇留言體驗。請參閱 Commenting Styles 以查看每種模式的畫面截圖。
- Comments - 頁面內容下方的標準串狀留言元件
- Collab Chat - 內嵌文字選取討論,並顯示在線狀態指示
- Both - 同時啟用留言與協作聊天
CDN URL
FastComments 的 CDN URL。預設為 https://cdn.fastcomments.com。若您的資料託管於 EU 區域,請將此改為 EU 的 CDN URL。
評論樣式 
此外掛支援三種留言樣式。您可以在外掛設定中進行配置。
留言
標準的 FastComments 小工具顯示於頁面內容下方。使用者可發表分層留言、回覆、投票,並使用所有標準功能。
Collab Chat
使用 Collab Chat 時,使用者可以在頁面上選取文字以開始內嵌討論。頂端列會顯示線上使用者及目前進行中討論的數量。
Collab Chat + 留言
兩種模式同時啟用。留言小工具會顯示於頁面內容下方,使用者也可以選取文字以開始內嵌討論。
單一登入(SSO)模式 
該外掛支援三種 SSO 模式,用以將 Moodle 的使用者帳號與 FastComments 整合。
Secure SSO (Recommended)
使用 HMAC-SHA256 與您的 API Secret 在伺服器端對使用者資料進行簽章。這是最安全的選項,建議用於生產環境。
使用 Secure SSO:
- 使用者名稱、電子郵件與頭像會安全地傳送到 FastComments。
- Moodle 站台管理員會自動同步為 FastComments 管理員。
- 使用者無法冒充其他帳號。
- 需要在外掛設定中設定 API Secret。
Simple SSO
使用者資料(姓名、電子郵件、頭像)在用戶端傳送,未包含加密簽章。這比較容易設定,因為不需要 API Secret,但較不安全,因為使用者資料未經伺服器端驗證。
None
無 SSO 整合。使用者以匿名方式留言或必須另外登入 FastComments。若您不希望 Moodle 使用者帳號連結到留言,請使用此模式。
使用者通知偏好設定 
此外掛會在每位使用者的 Moodle 個人資料偏好設定中新增 FastComments 區段。使用者可以管理自己的通知設定,無需造訪 FastComments 網站。
可用的偏好設定
- Reply Notifications - 當有人回覆他們的評論時接收通知。
- Subscription Notifications - 接收他們所訂閱主題的通知。
使用者可以在其 Moodle 個人資料的 FastComments 區段存取這些設定。