Chamilo ONLYOFFICE 集成插件

该 插件 让用户能够 在Chamilo 中使用 ONLYOFFICE 文档编辑办公文档。

特性

• 目前，可以编辑以下文档格式：DOCX、XLSX、PPTX、PPSX、DOCXF、OFORM。
• 以下格式仅供查看：PDF、DJVU、TXT、CSV、ODT、ODS、ODP、DOC、XLS、PPT、PPS、EPUB、RTF、HTML、HTM、MHT、XPS。
• 该插件将在 Office 文档的文档库中创建一个新的菜单选项 用 ONLYOFFICE 打开。 这允许多个用户实时协作并将这些更改保存回 Chamilo。

安装 ONLYOFFICE 文档

您需要一个ONLYOFFICE 文档（文档服务器）实例，它可从 Chamilo 和任何客户终端解析和连接。 如果不是这种情况，请使用官方 ONLYOFFICE 文档文档页面。 ONLYOFFICE 文档还必须能够直接发布到 Chamilo。

ONLYOFFICE 文档和 Chamilo 可以安装在不同的计算机上，也可以安装在同一台机器上。 如果您使用一台机器，请为文档服务器设置自定义端口，因为默认情况下 ONLYOFFICE 文档和 Chamilo 都在端口 80 上工作。

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

收集Chamilo ONLYOFFICE集成插件

1. 运行以下命令获取最新版本的存储库：

   git clone https://github.com/ONLYOFFICE/onlyoffice-chamilo cd onlyoffice-chamilo

2. 获取子模块：

   git submodule update --init --recursive

3. 收集所有文件：

   mkdir /tmp/onlyoffice-deploy mkdir /tmp/onlyoffice-deploy/onlyoffice cp -r ./ /tmp/onlyoffice-deploy/onlyoffice cd /tmp/onlyoffice-deploy/onlyoffice rm -rf ./.git* rm -rf */.git*

4. 将上一步得到的文件归档：

   cd ../ zip onlyoffice.zip -r onlyoffice

安装 Chamilo ONLYOFFICE 集成插件

要开始将 ONLYOFFICE 文档与 Chamilo 一起使用，必须执行以下步骤：

1. 转到 Chamilo Administration，选择 Plugins 并单击 Upload plugin 按钮。
2. 上传 onlyoffice.zip （您可以在 此处找到它）。您将看到插件列表。
3. 从 Chamilo 根文件夹运行 composer install。
4. 返回插件列表，选择 ONLYOFFICE 插件，然后单击 启用选定的插件。

配置 Chamilo ONLYOFFICE 集成插件

在 Plugins 页面上，找到 ONLYOFFICE 并单击 Configure。您将看到 Settings 页面。启用插件并指定文档服务器地址：

https://<documentserver>/

其中 documentserver 是安装了 ONLYOFFICE 文档 的服务器的名称。 该地址必须可从用户浏览器和 Chamilo 服务器访问。 为了正常工作，Chamilo 服务器地址也必须可以从 ONLYOFFICE 文档 访问。

从 7.2 版开始，默认情况下启用 JWT，并自动生成密钥以限制对 ONLYOFFICE 文档的访问，这也是出于安全原因和数据完整性考虑。 在 Chamilo 设置页面上指定您自己的密钥。 在 ONLYOFFICE 文档 配置文件中，指定相同的密钥并启用验证。

它是如何运作的

ONLYOFFICE 集成遵循此处的API文档。

1. 要创建新文件，教师打开必要的文件夹并单击新建 ONLYOFFICE 图标。
2. 用户被重定向到文件创建页面，他们需要在其中输入文件名和格式（文本文档、电子表格或演示文稿）。 浏览器调用 /plugin/onlyoffice/create.php 方法。 它将一个空文件的副本添加到课程文件夹。
3. 要打开现有文件，用户可以选择使用 ONLYOFFICE 打开图标。

4. 请求被发送到 /plugin/onlyoffice/editor.php?docId="document identificator"。 服务器处理请求，生成具有以下属性的编辑器初始化配置：

   • url - ONLYOFFICE 文档用于下载文档的 URL；
   • callbackUrl - ONLYOFFICE 文档用于通知文档编辑状态的 URL；
   • documentServerUrl - 客户端需要响应 ONLYOFFICE 文档的 URL（可以在管理设置页面设​置）；
   • key - 指示 ONLYOFFICE 文档是否再次下载文档的电子标签。
5. 服务器返回一个带有打开编辑器脚本的页面。
6. 浏览器打开此页面并加载编辑器。
7. 浏览器向 ONLYOFFICE 文档发出请求并将文档配置传递给它。
8. ONLYOFFICE 文档加载文档，用户开始编辑。
9. ONLYOFFICE 文档向 callbackUrl 发送 POST 请求，通知 Chamilo：用户正在编辑文档。
10. 当所有用户都完成编辑后，他们会关闭编辑器窗口。
11. 10 seconds秒后，ONLYOFFICE 文档向 callbackUrl 发出 POST 请求，其中包含编辑已结束的信息，并发送新文档版本的链接。
12. Chamilo 加载文档的新版本并覆盖该文件。

在 此处下载 Chamilo ONLYOFFICE 集成插件。