Перейти к основному содержимому
Версия: 9.0

Главное меню

Администраторам пространства доступна возможность редактирования логотипа пространства, а так же полная кастомизация редактируемой части главного меню.

Логотип пространства в меню​

Чтобы загрузить собственный логотип для пространства, администратор должен выполнить следующие действия:

  1. В таблице Userspaces сервиса pl_userspaces_api_service установить флаг UseCustomIcon = true

  2. Загрузить файл через REST-запрос:

    curl --location --request POST 'https://api.<домен-monq>/api/pl/userspaces/<id-пространства>/logo?size=1' \
        --header 'x-smon-userspace-id: <id-пространства>' \
        --header 'Authorization: Bearer <токен-админа>' \
        --form '=@"/путь/к/иконке.png"'
    Допустимые форматы: .png, .jpg, .bmp

  3. Очистить кэш сервиса:

    pl-userspaces monqctl instance clear cache --microservice=pl-userspaces-api-service

После очистки кэша обновленный логотип начнет отображаться пользователям пространства.

Кастомизация меню​

Основной состав меню определяется вендором и может меняться от версии к версии по мере развития продукта.

Однако помимо основных пунктов присутствует и изменяемая часть меню.
В базовой конфигурации в этой секции содержится только пункт «Помощь», ведущий на публичную документацию Monq.

Администраторы с доступом на редактирование БД таблицы UserspaceSystemModuleConfigs микросервиса pl_userspaces_api_service, могут расширять меню для всего пространства через конфигурацию main-menu-custom.

Администратор может:

  • Добавлять как пункты первого уровня, так и вложенные
  • Задавать подходящую иконку из списка доступных для отображения раздела верхнего уровня
  • Определять порядок отображения пунктов
    пункты изменяемой части меню всегда отображаются ниже основных

    Администратор может определить порядок только внутри самого раздела

  • В текущей версии локализация не поддерживается, поэтому добавленные пункты отображаются одинаково на всех языках

Изображение

Пример базовой конфигурации
{
  "menuItems": [
  	{
  		"url": "https://docs.monq.ru/",
  		"icon": "help",
  		"name": "side-menu.help",
  		"type": "Menu",
  		"order": 20,
  		"parent": null,
  		"position": "Bottom",
  		"utlTarget": "_blank",
  		"moduleName": "pl"
  	}
  ]
}
Пример конфигурации дополненного меню
{
"menuItems": [
  {
    "url": "https://grafana.in.monq.ru/?orgId=2",
    "icon": "custom/custom-3",
    "name": "Дашборды",
    "type": "Menu",
    "order": 19,
    "parent": null,
    "position": "Bottom",
    "utlTarget": "_blank",
    "moduleName": "pl"
  },
  {
    "icon": "help",
    "name": "side-menu.help",
    "type": "Menu",
    "order": 20,
    "parent": null,
    "position": "Bottom",
    "moduleName": "pl"
  },
  {
    "url": "https://docs.monq.ru",
    "icon": "help",
    "name": "Документация",
    "type": "Link",
    "order": 21,
    "parent": "side-menu.help",
    "position": "Bottom",
    "utlTarget": "_blank",
    "moduleName": "pl"
  },
  {
    "url": "https://t.me/monq_community_ru",
    "icon": "chat",
    "name": "Чат",
    "type": "Link",
    "order": 22,
    "parent": "side-menu.help",
    "position": "Bottom",
    "utlTarget": "_blank",
    "moduleName": "pl"
  }
]
}

Список доступных иконок​

При формировании main-menu-custom можно использовать следующий набор иконок, указывая их названия:

Изображение