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

【详细操作指南】如何将 Moodle 与编辑器连接，以修改文档、检查和批改作业等

news 2025/8/16 16:06:07

在网课盛行的当下，越来越多的教师和学生都在使用现代技术，在传统课堂之外进行更积极的参与、更密切的互动。

Moodle 支持各类学校和大学充分利用在线教育过程，是最受欢迎的国际平台之一。您可以将这款软件与 ONLYOFFICE 文档集成，在平台内部进行课件编辑、作业批改等操作，提升学习管理效率。阅读本文，了解集成操作的详情。

关于 ONLYOFFICE 文档

ONLYOFFICE 文档是多合一的文档编辑套件，支持文字、表格、幻灯片、PDF和表单的编辑与协作，高度兼容微软Office格式。易于使用和集成，可以在您的网站、平台或系统中高效处理多种类型的文档，实现文件格式间的便捷转换和无缝协作。

通过集成 ONLYOFFICE 到您的平台、办公系统和商业软件，可以实现文档内容的实时在线协同编辑，让您的团队协作更加高效。

用于 Moodle 的 ONLYOFFICE 连接器和作业提交插件

Moodle 是一款开源在线学习平台，获全球社区及认证服务提供商支持，提供多种教育活动和工具，助力各类学校、大学创建个性化学习环境。该平台依据 GPL 许可发布，自助托管版本免费。

ONLYOFFICE 可为您提供官方连接器，用于将 ONLYOFFICE 文档与 Moodle 集成并编辑附加到课程页面的办公文档。可以实现：

编辑和查看文本文档、电子表格、演示文稿、 PDF 和表单。
实时共同编辑文档：两种共同编辑模式（快速和严格）、修改跟踪模式、注释和内置聊天功能。
支持 JWT，以确保您的流量安全，除了拥有适当权限的用户外，任何人都无法访问您的文档。

最新版本的连接器 6.1.0 还新增了插件设置中的 Check Docs connection 按钮，用于测试与 ONLYOFFICE 文档服务器的连接，以及管理员设置字段验证，确保 ONLYOFFICE 文档服务器相关配置正确。

ONLYOFFICE 作业提交插件是 Moodle 主插件的扩展，允许用户

老师在创建作业后编辑和修改作业
添加 PDF 格式的 ONLYOFFICE 文件类型的自定义提交
学生对提交的作业评分后发表评论
在平板电脑上完成作业

您可以在 GitHub 上查看完整的更新日志，从 Moodle 插件库或 GitHub 页面下载 ONLYOFFICE 连接器。要了解有关 Moodle 的 ONLYOFFICE 连接器如何工作的更多信息，请访问我们的 API 文档。

*ONLYOFFICE 作业提交插件仅在安装了 ONLYOFFICE 文档插件并将其与您的 Moodle 平台集成后才能正常工作。如需了解更多信息，请访问我们的帮助中心。

将 ONLYOFFICE 文档连接到 Moodle 技术指南

系统要求

ONLYOFFICE 文档（文档服务器）6.1.0或更高版本，要确保ONLYOFFICE 文档实例能够从 Moodle 和任何终端客户端进行解析和连接，必须能够直接向 Moodle 发送 POST 请求。
Moodle v4.9或更高版本。

版本兼容性：ONLYOFFICE连接器v4.4.0适用于Moodle v4.3.0，v4.3.0适用于Moodle v4（版本号小于4.3.0），v4.2.0适用于Moodle v3.9至v3.11

安装注意事项：ONLYOFFICE 文档和Moodle可以安装在不同的计算机上，也可以安装在同一台机器上。如果选择后者，需要为 ONLYOFFICE 文档设置自定义端口，因为默认情况下ONLYOFFICE 文档和Moodle都使用80端口。

安装 ONLYOFFICE Moodle 连接器

该插件属于活动模块，通过 Moodle 插件库安装：

1. 以管理员身份登录 Moodle，进入网站管理 > 插件 > 安装插件

注意：如果找不到该选项，说明您的站点已禁用插件安装功能

2. 点击从 Moodle 插件目录安装插件

3. 选择当前 Moodle 版本

4. 搜索ONLYOFFICE 文档插件

5. 点击安装，继续

6. 确认安装请求

7. 检查插件验证报告

⚠️ 重要提示：必须准确选择与您 Moodle 版本匹配的插件版本，错误的版本可能导致严重问题，甚至使 Moodle 站点冻结。

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

1. 从 GitHub 页面下载连接器。

2. 以管理员身份登录到您的 Moodle 实例，转到站点管理部分, 切换到插件选项卡，然后单击安装插件链接。

3. 通过文件选择器上传 moodle-mod_onlyofficeeditor-x.x.x.zip 文件或将其拖放到相应的字段，然后单击从 ZIP 文件安装插件按钮。

4. 检查插件验证报告并单击继续。

如果您的目标目录不可写，您将看到一条警告消息，例如 [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

5. 在当前版本信息 -> 服务器检查页面上单击继续。

6. 单击插件检查页面上的立即升级 Moodle 数据库。

7. 在升级到新版本页面上单击继续。

安装作业提交插件

前提条件：必须已安装主ONLYOFFICE插件

1. 以管理员身份登录Moodle → 进入网站管理 > 插件 > 安装插件

如果您找不到该位置，则说明您的网站禁用了插件安装。

2. 点击从 Moodle 插件目录安装插件

3. 选择当前 Moodle 版本

4. 搜索 ONLYOFFICE 作业提交插件

5. 点击安装，继续

6. 确认安装

7. 检查验证报告

正确选择 Moodle 版本极为重要。如果您错误地为 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 整合插件不需要额外设置，所有设置均可从主插件中配置。

为 ONLYOFFICE 和 Moodle 集成启用 JWT

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

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

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

1. 使用任何可用的文本编辑器打开 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"}}}}}

2. true 由三个部分指定。这意味着令牌验证已启用。