Donutgramплагины
На этой страницеНативные настройки

Настройки плагина

Системные контролы из схемы и отдельные команды на странице настроек.

Нативные настройки

Для простых параметров объявите settingsSchema в манифесте. Приложение построит страницу настроек, а плагин прочитает сохранённые значения через api.settings.get().

Типы полей

Тип Пример
boolean Переключатель функции
string Шаблон или собственная замена
number, integer Ограниченное числовое значение
Поле с enum Выбор одного из допустимых значений
{
  "settingsSchema": {
    "type": "object",
    "properties": {
      "mode": {
        "type": "string",
        "title": "Режим",
        "default": "short",
        "enum": ["short", "full"]
      }
    }
  }
}

Кнопка в настройках

Зарегистрируйте команду с placement: "settings". Объявите ui.contribute / settings.

await api.commands.register({
  id: "open-tools",
  title: "Команды и свои замены",
  placement: "settings",
  async run() {
    await api.ui.render({
      id: "tools",
      title: "Мои команды",
      nodes: [{ id: "intro", type: "text", text: "Добавьте свою замену" }]
    });
  }
});

Команда выполняется только при работающем runtime. Статические поля схемы и сведения об установленном пакете не требуют выполнения собственного UI-кода плагина.

Своя страница

Для нескольких действий, изображений или зависимых контролов используйте ui.render. Это нативное описание страницы, а не HTML или WebView.

Хранение

Ключи и типы должны оставаться совместимыми между обновлениями. Подробности чтения и записи — в сохранении настроек.