Strapi
关于 ONLYOFFICE 和 Strapi 的集成
Strapi 是一个用于构建 API 的开源内容管理系统。ONLYOFFICE 提供了一个官方连接器,可以将 ONLYOFFICE 文档 与 Strapi 集成,并在 Strapi 媒体库中编辑办公文档。您可以从 npm 库或 GitHub 页面获取 ONLYOFFICE 集成插件。该连接器以 Apache-2.0 许可证分发。
主要功能
- 编辑和查看文本文档、电子表格和演示文稿。
- 实时协同编辑文档:两种协同编辑模式(快速和严格)、修订模式、评论和内置聊天。
- JWT 支持以保护您的流量,确保只有具有适当权限的用户才能访问您的文档。
支持的格式
- 用于查看和编辑:DOCX、XLSX、PPTX
- 仅用于查看:DOC、DOCX、DOCM、DOT、DOTX、DOTM、ODT、FODT、OTT、RTF、TXT、HTML、HTM、MHT、XML、PDF、DJVU、FB2、EPUB、XPS、XLS、XLSX、XLSM、XLT、XLTX、XLTM、ODS、FODS、OTS、CSV、PPS、PPSX、PPSM、PPT、PPTX、PPTM、POT、POTX、POTM、ODP、FODP、OTP
将 ONLYOFFICE 文档连接到 Strapi
要求
-
ONLYOFFICE 文档服务器 v7.1(服务器或云版本)或更高版本
您需要一个 ONLYOFFICE 文档 实例,该实例可以从 Strapi 和任何终端客户端解析和连接。它必须能够直接向 Strapi 发送 POST 请求。
请参阅官方 文档页面 以了解有关安装 ONLYOFFICE 文档的更多信息。 - Strapi v4.2.0 或更高版本
- ONLYOFFICE Connector v1.1.0 for Strapi
为 Strapi 安装 ONLYOFFICE 集成插件
-
为了允许插入带有编辑器的框架并加载 api.js,请将
strapi::security行替换为strapi/config/middlewares.js文件中的以下配置:{ name: "strapi::security", config: { contentSecurityPolicy: { useDefaults: true, directives: { "script-src": ["'self'", "https:", "http:"], "frame-src": ["'self'", "https:", "http:"], }, }, } },如果此类配置已存在,您只需添加
directives。 -
在您的 Strapi 项目中安装插件:
npm install onlyoffice-strapi --save -
重建并重启 Strapi 以将 ONLYOFFICE 插件包含到管理界面中。运行:
# 使用 yarn yarn build yarn develop # 使用 npm npm run build npm run develop现在,ONLYOFFICE 集成插件已安装并准备好进行配置。可以通过左侧面板的 插件 部分下的 ONLYOFFICE 名称访问该插件。


