ONLYOFFICE中的插件是向编辑器添加新功能的简便方法。除了预安装的设置外,还可以使用ONLYOFFICE API添加自己的插件。阅读这篇文章,以了解从哪里开始,如果您想构建和集成您的插件。
插件类型
我们区分以下几种类型:
- 视觉和非视觉。非可视化插件提供了将某些转换应用于文档的按钮(例如,将所选文本转换为语音的“ 语音”插件,或允许从桌面应用程序以邮件附件权限发送文档的“ 发送”插件)。视觉插件会打开一个单独的窗口或面板(例如,突出显示代码,该代码可突出显示选择必要的语言,样式和背景颜色的代码的语法,或“ 照片编辑器”插件)。
- OLE对象。允许将信息从外部资源保存到生成的文件中(例如,可将YouTube视频嵌入到文档中的插件)。
- 系统与非系统。系统插件在启动编辑器时始终在后台运行(例如,桌面应用程序中的e2e 加密)。非系统插件首先单击相应的按钮(ONLYOFFICE中的大多数插件)。
- 输入助手。具有自己的窗口,当您键入文本时该窗口会消失。它的位置与光标相关。一个示例是自动完成插件,可帮助用户更快地键入内容。
在GitHub上找到所有可用的插件示例。
插件结构
ONLYOFFICE中的插件始终是一个至少包含三个文件的文件夹:
- 插件配置文件(config.json)。
- 插件入口点(index.html)。
- 代码文件本身(pluginCode.js)。
此文件夹还可以包含其他文件,例如图标,翻译,自述文件等。
如何构建自己的插件
创建一个新文件夹,您将在其中放置所有文件,然后执行以下步骤:
- 使用插件的JavaScript代码创建一个.js文件。
- 创建一个主HTML文件,以指定插件在哪种iframe中工作。
- 使用在编辑器中注册插件所需的数据创建配置文件。
- 如有必要,本地化您的插件。
- 创建一个关于页面。
如何将插件添加到ONLYOFFICE编辑器
完成上述步骤后,可以将插件添加到编辑器中。
- 对于ONLYOFFICE服务器解决方案:将plugin文件夹放入Document Server文件夹,或仅将相应的行添加到配置中。
- 对于ONLYOFFICE Desktop Editors : 存档您的插件文件夹,将其扩展名更改为.plugin。然后,转到编辑器中的“插件”选项卡,单击“管理插件”→“添加插件”,浏览以找到.plugin文件并将其上传到应用程序。
- 对于Cloud Service和ONLYOFFICE Personal:在这种情况下,您可以将新插件添加为Chrome扩展程序。