跳到主要内容

Plugins

插件部分允许将特殊附加组件连接到您的 ONLYOFFICE 文档安装,这将帮助您向文档编辑器添加其他功能。

autostart

定义插件的标识符数组(在 config.json) 中输入),它将在编辑器打开时自动启动,并且插件将依次运行。

类型: array of string

示例: ["asc.{7327FC95-16DA-41D9-9AF2-0E7F449F6800}"]

options

定义一个允许从外部源配置插件的对象。可以为所有插件或特定插件设置设置。例如,此对象可用于将授权令牌传递给插件。您还可以使用 Automation APISetPluginsOptions 方法将 options 对象传递给插件。

类型: object

示例:

{
"all": {},
"pluginGuid": {}
}

options.all

定义将为所有插件设置的参数。

类型: object

示例:

{
"all": {
"keyAll": "valueAll"
}
}

options.pluginGuid

定义将为特定插件设置的参数。必须使用 asc.{UUID} 类型的插件 GUID 指定插件。

类型: object

示例:

{
"asc.{38E022EA-AD92-45FC-B22B-49DF39746DB4}": {
"keyYoutube": "valueYoutube"
}
}

pluginsData

定义插件配置文件 (config.json)的绝对 URL 数组。

类型: array of string

示例: ["https://example.com/plugins/chess-plugin/config.json"]

url

定义存储插件的目录的绝对 URL。自 4.3 版起已弃用,请在 pluginsData 字段中使用绝对 URL。

类型: string

示例: https://example.com/plugins/

插件

示例

const docEditor = new DocsAPI.DocEditor("placeholder", {
editorConfig: {
plugins: {
autostart: [
"asc.{7327FC95-16DA-41D9-9AF2-0E7F449F6800}",
],
options: {
"all": {
keyAll: "valueAll",
},
"asc.{38E022EA-AD92-45FC-B22B-49DF39746DB4}": {
keyYoutube: "valueYoutube",
},
},
pluginsData: [
"https://example.com/plugins/chess-plugin/config.json",
],
url: "https://example.com/plugins/",
},
},
})

此处的 example.com 表示安装文档存储服务的服务器名称。要深入了解ONLYOFFICE 文档服务的客户端-服务器交互机制,请参阅工作原理 章节。