Руководство для разработчиков

Центр уведомлений

Настройка уведомлений для пользователя

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

Пример команды добавления уведомления:

/usr/local/mgr5/sbin/mgrctl -m notify notify.post user=root "msg=Привет, мир!" level=danger

Где:

  • user – пользователь, для которого отправляется уведомление;
  • msg – текст уведомления;
  • level – тип сообщения; возможные значения:
    • info;
    • success;
    • warning;
    • danger.

Добавление в уведомление ссылки внутри панели

Для создания уведомления с ссылкой используйте утилиту mgrctl и параметр link, в котором необходимо передать JSON c описанием ссылки.

Пример команды добавления уведомления с ссылкой:

/usr/local/mgr5/sbin/mgrctl -m notify notify.post user=root "msg=Привет, мир!" level=danger link='{"type":"form", "value":"func=site.edit", "name":"hello_details"}'

Где параметр link содержит:

  • type – тип ссылки, доступно только form;
  • value – ссылка на функцию ispmanager. Помимо имени функции можно передавать параметры, к примеру, func=site.edit&elid=example.com;
  • name – имя локализованного сообщения из секции desktop. Для получения итогового внутреннего имени нужно добавить префикс notify_link_. Для добавления своего сообщения создайте файл xml. Например: /usr/local/mgr5/etc/xml/ispmgr_mod_notify.xml.

Пример наполнения xml-файла:

<?xml version="1.0" encoding="UTF-8"?>
<mgrdata>
  <lang name="ru">
    <messages name=desktop">
      <msg name="notify_link_hello_details">Ссылка для уведомления</msg>
  </lang>
</mgrdata>