README

此文件内容

• 简介
• 要求
• 安装
• 配置
• 使用方法
• 安装ONLYOFFICE Docs
• 已知问题

简介

ONLYOFFICE模块允许用户使用打包为文档服务器的ONLYOFFICE Docs，从Drupal的媒体模块编辑文件 - 社区或企业版。

该模块允许

• 编辑文本文档、电子表格和演示文稿。
• 在公共页面上预览文件。
• 使用两种协同编辑模式（实时和段落锁定）在文档上进行协作。

支持的格式

• 用于编辑：DOCX、XLSX、PPTX。

• 仅用于查看：DJVU、DOC、DOCM、DOT、DOTM、DOTX、EPUB、FB2、FODT、HTML、MHT、ODT、OTT、OXPS、PDF、RTF、TXT、XPS、XML、CSV、FODS、ODS、OTS、XLS、XLSM、XLT、XLTM、XLTX、FODP、ODP、OTP、POT、POTM、POTX、PPS、PPSM、PPSX、PPT、PPTM。

• 有关模块的完整说明，请访问项目页面：https://www.drupal.org/project/onlyoffice

• 要提交错误报告和功能建议，或跟踪更改：https://www.drupal.org/project/issues/onlyoffice。或者，您可以在forum.onlyoffice.com上联系ONLYOFFICE团队。

要求

此模块不需要Drupal核心之外的任何模块。

安装

步骤1：添加模块

第一种方法：使用Drupal用户界面添加模块（简单）。

1. 在drupal.org的“项目”页面的管理工具栏中（https://www.drupal.org/project），滚动到页面底部的“下载”部分。
2. 复制tar.gz链接的地址。根据您的设备和浏览器，您可能需要通过右键单击并选择“复制链接地址”来执行此操作。
3. 在管理菜单中，转到管理扩展（admin/modules）。出现扩展页面。
4. 单击安装新模块。出现安装新模块页面。
5. 在“从URL安装”字段中粘贴复制的下载链接。
6. 单击安装以上传和解压缩新模块到服务器。文件正在下载到模块目录。

第二种方法：使用Composer添加模块。

在您站点的根目录中输入以下命令

composer require onlyoffice/onlyoffice-drupal

步骤2：启用模块

第一种方法：使用Drupal用户界面（简单）。

1. 通过管理菜单导航到扩展页面（admin/modules）。
2. 找到ONLYOFFICE连接器模块并勾选。
3. 单击安装以启用。

第二种方法：使用命令行（高级，但非常高效）。

1. 运行以下Drush命令，将项目名称作为参数

drush pm:enable onlyoffice

1. 按照屏幕上的说明操作。

配置

在Drupal中，使用管理设置打开~/config/system/onlyoffice-settings页面中的ONLYOFFICE部分。输入连接ONLYOFFICE文档服务器的地址

https://<documentserver>/

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

从版本 7.2 开始，JWT 默认启用，并自动生成密钥以限制对 ONLYOFFICE Docs 的访问，出于安全原因和数据完整性考虑。请在 Drupal 管理配置中指定您自己的 密钥。在 ONLYOFFICE Docs 的 配置文件 中指定相同的密钥并启用验证。

使用方法

编辑已上传到 Drupal 的文件

所有添加到媒体的办公文件都可以打开进行编辑。在最后一列中，调用下拉列表并选择“在 ONLYOFFICE 中编辑”操作。编辑器将在同一标签页中打开。具有管理员权限的用户可以使用 ONLYOFFICE Docs 协同编辑文件。所有更改都将保存在同一文件中。

创建新帖子

在创建帖子时，您可以添加新的 ONLYOFFICE 元素。

1. 转到结构 -> 内容类型 -> 管理字段。在打开的页面中，点击 添加字段。添加新字段：文件或媒体。设置标签并保存。

2. 对于添加的文件字段，指定文件扩展名。转到结构 -> 内容类型 -> 管理字段。在 允许的文件扩展名 字段中，指定将在编辑器中显示的文件格式（docx,xlsx,pptx）。

   对于添加的媒体字段，点击文档复选框。

3. 转到结构 -> 媒体类型 -> 文档 -> 管理显示。

   对于文档字段，指定 ONLYOFFICE 预览 格式。通过点击齿轮符号，您可以指定嵌入编辑器窗口的尺寸。

完成预设置后，您可以在内容选项卡上创建帖子。单击 添加内容 按钮，并选择创建的内容。

指定标题并选择文件（如果内容包含文件字段）。

对于媒体部分，指定之前上传的文件的名称。

您的网站访客也将能够查看创建的页面（人员 -> 权限 -> 查看已发布内容）。

安装ONLYOFFICE Docs

您需要一个可以从 Drupal 和任何终端客户端解析和连接的 ONLYOFFICE Docs（文档服务器）实例。ONLYOFFICE 文档服务器还必须能够直接向 Drupal 发送 POST 请求。

您可以选择安装免费的 Community 版本或可扩展的企业版。

要安装免费的 Community 版本，请使用 Docker（推荐）或遵循 这些说明（Debian、Ubuntu 或其衍生版）。

要安装企业版，请参阅 此处 的说明。

ONLYOFFICE Docs 打包为文档服务器

• 社区版（onlyoffice-documentserver 包）
• 企业版（onlyoffice-documentserver-ee 包）

下表将帮助您做出正确的选择。

如果支持 DMS。

已知问题

通过代理设置 HTTPS （回调 URL 308 错误）

Drupal 的设计方式是，如果您通过代理配置 HTTPS，Drupal 仍然会用 http 替换链接。因此，callback 和 fileUrl 链接将以 http 格式发送到配置中。结果，ONLYOFFICE 文档服务器在回调请求中接收到 308 永久重定向 响应。

要修复此问题，请调整您的 settings.php 文件中的 Drupal 设置。

$settings['reverse_proxy'] = TRUE;
$settings['reverse_proxy_addresses'] = array($_SERVER['REMOTE_ADDR']);