当前位置：首页 > news >正文

如何将 ONLYOFFICE 与 Moodle 进行集成，让师生在学习管理平台中协作编辑办公文档

news 2025/12/1 0:30:08

在教学过程中使用现代在线学习软件，已不再是什么稀奇事。在世界各地，越来越多的教师和学生都在使用现代技术，应用新的学习场景，包括学生在传统课堂之外更积极的参与、更密切的互动。

Moodle 支持各类学校和大学充分利用在线教育过程，是最受欢迎的国际平台之一。您可以将这款软件与 ONLYOFFICE 文档组合使用，在 Linux 环境中部署协作式学习管理系统。

Moodle 开源学习平台

Moodle 是一个开源在线学习平台，注重安全与隐私，支持教育工作者打造灵活、高可用性的在线空间，供学习者使用。它是一款广受认可的教育软件，收获全球数亿用户信赖。这个解决方案完全开源，除全球社区外，也获得了一众认证服务提供商的支持。

Moodle 提供多种教育活动和工具，支持各类学校和大学创建自己的个性化学习环境，用户可以随时随地访问，还可以通过移动设备访问。

Moodle 根据 GPL 许可发布，自助托管版本是免费的。

ONLYOFFICE 文档

ONLYOFFICE 文档是一款开源办公套件，融合了用于文本文档、电子表格、演示文稿和PDF的在线编辑器。这款套件与 Microsoft Office 格式（docx、xlsx 和 pptx）高度兼容，还支持其他常用格式，包括 odt、ods、odp、doc、xls、ppt、pdf、txt、rtf、html、epub 和 csv。

ONLYOFFICE 文档支持大量的协作工具（两种共同编辑模式、跟踪更改、版本历史记录、评论及内置聊天），支持多种访问权限。还集成了

这款套件可与诸多 DMS 服务和文件共享平台轻松集成，如 Moodle、Nextcloud、ownCloud、Confluence、Alfresco、SharePoint、Liferay、Nuxeo 等。

【集成介绍】ONLYOFFICE 文档与学习管理系统 Moodle

关于 ONLYOFFICE 和 Moodle 集成

ONLYOFFICE 提供官方连接器，用于将 ONLYOFFICE 文档与 Moodle 集成并编辑附加到课程页面的办公文档。您可以从 Moodle 插件库或 GitHub 页面下载 ONLYOFFICE 连接器。

要了解有关 Moodle 的 ONLYOFFICE 连接器如何工作的更多信息，请访问我们的 API 文档。

主要特点

编辑和查看文本文档、电子表格、演示文稿和表单。
要了解有关表单的更多信息，请阅读有关创建和填写表单的相应文章。
实时共同编辑文档：两种共同编辑模式（快速和严格）、跟踪更改模式、评论和内置聊天。
JWT 支持可以确保您的文档安全，只有具有适当权限的用户才能访问。

支持的格式

用于查看和编辑: DOCX, XLSX, PPTX, DOCXF
仅供查看: PDF, TXT, CSV
用于填写表单: OFORM
用于转换为 Office Open XML 格式: ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM

2.2.0 和 3.0.0 版本中的新增功能

新增

为编辑器添加保护选项
添加以全屏模式打开编辑器的功能
在编辑器的评论中添加提及
在编辑器中“另存为”
添加使用空文件创建活动的功能
在编辑器页面添加图标
编辑器界面定制
德语、西班牙语、法语、意大利语、日语、俄语、中文简体翻译
添加对 ONLYOFFICE 表单的支持

修复

设置编辑器界面语言
修复备份和恢复过程中的问题
重新设计为 Moodle 4

完整的变更日志可在此处获取。

将 ONLYOFFICE 文档连接到 Moodle

要求

ONLYOFFICE 文档服务器 v6.2（服务器或云版本）或更高版本
您需要一个可解析且可连接到 Moodle 和任何终端客户端的 ONLYOFFICE 文档实例。它必须能够直接向 Moodle 发送 POST 请求。

请参阅官方文档页面，了解有关安装 ONLYOFFICE 文档的更多信息。
Moodle v3.9.10 或更高版本
适用于 Moodle 的 ONLYOFFICE 连接器 v3.0.0

