Drupal 集成
ONLYOFFICE 模块使用户能够借助 ONLYOFFICE 文档在 Drupal 的媒体模块中编辑文件。
功能特性
- 目前，可编辑的文档格式有：DOCX、XLSX、PPTX、PDF。
- 可查看的文档格式如下：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。
- 该模块还允许在公共页面上预览文件。
- 该模块会在文档库中为办公文档创建一个新的在 ONLYOFFICE 中编辑菜单项。这使多个用户能够实时协作，并将更改保存回 Drupal。
安装 ONLYOFFICE 文档
您需要一个 ONLYOFFICE 文档（文档服务器）实例，该实例必须能从 Drupal 和任何终端客户端解析并连接。如果无法满足此条件，请使用官方的 ONLYOFFICE 文档安装指南。ONLYOFFICE 文档还必须能够直接向 Drupal 发送 POST 请求。
使用 Docker 是启动 ONLYOFFICE 文档实例的最简单方法。
系统要求
- firebase/php-jwt：6.0.0 或更高版本
请确保运行：
composer require firebase/php-jwt:^6.0
安装 Drupal ONLYOFFICE 连接器模块
要在 Drupal 中使用 ONLYOFFICE 文档，请按照以下步骤操作：
步骤 1：添加模块
添加 Drupal 模块有两种方式。
方式 1：使用 Composer 添加模块。
这是推荐的方式。在您站点的根目录输入以下命令：
composer require onlyoffice/onlyoffice-drupal
要应用本地化设置，请运行：
drush locale-check
drush locale-update
方式 2：手动添加模块。
新模块不再能通过 Drupal 网页界面上传。
- 前往 drupal.org 上的 Drupal ONLYOFFICE 模块项目页面，滚动到页面底部的发行版部分。点击查看所有发行版链接，从列表中选择所需版本。
- 下载您所选版本的 tar.gz 或 zip 压缩包。
- 解压压缩包，并将模块文件夹放置到站点的
/modules/contrib/目录中。 - 继续按照下一节的说明启用模块。
"添加新模块"界面选项（含 URL 字段）已从 Drupal 核心中移除。现在手动安装需要直接将文件下载并放置到模块目录中。
步骤 2：启用模块
安装完成后（通过上述任一方式），使用以下方式之一启用模块：
方式 1：使用 Drupal 管理界面。
- 在管理菜单中，导航至扩展页面（admin/modules）。
- 找到 ONLYOFFICE 连接器模块并勾选复选框。
- 点击安装以启用该模块。
方式 2：使用命令行。
-
运行以下 Drush 命令，并将项目名称作为参数：
drush pm:enable onlyoffice -
按照屏幕上的说明操作。
配置 Drupal ONLYOFFICE 连接器模块
在 Drupal 中，打开 ~/config/system/onlyoffice-settings 页面，该页面包含 ONLYOFFICE 部分的管理设置。或者依次点击配置 → 媒体 → ONLYOFFICE 连接器设置。输入连接 ONLYOFFICE 文档的地址：
https://<documentserver>/
其中，documentserver 是安装了 ONLYOFFICE 文档的服务器名称。该地址必须能被您的浏览器和 Drupal 服务器访问。Drupal 服务器地址也必须能被 ONLYOFFICE 文档访问，以确保正常工作。您可以注册免费的 ONLYOFFICE 云服务，并使用其公共 IP 地址或公共 DNS，可在云控制台的实例部分找到。
从版本 7.2 开始，JWT 默认启用，并会自动生成密钥，用于限制对 ONLYOFFICE 文档的访问，保障安全性和数据完整性。在 Drupal 管理配置中指定您自己的密钥。在 ONLYOFFICE 文档的配置文件中，指定相同的密钥并启用验证。
使用 Drupal ONLYOFFICE 连接器模块
编辑已上传到 Drupal 的文件
所有添加到媒体中的办公文件都可以打开进行编辑。在最后一列的表格中，调用下拉列表并选择在 ONLYOFFICE 中编辑操作。编辑器将在同一标签页中打开。具有管理员权限的用户能够使用 ONLYOFFICE 文档共同编辑文件。所有更改都将保存在同一文件中。
创建新帖子
创建帖子时，您可以添加新的 ONLYOFFICE 元素：
- 转到结构 → 内容类型 → 管理字段。在打开的页面上，点击添加字段。添加一个新字段：文件或媒体。设置标签并保存。
- 对于添加的文件字段，指定文件扩展名。转到结构 → 内容类型 → 管理字段。在允许的文件扩展名字段中，指定将在编辑器中显示的文件格式（docx、xlsx、pptx）。
- 对于添加的媒体字段，点击文档复选框。
- 转到结构 → 媒体类型 → 文档 → 管理显示。
- 对于文档字段，指定 ONLYOFFICE 预览格式。通过点击齿轮符号，您可以指定嵌入式编辑器窗口的尺寸。
完成预设设置后，您可以在内容选项卡上创建帖子。点击添加内容按钮并选择创建的内容。
指定标题并选择一个文件（如果内容包含文件字段）。
对于媒体部分，指定先前上传文件的名称。
您网站的访问者也将能够查看创建的页面（人员 → 权限 → 查看已发布的内容）。
处理表单
ONLYOFFICE 表单部分允许 Drupal 用户创建新的 PDF 表单：管理 → 内容 → ONLYOFFICE 表单。
创建、上传、编辑 PDF 表单
要创建新的 PDF 表单，点击创建并上传按钮。选择空白选项并填写新文件的名称。
要上传表单，选择上传选项，从设备上传 PDF 表单。
创建/上传的文件将出现在表单页面的列表中，并在新标签页中以编辑模式在 ONLYOFFICE 编辑器中打开。
在 Drupal 页面上发布 PDF 表单
要将 PDF 表单添加到 Drupal 页面，需要进行一些初始设置。导航至管理 → 结构 → 内容类型。对于所需的内容类型，选择管理字段。在下一页，点击创建新字段，选择 ONLYOFFICE 表单，并设置字段名称。这将为所选内容类型添加一个 ONLYOFFICE 表单类型的字段。
要将 PDF 表单添加到网站页面，导航至管理 → 内容。点击添加内容按钮，选择包含之前添加的 ONLYOFFICE 表单字段的内容类型。在表单字段中，输入现有表单的名称。如果表单尚未创建，点击创建新的 ONLYOFFICE 表单打开 PDF 表单部分，在那里您可以上传或创建新的 PDF 表单。最后，点击保存按钮完成 Drupal 中的页面创建。
填写 PDF 表单
在 Drupal 页面上，用户可以在表单中填写数据。要提交已填写的表单，点击编辑器顶部面板中的完成并提交按钮。
提交后，已完成的表单将发送到网站。访问者还可以通过打开编辑器顶部面板中的上下文菜单并选择下载为 DOCX 或下载为 PDF 将副本下载到设备。
处理已填写的表单
在管理 → 内容 → ONLYOFFICE 表单 → 已提交的表单部分，Drupal 用户可以查看已完成的表单，按模板名称组织。要查看特定模板的所有回复，只需选择该表单的模板名称即可。
工作原理
ONLYOFFICE 集成遵循此处记录的 API 规范。
在此处下载 Drupal ONLYOFFICE 模块。