
语言 🇨🇳 简体中文
摘要
Moodle 插件安装
Add Comments to Moodle Sites
FastComments 有一个专用的 Moodle 插件,可为您的课程和活动添加实时评论。SSO(单点登录)会自动处理——您的用户可以使用他们的 Moodle 帐户发表评论,无需单独登录。
该插件支持线程式评论、实时协作聊天以及多种 SSO 模式。请从 GitHub 仓库 获取。
快速开始 
- 从 GitHub 下载最新的发行版 ZIP。
- 将其解压到
<moodle-root>/local/fastcomments。 - 以站点管理员身份登录并访问 站点管理 > 通知。Moodle 将检测到该插件并运行安装。
- 转到 站点管理 > 插件 > 本地插件 > 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 Tenant ID。可在 FastComments 仪表板 的账户设置中找到此项。
API Secret
您的 API Secret 密钥,用于 Secure SSO 模式。可在 我的账户 > API Secret 找到此项。
SSO Mode
选择用户的身份验证方式。有关每个选项的详细信息,请参见 SSO 模式 部分。
- Secure (recommended) - 服务器端 HMAC-SHA256 签名认证
- Simple - 客户端用户数据,无签名
- None - 匿名评论,不集成 Moodle 登录
Page Contexts
控制评论出现的位置:
- Course pages - 课程主页面上的评论
- Module/activity pages - 单个活动和资源页面上的评论
- Both - 在所有页面类型上显示评论
Commenting Style
选择评论体验。有关每种模式的截图,请参见 评论样式。
- Comments - 在页面内容下方的标准嵌套评论组件
- Collab Chat - 基于内联文本选择的讨论,带有在场指示器
- Both - 同时启用评论和 Collab Chat
CDN URL
FastComments 的 CDN URL。默认为 https://cdn.fastcomments.com。如果您的数据托管在欧盟区域,请将其更改为 EU CDN URL。
评论样式 
插件支持三种评论样式。您可以在插件设置中进行配置。
评论
标准的 FastComments 小部件出现在页面内容下方。用户可以发布线程式评论、回复、投票,并使用所有标准功能。
协作聊天
使用 Collab Chat,用户可以在页面上选择文本以开始内联讨论。顶部栏显示在线用户和正在进行的讨论数量。
协作聊天 + 评论
两种模式同时启用。评论小部件出现在页面内容下方,用户也可以选择文本以开始内联讨论。
单点登录模式 
该插件支持三种 SSO 模式,用于将 Moodle 用户帐户与 FastComments 集成。
安全 SSO(推荐)
用户数据在服务器端使用 HMAC-SHA256 和您的 API Secret 进行签名。这是最安全的选项,建议在生产环境中使用。
使用安全 SSO 时:
- 用户名、电子邮件和头像会被安全地传递给 FastComments。
- Moodle 站点管理员会自动同步为 FastComments 的版主。
- 用户无法冒充其他帐户。
- 需要在插件设置中配置 API Secret。
简单 SSO
用户数据(姓名、电子邮件、头像)在客户端发送,不带加密签名。由于不需要 API Secret,设置更简单,但由于用户数据未在服务器端验证,因此安全性较低。
无
不进行 SSO 集成。用户以匿名方式评论,或必须另行登录 FastComments。如果您不希望将 Moodle 用户帐户与评论关联,请使用此选项。
用户通知偏好 
该插件在每个用户的 Moodle 个人资料偏好中添加了一个 FastComments 部分。用户可以在不访问 FastComments 网站的情况下管理他们自己的通知设置。
可用偏好
- 回复通知 - 当有人回复他们的评论时接收通知。
- 订阅通知 - 接收他们订阅的讨论串的通知。
用户可以在他们的 Moodle 个人资料中的 FastComments 部分访问这些设置。