config.json лежит в корне папки плагина и описывает плагин: название, идентификатор, в каких редакторах он работает, как выглядит его окно и какие данные он получает. Редактор читает файл при открытии документа: после правки config.json откройте новый документ.
Пример
{
"name": "My plugin",
"nameLocale": { "ru": "Мой плагин" },
"guid": "asc.{6C8E0A2B-4D5F-4E7A-9B1C-3D5E7F9A1B2C}",
"version": "1.0.0",
"variations": [{
"description": "My plugin",
"descriptionLocale": { "ru": "Мой плагин" },
"url": "index.html",
"icons": ["resources/icon.png", "resources/icon@2x.png"],
"EditorsSupport": ["word", "cell", "slide"],
"isVisual": true,
"isModal": true,
"isInsideMode": false,
"initDataType": "text",
"initData": "",
"size": [420, 260],
"buttons": [
{ "text": "OK", "textLocale": { "ru": "Принять" }, "primary": true },
{ "text": "Cancel", "textLocale": { "ru": "Отмена" }, "primary": false }
],
"events": []
}]
}Логические значения задавайте без кавычек: true и false, а не "true".
Параметры плагина
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
name | строка | да | Название плагина: надпись кнопки на вкладке «Плагины», подсказка кнопки и заголовок окна плагина. |
nameLocale | объект | нет | Переводы названия, ключ — код языка: { "ru": "Мой плагин" }. Если перевода для языка интерфейса нет, берётся "en", затем name. |
guid | строка | да | Идентификатор плагина в формате asc.{UUID}. У каждого плагина свой. |
version | строка | нет | Версия плагина в формате X.Y.Z. Если два плагина с одним guid, редактор использует более новую версию. |
minVersion | строка | нет | Минимальная версия редактора. В Десктоп редакторах 2026.3.1 не действует: плагин показывается при любом значении. |
baseUrl | строка | нет | Адрес папки плагина. В config.json установленного плагина не указывается; обязателен в объекте для методов InstallPlugin ↗ и UpdatePlugin ↗. |
group | объект | нет | Группа кнопки на вкладке «Плагины»: { "name": "Имя группы", "rank": 1 }. rank задаёт порядок групп. |
variations | массив объектов | да | Вариации плагина. Первая — основное окно, остальные — дополнительные окна, например «О программе» или настройки. |
Параметры вариации
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
url | строка | — | Обязательный. HTML-файл плагина относительно его папки, обычно index.html ↗. |
description | строка | — | Описание вариации. |
descriptionLocale | объект | — | Переводы описания, как nameLocale. |
EditorsSupport | массив строк | — | Редакторы, в которых доступна вариация: "word" — документы, "cell" — таблицы, "slide" — презентации. |
icons | массив строк | — | Иконки кнопки: ["resources/icon.png", "resources/icon@2x.png"] — для обычного экрана и для масштаба 200%. |
icons2 | массив | — | Расширенное описание иконок (разные масштабы и темы). Если задан, используется вместо icons. Подробнее — в статье «Иконки плагина» ↗. |
help | строка | — | Адрес справки. Если задан, в заголовке окна плагина появляется кнопка «?». |
isVisual | логическое | — | true — у плагина есть окно или панель. false — плагин работает в фоне без интерфейса; так делаются, например, плагины с помощником ввода. |
isModal | логическое | false | true — пока окно открыто, документ недоступен. false — с документом можно работать при открытом окне. |
isInsideMode | логическое | false | true — плагин открывается на панели слева, а не в отдельном окне. |
size | массив [ширина, высота] | — | Размер области окна плагина в пикселях, без заголовка и кнопок. |
buttons | массив объектов | OK и Cancel | Кнопки внизу окна, см. таблицу ниже ↗. Нажатие приходит в обработчик button(id), id — номер кнопки с 0. Чтобы кнопок не было, укажите пустой массив. |
initDataType | строка | "none" | Что редактор передаёт в init при запуске: "none" — значение initData; "text" — выделенный текст; "html" — выделенный фрагмент в HTML с оформлением; "ole" — данные OLE-объекта плагина. |
initData | строка | "" | Данные для init при initDataType "none" |
initOnSelectionChanged | логическое | false | true — при каждой смене выделения редактор снова вызывает init с новыми данными. Имеет смысл для немодальных окон и панелей. |
events | массив строк | [] | События редактора, которые получает плагин. Список событий — в статье «События» ↗. |
isViewer | логическое | false | true — плагин доступен, когда документ открыт только для просмотра. |
isDisplayedInViewer | логическое | true | false — не показывать кнопку плагина в режиме просмотра, даже если isViewer равен true. |
isSystem | логическое | false | true — системный плагин: кнопки на вкладке нет, плагин запускается автоматически при открытии документа. |
isUpdateOleOnResize | логическое | false | Для плагинов с OLE-объектами: true — при изменении размера объекта редактор запускает плагин, чтобы тот перерисовал объект. |
Параметры кнопки
| Параметр | Тип | Описание |
|---|---|---|
text | строка | Надпись на кнопке. |
textLocale | объект | Переводы надписи: { "ru": "Принять" }. |
primary | логическое | true — основная кнопка, выделена цветом. |
isViewer | логическое | false — скрывать кнопку в режиме просмотра. |
Параметры плагинов шифрования
Параметры cryptoMode, cryptoDisabledOnStart, cryptoDisabledForInternalCloud и cryptoDisabledForExternalCloud относятся только к плагинам сквозного шифрования. Обычным плагинам их указывать не нужно.