ONLYOFFICE 文档和 Moodle 可以安装在不同的计算机上，也可以安装在同一台计算机上。如果您选择第二种方案，则需要为 ONLYOFFICE 文档设置自定义端口，因为默认情况下 ONLYOFFICE 文档和 Moodle 都在端口 80 上工作。请参阅 Docker、Ubuntu、CentOS 或 Windows 的相应说明。

安装 Moodle 的 ONLYOFFICE 连接器

使用 Moodle 插件库安装 ONLYOFFICE 连接器

以管理员身份登录您的 Moodle 实例，然后转到 站点管理 > 插件 > 安装插件。
如果您找不到此位置，则说明您的网站上已禁用插件安装。
单击从 Moodle 插件目录安装插件按钮。
选择您当前的 Moodle 版本。
搜索 ONLYOFFICE 文档插件。
单击“安装”按钮，然后单击“继续”。
确认安装请求。
检查插件验证报告。
重要提示正确选择您的 Moodle 版本。如果您错误地为您的 Moodle 服务器下载并安装了错误版本的插件，这可能会导致一些严重的问题，甚至冻结 Moodle 站点。

使用 GitHub .ZIP 存档安装 ONLYOFFICE 连接器

从 GitHub 页面下载连接器。
以管理员身份登录到您的 Moodle 实例，转到 站点管理部分, 切换到插件选项卡，然后单击安装插件链接。
通过文件选择器上传moodle-mod_onlyofficeeditor-x.x.x.zip文件或将其拖放到相应的字段，然后单击从ZIP文件安装插件按钮。
检查插件验证报告并单击继续。如果您的目标目录不可写，您将看到一条警告消息，例如 [Error] Write access check [/var/www/html/moodle/mod]。在这种情况下，您可以使用以下命令暂时使其可写：
```
sudo chmod -R 777 /var/www/html/moodle
```
之后，重复步骤 3。

安装插件后，您需要恢复权限以使该目录不再可写。使用以下命令：
```
sudo chmod -R 0755 /var/www/html/moodle
```
在当前版本信息 -> 服务器检查页面上单击继续。
单击插件检查页面上的立即升级 Moodle 数据库
在升级到新版本页面上单击继续。

为 Moodle 配置 ONLYOFFICE 连接器

安装插件后，将打开插件设置页面。或者，您可以在插件概述页面上找到 ONLYOFFICE 文档，然后单击设置。在设置页面，您可以配置以下参数：

在文档编辑服务地址字段中输入用于从 Moodle 访问文档编辑服务的地址。该字段为必填字段。
重要提示 ONLYOFFICE 文档的地址必须可从 Moodle 访问，并且 Moodle 的地址也必须可从 ONLYOFFICE 文档访问。
（可选）指定用于在“文档服务器密钥”字段中对数据进行签名的密钥。密钥用于在向文档服务器发出请求时验证 JSON Web 令牌。要了解更多信息，请查看 ONLYOFFICE 文档端配置 JWT 的 API 文档。
从 ONLYOFFICE 文档v7.2 开始，默认启用 JWT，并自动生成密钥。您还需要在 Moodle 端启用它：在 ONLYOFFICE 文档配置文件中找到您的密钥，然后在连接器设置中指定相同的密钥。有关更多详细信息，请参阅本文的为 ONLYOFFICE 和 Moodle 集成启用 JWT 部分。
启用强制保存 - 禁用此选项时，您的更改将自动保存到编辑器的缓存中。启用此选项后，单击“保存”按钮时，对文档的所有更改都会直接发送到存储。
（可选）通过选中必要的框来指定编辑器自定义设置：
- 显示聊天菜单按钮 - 此选项用于显示或隐藏聊天菜单按钮。
- 显示帮助菜单按钮 - 此选项用于显示或隐藏帮助菜单按钮。
- 更紧凑地显示标题 - 此选项用于在编辑器窗口标题的上部徽标旁边或工具栏中显示附加操作按钮。
- 显示反馈和支持菜单按钮 - 此选项用于显示或隐藏反馈和支持菜单按钮。
- 显示单色工具栏标题 - 此选项用于以单色显示编辑器工具栏。

准备好后，单击“保存更改”。

为 ONLYOFFICE 和 Moodle 集成启用 JWT