配置 ONLYOFFICE 集成插件以用于 Strapi
要在 Strapi 中配置 ONLYOFFICE 集成插件:
- 打开左侧面板中的 设置 部分。
- 在 全局设置 部分,点击 ONLYOFFICE 菜单项。
-
在 ONLYOFFICE 设置页面,输入 文档服务器地址,即已安装的 ONLYOFFICE 文档 的 URL。
ONLYOFFICE 文档的地址必须能够从 Strapi 访问,同时 Strapi 的地址也必须能够从 ONLYOFFICE 文档访问。
工作原理
用户与文档的交互在客户端和服务器端同时进行。
当前文档中使用的主要概念如下所述。
客户端包括:
- 文档管理器 - 显示在用户浏览器中的文档列表,用户可以选择所需的文档并对其执行某些操作(根据提供的权限,用户可以打开文档进行查看或编辑,与其他用户共享文档)。
- 文档编辑器 - 文档查看和编辑界面,提供所有最常用的文档编辑功能,作为用户与 文档编辑服务 之间的媒介。
服务器端包括:
- 文档存储服务 - 存储所有可供具有适当访问权限的用户使用的文档的服务器服务。它向用户在浏览器中看到的 文档管理器 提供文档 ID 和这些文档的链接。
- 文档编辑服务 - 允许执行文档查看和编辑的服务器服务(如果用户有相应的权限)。文档编辑器 界面用于访问所有 文档编辑服务 功能。
- 文档命令服务 - 允许使用 文档编辑服务 执行附加命令的服务器服务。
- 文档转换服务 - 允许将文档文件转换为适当的 Office Open XML 格式(docx 用于文本文档,xlsx 用于电子表格,pptx 用于演示文稿)以进行编辑或下载的服务器服务。
- 文档生成服务 - 允许轻松构建文档而无需实际运行文档处理编辑器的服务器服务。
请注意,ONLYOFFICE 文档服务器 包括 文档编辑器、文档编辑服务、文档命令服务、文档转换服务 和 文档生成服务。文档管理器 和 文档存储服务 要么包含在 社区服务器 中,要么必须由使用 ONLYOFFICE 文档服务器 的软件集成商在其自己的服务器上实现。
为 ONLYOFFICE 和 Strapi 集成启用 JWT
JWT 或 JSON Web Token 是在 HTTP 请求中从客户端发送到服务器的字符串,用于验证客户端的真实性。JWT 仅保存在客户端,因此各方之间的传输是受保护和数字签名的。
令牌是使用 JWT(JSON Web Tokens)标准生成的。令牌由服务器的密钥签名,因此客户端可以验证令牌的合法性。
ONLYOFFICE 文档 验证令牌。有效载荷中的数据被视为有效,并用于替代主要参数中的相应数据。如果令牌无效,则命令不会执行。要了解更多,请阅读 API 安全 指南。
要使用 JWT 保护您的文档,
- 打开左侧面板中的 设置 部分。
- 在 全局设置 部分,点击 ONLYOFFICE 菜单项。
-
在 ONLYOFFICE 设置页面,在 文档服务器 JWT 密钥 字段中输入密钥。更多信息可以在 此处找到。


现在,ONLYOFFICE 集成插件已配置完毕,您可以开始使用它。
开始在 Strapi 中使用 ONLYOFFICE 文档
为了让用户在 ONLYOFFICE 文档 编辑器中编辑来自 Strapi 的办公文档并将更改保存回 Strapi,请上传文件并设置相应的访问权限。
将文件上传到 Strapi
- 在左侧面板的 插件 部分,打开 媒体库 页面。
-
点击右上角的 添加新资产 按钮。


- 添加新资产 窗口打开。选择您是要从 计算机 上传文件还是从 URL 上传文件,点击顶部面板中的相应选项卡。


在 Strapi 中查看、编辑和管理文件
要查看、编辑和共同创作添加到 Strapi 媒体库 的文档,
- 在左侧面板的 插件 部分,打开 Strapi 中的 ONLYOFFICE 文件页面。
-
要在 ONLYOFFICE 编辑器中打开文件,请点击文件名或点击右侧的 在 ONLYOFFICE 中编辑 按钮。


要在编辑器中以所需格式保存文件,
- 转到 文件 选项卡。
- 点击 下载为... 选项并选择所需格式。
要在编辑器中将文件标记为收藏,请点击顶部工具栏中的
标记为收藏 图标。
要返回文件列表,
- 转到 文件 选项卡。
- 点击右侧菜单中的 打开文件位置 选项。
访问权限
要管理添加到 Strapi 媒体库 的文件的访问权限:
- 转到左侧面板的 常规 部分中的 设置 选项卡。
- 在 管理面板 部分,转到 角色 选项卡。
- 点击角色名称右侧的 编辑 图标以编辑角色。
要允许用户 编辑 文件,请为所需的用户角色设置 更新 + 删除 访问权限。
要仅允许用户 查看 文件,请为所需的用户角色设置 访问媒体库 访问权限。