WordPress

主要功能

• 创建、编辑和查看文本文档、电子表格和演示文稿。
• 实时协同编辑文档：两种协同编辑模式（快速和严格）、修订模式、评论和内置聊天。
• 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 文档服务器 v6.1.0（服务器或云版本）或更高版本

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

  请参阅官方 文档页面 以了解有关安装 ONLYOFFICE 文档的更多信息。
• WordPress v. 5.7 或更高版本
• ONLYOFFICE WordPress 连接器 2.3.0

在 WordPress 中安装 ONLYOFFICE 插件

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

1. 使用 .zip 压缩包：
   • 下载压缩的插件。
   • 导航到 WordPress 管理仪表板中的插件部分。
   • 转到 插件 → 添加新插件。
   • 点击 上传插件。
   • 点击 选择文件，选择下载的 ZIP 文件并上传。
   • 安装后，点击 激活。
2. 通过克隆主分支：
   • 克隆主分支：

     cd wp-content/plugins git clone https://github.com/ONLYOFFICE/onlyoffice-wordpress

   • 从 WordPress 管理仪表板激活插件。
3. 使用 WordPress 市场：
   • 从市场上的官方页面安装插件。
   • 安装后，点击 激活。

在 WordPress 中配置 ONLYOFFICE 文档

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

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

工作原理

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

当前文档中使用的主要概念如下所述。

客户端包括：

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

服务器端包括：

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

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

启用 ONLYOFFICE 和 WordPress 集成的 JWT

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

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

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

1. 使用任何可用的文本编辑器打开 local.json 文件。
   • 对于 Linux - /etc/onlyoffice/documentserver/local.json
   • 对于 Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • 对于 Docker – 使用 docker exec -it <containerID> bash 命令进入 ONLYOFFICE 文档容器并打开 /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"}}}}}

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

   supervisorctl restart all

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

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