为了保护文档免遭未经授权的访问，ONLYOFFICE 编辑器使用 JSON Web 令牌 (JWT)。在初始化文档编辑器时，令牌被添加到配置中，在内部 ONLYOFFICE 文档服务之间的命令交换期间使用。密钥用于签署 JSON Web 令牌，并在向 ONLYOFFICE 文档发出请求时验证令牌。

从 ONLYOFFICE 文档v7.2 开始，默认启用 JWT，并自动生成密钥。您需要在 ONLYOFFICE 文档配置文件中找到您的密钥，然后在连接器设置中指定相同的密钥。

第 1 步：在 ONLYOFFICE 文档配置文件中找到您的密钥

使用任何可用的文本编辑器打开 local.json 文件。
- 对于Linux - /etc/onlyoffice/documentserver/local.json
- 对于Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
- 对于Docker – 使用docker exec -it <containerID> bash 命令进入ONLYOFFICE 文档容器并打开 /etc/onlyoffice/documentserver/local.json
local.json 文件应如下所示：
```
{"services": {"CoAuthoring": {"token": {"enable": {"request": {"inbox": true,"outbox": true},"browser": true}},"secret": {"inbox": {"string": "yoursecret"},"outbox": {"string": "yoursecret"},"session": {"string": "yoursecret"}}}}
}
```
true 由三个部分指定。这意味着令牌验证已启用。
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox
自动生成的密钥由三个部分指定。您可以用您自己的密钥替换默认密钥值。三段密钥必须相同。
- services.CoAuthoring.secret.inbox.string
- services.CoAuthoring.secret.outbox.string
- services.CoAuthoring.secret.session.string
如果进行更改，请保存并重新启动服务以使配置更改生效。
```
supervisorctl restart all
```

第 2 步: 在连接器设置中指定相同的密钥

在连接器设置中，在密钥字段中指定相同的密钥并保存设置。

开始在 Moodle 中使用 ONLYOFFICE 文档

添加 ONLYOFFICE 活动

要创建新的 ONLYOFFICE 活动：

打开我的课程部分并切换到所需的课程。
使用右上角的切换器激活编辑模式。
单击添加活动或资源。
在弹出窗口中选择ONLYOFFICE文档活动。编辑
输入活动名称，从您的电脑创建、上传或拖放必要的文档，然后单击“保存并显示”按钮
编辑

该文档将在 ONLYOFFICE 文档编辑器中打开。

查看和编辑文件

ONLYOFFICE 活动将在您的课程页面上标有 ONLYOFFICE 图标。要在 ONLYOFFICE 文档编辑器中打开文档，只需单击其标题即可。

要以全屏模式打开编辑器，请单击编辑器窗口上方右上角的打开全屏按钮。

使用密码保护文件

ONLYOFFICE 文件可以使用密码进行保护，以防止未经授权的访问。要做到这一点，

转到顶部工具栏的“文件”选项卡。
选择保护选项。
单击添加密码按钮。
在“密码”字段中设置密码，并在下面的“重复密码”字段中重复该密码，然后单击“确定”。
请注意：如果丢失或忘记密码，则无法恢复。请将其保存在安全的地方。

更改密码，

转到顶部工具栏的“文件”选项卡。
选择保护选项。
单击更改密码按钮。
在“密码”字段中设置密码，并在下面的“重复密码”字段中重复该密码，然后单击“确定”。

删除密码，

转到顶部工具栏的“文件”选项卡。
选择保护选项。
单击删除密码按钮。

禁用保护选项，

进入活动编辑页面。
打开文档权限部分。
选中隐藏保护选项卡框。

管理权限

管理员/教师可以选择是否可以从 ONLYOFFICE 编辑器中下载或打印文档。这可以在文档权限部分中完成。

将文档权限更改为只读：

打开所需的 ONLYOFFICE 文档。
转到更多 -> 权限。
找到编辑 ONLYOFFICE 文档活动/查看 ONLYOFFICE 文档活动条目。
在“禁止”部分中添加所需的角色，或从“具有权限的角色”部分中删除角色。

我们希望这份指南对您有所帮助。欢迎在下方留言，分享您的意见。我们想了解到您对于 ONLYOFFICE/Moodle 集成的看法！