WordPress

关于 ONLYOFFICE 与 WordPress 集成

ONLYOFFICE 集成插件允许 WordPress 管理员使用 ONLYOFFICE Docs 打开文档、电子表格和演示文稿进行协作编辑。在已发布的文章中，所有 WordPress 网站访问者（无论是否已授权）都只能在嵌入模式下看到编辑器。有关更多信息，请参阅 ONLYOFFICE WordPress 连接器的 GitHub 页面。该插件基于 GPL-2.0 许可证分发。

备注

要详细了解 ONLYOFFICE WordPress 连接器的工作原理，请访问我们的 API 文档页面。

主要功能

创建、编辑和查看文本文档、电子表格和演示文稿。
实时协作编辑文档：两种协作编辑模式（快速和严格）、修订模式、批注和内置聊天。
JWT 支持，保护您的流量，除具有适当权限的用户外，任何人都无法访问您的文档。

支持的格式

用于创建、编辑和查看：DOCX、PPTX、XLSX
仅用于查看：XLS、XLSX、XLSM、XLT、XLTX、XLTM、ODS、FODS、OTS、CSV、PPS、PPSX、PPSM、PPT、PPTX、PPTM、POT、POTX、POTM、ODP、FODP、OTP、DOC、DOCX、DOCM、DOT、DOTX、DOTM、ODT、FODT、OTT、RTF、TXT、HTML、HTM、MHT、XML、PDF、DJVU、FB2、EPUB、XPS、OXPS
用于填写表单：PDF

将 ONLYOFFICE Docs 连接到 WordPress

要求

ONLYOFFICE Document Server v6.1.0（服务器版本或云版本）或更高版本

您需要一个 ONLYOFFICE Docs 实例，该实例必须能够被 WordPress 和任何最终客户端解析和连接。它必须能够直接向 WordPress 发送 POST 请求。

备注
请参阅官方文档页面，详细了解如何安装 ONLYOFFICE Docs。
WordPress 5.7 或更高版本
适用于 WordPress 的 ONLYOFFICE 连接器 2.3.0

安装 ONLYOFFICE WordPress 插件

要开始在 WordPress 中使用 ONLYOFFICE Docs，请使用以下三种安装方法之一：通过 .zip 压缩包、克隆 master 分支，或使用 WordPress 市场：

使用 .zip 压缩包：
- 下载压缩的插件。
- 在 WordPress 管理仪表板中转到插件部分。
- 转到插件 → 安装插件。
- 单击上传插件。
- 单击选择文件，选择下载的 ZIP 文件并上传。
- 安装完成后，单击启用。
克隆 master 分支：
- 克隆 master 分支：
```
cd wp-content/plugins git clone https://github.com/ONLYOFFICE/onlyoffice-wordpress
```
- 从 WordPress 管理仪表板启用该插件。
使用 WordPress 市场：
- 从市场上的官方页面安装该插件。
- 安装完成后，单击启用。

在 WordPress 中配置 ONLYOFFICE Docs

安装插件后，配置连接设置：

转到 WordPress 管理仪表板 → ONLYOFFICE → 设置。
指定连接器设置的 URL：
- 文档编辑服务地址 - 指定安装文档编辑服务的 URL 地址。
  
  备注
  ONLYOFFICE Docs 的地址必须可从 WordPress 访问，同时 WordPress 的地址也必须可从 ONLYOFFICE Docs 访问。
- 密钥 - 指定用于签署数据的密钥。
  
  备注
  从 ONLYOFFICE Docs v7.2 开始，JWT 默认启用，密钥会自动生成。您还需要在 WordPress 端启用它：在 ONLYOFFICE Docs 配置文件中找到您的密钥，然后在连接器设置中指定相同的密钥。有关更多详细信息，请参阅本文的为 ONLYOFFICE 和 WordPress 集成启用 JWT 部分。
- 授权标头 - （留空以使用默认标头）- ONLYOFFICE 中使用的授权 JWT 标头是 AuthorizationJwt。如果此标头与您的设置冲突，您可以将其更改为自定义标头。

工作原理

用户与文档的交互在客户端和服务器端同时进行。

下面解释本文档中使用的主要概念。

客户端包括：

