跳到主要内容

Moodle 集成

这个插件允许用户使用 ONLYOFFICE 文档在 Moodle 平台上编辑办公文档。

功能特点​

  • 目前，可编辑的文档格式包括：DOCX、XLSX、PPTX、PDF。
  • 仅支持查看的格式有：TXT、CSV。
  • 该插件会在所需课程页面上创建一个新的 ONLYOFFICE 文档活动，作为其中一种编辑模式。这使得多个用户可以实时协作，并将所做的更改保存回 Moodle 平台。

安装 ONLYOFFICE 文档​

您需要有一个 ONLYOFFICE 文档（文档服务器）实例，该实例必须能从 Moodle 和任何终端客户端解析并连接。如果无法满足此条件，请使用官方的 ONLYOFFICE 文档安装指南。ONLYOFFICE 文档还必须能够直接向 Moodle 发送 POST 请求。

使用 Docker 是安装 ONLYOFFICE 文档实例的最简单方法。

安装 Moodle ONLYOFFICE 集成插件​

该插件是一个活动模块。

按照 Moodle 插件的常规安装步骤，将此插件安装到您的 mod/onlyoffice 目录中。更多信息，请参阅 Moodle 文档。

最新的编译包文件可在此处获得。

配置 Moodle 与 ONLYOFFICE 集成插件​

插件安装完成后，会打开插件设置页面。或者，您也可以在插件概览页面上找到已安装的插件，然后点击设置。

  • 在文档编辑服务地址字段中输入安装了 ONLYOFFICE 文档的服务器名称：

    https://<documentserver>/

    其中，documentserver 是安装了 ONLYOFFICE 文档的服务器名称。该地址必须能被用户浏览器和 Moodle 服务器访问。Moodle 服务器地址也必须能被 ONLYOFFICE 文档访问，以确保正常工作。您可以注册一个免费的 ONLYOFFICE 云，并使用其公共 IP 地址或公共 DNS，这些地址或 DNS 可以在云控制台的实例部分找到。

  • 从 7.2 版本开始，JWT 默认启用，并且会自动生成密钥，用于限制对 ONLYOFFICE 文档的访问，保障安全性和数据完整性。在 Moodle 的设置页面指定您自己的文档服务器密钥。在 ONLYOFFICE 文档的配置文件中，指定相同的密钥并启用验证。

使用 Moodle ONLYOFFICE 集成插件​

插件安装并配置完成后，您可以按照 Moodle 的常规操作，在课程页面添加 ONLYOFFICE 活动实例：

  1. 打开所需的课程页面。
  2. 使用右上角的切换器激活编辑模式。
  3. 点击添加活动或资源。
  4. 在弹出窗口中选择 ONLYOFFICE 文档活动。
  5. 输入活动名称，从电脑上传或拖放所需文档，然后点击保存并显示按钮。

管理员和教师可以在文档权限部分选择是否允许从 ONLYOFFICE 编辑器内下载或打印文档。

点击课程页面中的活动名称或链接，会在用户浏览器中打开 ONLYOFFICE 编辑器，准备进行协作编辑。

工作原理​

ONLYOFFICE 集成遵循此处记录的 API。

在此处下载 Moodle 的 ONLYOFFICE 插件。