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

Добавление пункта меню

В данной статье описан пример того, как добавить в левое меню свой раздел и вывести нужные данные при переходе в него.

Описание интерфейса

Для добавления раздела меню:

  • создайте xml файл ispmgr_mod_menu.xml

Путь должен быть обязательно /usr/local/mgr5/etc/xml/ и имя обязательно ispmgr_mod_<произвольное наименование>.xml

XML-файл должен иметь права на чтение и запись для пользователя root.

touch /usr/local/mgr5/etc/xml/ispmgr_mod_menu.xml
  • добавьте в этот файл следующее описание:
<?xml version="1.0" encoding="UTF-8"?>
<mgrdata>
        <mainmenu level="admin+">
                <modernmenu>
                        <node name="my_group">
                                <node name="myfunc" />
                        </node>
                </modernmenu>
        </mainmenu>

        <handler name="myaddon.sh" type="xml">
                <func name="myfunc" />
        </handler>

        <lang name="ru">
                <messages name="desktop">
                        <msg name="modernmenu_my_group">New menu item</msg>
                        <msg name="modernmenu_myfunc">Test</msg>
                </messages>
        </lang>
</mgrdata>

Как видно из файла, в теге mainmenu указывается на каком уровне будет виден раздел. В примере — admin+ — уровень суперадминистратора.

node_name='administrator' - новый пункт меню будет добавлен в раздел 'Администраторы';

node_name='my_group' - новый пункт меню будет добавлен в раздел, созданный пользователем;

node_name ='myfunc' - объявляем свою функцию. Чтобы панель начала отображать наш пункт меню необходимо, чтобы в панели была функция с соответствующим названием.

Добавление собственной функции

  • Добавляем обработчик функции myaddon (уже добавили в файле ispmanager_mod_menu.xml):
<handler name="myaddon.sh" type="xml"> 
<func name="myfunc" /> 
</handler>
  • Аддон должен быть расположен в директории /usr/local/mgr5/addon/
  • Создайте в директории /usr/local/mgr5/addon  файл myaddon.xml:
touch myaddon.xml

Добавьте в файл плагин (то, что будет отображаться на странице созданного раздела, не забываем указывать имя добавленной нами функции func="myfunc".

<?xml version="1.0" encoding="UTF-8"?>
<doc lang="ru" func="myfunc" binary="/ispmgr">
        <metadata name="myfunc" type="list" key="name" mgr="ispmgr">
                <toolbar view="buttontext">
                        <toolgrp name="new">
                                <toolbtn name="new" func="webdomain.edit" type="new" img="t-new" sprite="yes"/>
                                <toolbtn name="delete" func="webdomain.delete" type="group" img="t-delete" sprite="yes"/>ls 
                        </toolgrp>
                </toolbar>

                <coldata>
                        <col type="data" name="name" sort="alpha" convert="punycode" sorted="-1"/>
                        <col type="data" name="value" sort="alpha" level="reseller+"/>
                </coldata>
        </metadata>
        <messages name="myfunc" checked="6b49a92f5cc5153c76b78446d0d74eb4">
                <msg name="title">Test</msg>
                <msg name="hint_name"> Название </msg>
                <msg name="hint_value">Значение</msg>
                <msg name="short_new" added="common">Создать</msg>
                <msg name="short_delete" added="common">Удалить</msg>
                <msg name="hint_delete" added="common">Удалить</msg>
                <msg name="hint_new" added="common">Создать</msg>
                <msg name="name" added="common">Имя</msg>
                <msg name="value" added="common">Значение</msg>
                <msg name="hint_export">Сохранить в CSV</msg>
                <msg name="hint_selectall">Выделить все элементы списка</msg>
                <msg name="hint_reloadlist">Обновить данные</msg>
                <msg name="hint_print">Открыть версию для печати</msg>
                <msg name="hint_autoupdate_stop">Отменить автообновление текущего списка</msg>
                <msg name="hint_takefavorite">Добавить в избранное меню</msg>
                <msg name="hint_takeunfavorite">Убрать из избранного меню</msg>
                <msg name="msg_tsetting">Настроить вид таблицы</msg>
        </messages>

        <tparams>
                <out>devel</out>
                <func>myfunc</func>
        </tparams>
        <p_sort>name</p_sort>
        <p_order>desc</p_order>
        <page>test.ru — domain.mary</page>
        <elem>
                <name>One</name>
                <value>Hello</value>
        </elem>
        <elem>
                <name>Two</name>
                <value>World!</value>
        </elem>
        <p_num>1</p_num>
        <p_elems>6</p_elems>
</doc>
Подробнее с вариантами написания плагинов можно ознакомиться в документации
Пожалуйста, обратите внимание, что оказание услуг технической поддержки на написанные самостоятельно плагины не распространяется.
  • Создаем в папке addon файл myaddon.sh (добавляем обработчик)
touch myaddon.sh
  • Установите права для обработчика следующими командами:
chmod 750 /usr/local/mgr5/addon/<имя_файла_обработчика>
chown 0:0 /usr/local/mgr5/addon/<имя_файла_обработчика>
  • Добавляем две строчки в файл myaddon.sh
#!/bin/bash 
cat /usr/local/mgr5/addon/myaddon.xml

Чтобы панель перечитала все изменения перезапускаем ее командой  pkill -9 core

При нажатии на раздел Test (такое название ему присвоено в блоке lang), будет вызываться myaddon.sh, который должен вернуть панели полный xml с необходимыми данными.

Результат