文档管理器 - 在用户浏览器中显示的文档列表，用户可以在其中选择所需的文档并对其执行一些操作（根据所提供的权限，用户可以打开文档进行查看或编辑，也可以与其他用户共享文档）。
文档编辑器 - 具有所有最常见的文档编辑功能的文档查看和编辑界面，用作用户与文档编辑服务之间的媒介。

服务器端包括：

文档存储服务 - 存储具有适当访问权限的用户可用的所有文档的服务器服务。它向用户在浏览器中看到的文档管理器提供文档 ID 和这些文档的链接。
文档编辑服务 - 允许查看和编辑文档的服务器服务（前提是用户具有相应的权限）。文档编辑器界面用于访问文档编辑服务的所有功能。
文档命令服务 - 允许通过文档编辑服务执行附加命令的服务器服务。
文档转换服务 - 允许将文档文件转换为适当的 Office Open XML 格式（文本文档为 docx，电子表格为 xlsx，演示文稿为 pptx）以便编辑或下载的服务器服务。
文档生成服务 - 允许轻松生成文档而无需实际运行文档处理编辑器的服务器服务。

请注意，ONLYOFFICE Document Server 包括文档编辑器、文档编辑服务、文档命令服务、文档转换服务和文档生成服务。文档管理器和文档存储服务要么包含在 Community Server 中，要么必须由在自己的服务器上使用 ONLYOFFICE Document Server 的软件集成商来实现。

为 ONLYOFFICE 和 WordPress 集成启用 JWT

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

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

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

使用任何可用的文本编辑器打开 local.json 文件。

对于 Linux - /etc/onlyoffice/documentserver/local.json
对于 Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
对于 Docker – 使用 docker exec -it <containerID> bash 命令进入 ONLYOFFICE Docs 容器并打开 /etc/onlyoffice/documentserver/local.json

或者，您可以使用以下命令查找默认密钥，而无需打开 local.json：
```
sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'
```

local.json 文件应如下所示：

{
  "services": {
    "CoAuthoring": {
      "token": {
        "enable": {
          "request": {
            "inbox": true,
            "outbox": true
          },
          "browser": true
        }
      },
      "secret": {
        "inbox": {
          "string": "yoursecret"
        },
        "outbox": {
          "string": "yoursecret"
        },
        "session": {
          "string": "yoursecret"
        }
      }
    }
  }
}

在三个部分中指定了 true 值。这意味着已启用令牌验证。
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox
自动生成的密钥在三个部分中指定。您可以用自己的密钥替换默认的密钥值。三个部分中的密钥必须相同。
- services.CoAuthoring.secret.inbox.string
- services.CoAuthoring.secret.outbox.string
- services.CoAuthoring.secret.session.string
如果您进行了更改，请保存更改并重新启动服务，以使配置更改生效。
```
supervisorctl restart all
```

步骤 2：在连接器设置中指定相同的密钥

在连接器设置中，在密钥字段中指定相同的密钥并保存设置。

在 WordPress 中开始使用 ONLYOFFICE Docs

查看文档

要查看所有文档，请转到 WordPress 管理仪表板 > ONLYOFFICE > 文件。

添加 ONLYOFFICE 块

要添加 ONLYOFFICE 块以备将来使用：

打开创建文章窗口。
单击下方面板中的 ONLYOFFICE 图标。

添加块

上传并嵌入文件

要将文件上传到 ONLYOFFICE 块并将其嵌入到新文章中：

打开创建文章窗口。
选择 ONLYOFFICE 块。
单击上传按钮，将文件从您的计算机上传到 ONLYOFFICE 块
或
单击媒体库按钮，从您的库中选择文件并将其上传到 ONLYOFFICE 块。

文档将嵌入到创建的文章中。

已嵌入

备注

要详细了解最常见的问题及其解决方法，请访问我们的故障排除指南。

关于 ONLYOFFICE 与 WordPress 集成​

主要功能​

支持的格式​

将 ONLYOFFICE Docs 连接到 WordPress​

要求​

安装 ONLYOFFICE WordPress 插件​

在 WordPress 中配置 ONLYOFFICE Docs​

工作原理​

为 ONLYOFFICE 和 WordPress 集成启用 JWT​

在 WordPress 中开始使用 ONLYOFFICE Docs​

查看文档​

添加 ONLYOFFICE 块​

上传并嵌入文件​