跳到主要内容

WordPress 集成

该插件可让用户借助 ONLYOFFICE 文档在 WordPress 网站及管理面板的页面上编辑和查看办公文档。

功能特点​

  • 目前，可编辑的文档格式有：DOCM、DOCX、DOTM、DOTX、POTM、POTX、PPSM、PPSX、PPTM、PPTX、XLSM、XLSX、XLTM、XLTX。
  • 仅支持查看的文档格式如下：CSV、DJVU、DOC、DOT、DPS、DPT、EPUB、ET、ETT、FB2、FODP、FODS、FODT、HTM、HTML、MHT、MHTML、ODP、ODS、ODT、OTP、OTS、OTT、OXPS、PDF、POT、PPS、PPT、RTF、STW、SXC、SXI、SXW、TXT、WPS、WPT、XLS、XLSB、XLT、XML、XPS。
  • 该插件支持多个用户实时协作，且所做更改可保存回 WordPress。

安装 ONLYOFFICE 文档​

您需要部署一个 ONLYOFFICE 文档（文档服务器）实例，确保 WordPress 和任意终端客户端都能解析并连接到它。若无法实现连接，请参考官方的 ONLYOFFICE 文档安装指南。此外，ONLYOFFICE 文档还需具备直接向 WordPress 发送 POST 请求的能力。

使用 Docker 是安装 ONLYOFFICE 文档实例，最简单的方式。

安装 WordPress ONLYOFFICE 集成插件​

要开始在 WordPress 中使用 ONLYOFFICE 文档，请按照以下步骤操作：

  1. 下载压缩后的插件。
  2. 进入到 WordPress 管理仪表板中的插件部分。
  3. 点击页面顶部的添加新插件。
  4. 点击页面顶部的上传插件。
  5. 点击选择文件，然后选择下载的压缩插件。
  6. 插件安装完成后，点击激活。

或者，您也可克隆主分支（后续同样要在 WordPress 管理后台激活插件）：

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

配置 WordPress ONLYOFFICE 集成插件​

通过 WordPress 界面配置插件。进入 WordPress 管理仪表板，打开 ONLYOFFICE 部分，然后导航到设置。请指定以下参数：

  • 文档编辑服务地址。填写已安装的 ONLYOFFICE 文档的 URL。
  • 文档服务器 JWT 密钥。从 7.2 版本开始，JWT 默认启用，并且会自动生成密钥，以限制对 ONLYOFFICE 文档的访问，出于安全原因和数据完整性考虑。在 WordPress 管理配置中指定您自己的密钥。在 ONLYOFFICE 文档的配置文件中，指定相同的密钥并启用验证。

使用 WordPress ONLYOFFICE 集成插件​

ONLYOFFICE 集成插件支持 WordPress 管理员借助 ONLYOFFICE 文档打开文件进行协作编辑。在已发布的文章中，编辑器仅以嵌入模式对所有 WordPress 网站访问者（包括已授权和未授权的用户）可见。

编辑上传到 WordPress 的文件​

从媒体部分上传的所有文件都将显示在 ONLYOFFICE->文件页面。点击文件名，编辑器将在同一标签页中打开。具有管理员权限的用户可以共同编辑文档。所有更改都将保存到同一个文件中。

创建文章​

在创建文章时，您可以添加 ONLYOFFICE 元素（块），然后上传新文件或从媒体库中选择一个文件。添加的文件将在当前编辑的文章中以 ONLYOFFICE 徽标和文件名的形式显示。文章发布后（当您点击发布或更新按钮时），您的 WordPress 网站访问者将可以在嵌入模式下查看此文件。

工作原理​

ONLYOFFICE 集成遵循此处记录的 API。

下载 WordPress ONLYOFFICE 集成插件：此处。