Пример плагина. Работа с шаблонизатором

Задача: добавить галку с названием "1С-Битрикс" на форму редактирования домена. В зависимости от галки в файл конфигурации Apache будет прописываться разное значение для директивы open_basedir:

• галка включена — open_basedir принимает значение "none";
• галка выключена — open_basedir принимает значение равное домашней директории домена.

Плагин обычно состоит из XML файла описания плагина, где можно добавлять/скрывать элементы интерфейса, а также там описывается обработчик — скрипт, который будет вызываться перед или после действий панели правления. XML всегда должен быть расположен в директории /usr/local/mgr5/etc/xml/ и называться ispmgr_mod_.xml, например /usr/local/mgr5/etc/xml/ispmgr_mod_bitrix.xml

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

XML описание плагина

<?xml version="1.0" encoding="UTF-8"?>
<mgrdata>

<handler name="bitrix" type="xml"> 
         <event name="webdomain.edit" after="yes" /> 
</handler>

<metadata name="webdomain.edit" type="form">
	<form>
	<page name="domain">
		<field name="bitrix">
          	<input type="checkbox" name="bitrix"/>
		</field>
	</page>
	</form>	
</metadata>

<lang name="ru">
	<messages name="webdomain.edit">
	<msg name="bitrix">1С-Битрикс</msg>
	<msg name="hint_bitrix">Отметьте галку, чтобы сформировать оптимальные файлы конфигурации для 1С-Битрикс</msg>
	</messages>
</lang>

<lang name="en">
        <messages name="webdomain.edit">
        <msg name="bitrix">1C-Bitrix</msg>
        </messages>
</lang>
</mgrdata>

Блок metadata описывает, что на форму (type="form") редактирования веб домена (name="webdomain.edit") на вкладку WWW-домен (page name="domain") добавляем новое поле (name="bitrix") с типом чекбокс (type="checkbox").

Блок handler описывает, что после (after="yes") редактирования веб домена (webdomain.edit) будет вызываться скрипт с названием bitrix (handler name="bitrix") и типом xml (type="xml").

Тип xml означает, что скрипту на вход (stdin) будет передан от панели управления xml файл с параметрами. Плагин в свою очередь должен вернуть панели такой же xml на выходе (stdout), где могут быть добавлены собственные параметры или изменено значение существующих.

Блок lang определяет описание и подсказку на русском и английском языках.

После того, как добавлена собственная xml необходимо перезапустить панель управления командой:

/usr/local/mgr5/sbin/mgrctl -m ispmgr exit

Обработчик

Скрипт обработчика должен всегда располагаться в директории /usr/local/mgr5/addon . Файл должен называться так, как это обозначено в xml в секции handler. В текущем примере это файл /usr/local/mgr5/addon/bitrix , который имеет следующее содержимое:

#!/bin/bash 

if [[ "$PARAM_bitrix" = "on" ]] 
        then    
                cat | sed 's|</doc>$|<params><CUSTOM_BASEDIR>none</CUSTOM_BASEDIR></params></doc>|'
        else    
                cat | sed 's|</doc>$|<params><CUSTOM_BASEDIR>'$PARAM_docroot':.</CUSTOM_BASEDIR></params></doc>|'
fi

Установите права для обработчика следующими командами:

chmod 750 /usr/local/mgr5/addon/<имя_файла_обработчика>
chown 0:0 /usr/local/mgr5/addon/<имя_файла_обработчика>

В условии проверяется значение переменной $PARAM_bitrix. Некоторые параметры панель управления передает в переменные окружения и их можно использовать в обработчике плагина. $PARAM_bitrix — переменная, которая принимает значение on, если на форме редактирования домена отмечена галка "1С-Битрикс" и значение off, если галка не отмечена.

На выход плагин отдает панели точно такой же xml файл, что получил на вход, но добавляет в xml собственный параметр — CUSTOM_BASEDIR, который принимает значение none, если галка "1C-Битрикс" отмечена или принимает значение <домашняя директория домена>, если галка не отмечена.

Теперь остается отредактировать файл шаблонизатора , именно он определяет какие директивы будут прописываться в файл конфигурации Apache.

В файле /usr/local/mgr5/etc/templates/apache2-vhosts.template меняем строки:

php_admin_value open_basedir "{% $BASEDIR_PATH %}"

на

php_admin_value open_basedir "{% $CUSTOM_BASEDIR %}"

Теперь значение open_basedir будет определяться переменной CUSTOM_BASEDIR, которую мы сами добавляем с помощью плагина и определяем сами ее значение в зависимости от отмеченной/не отмеченной галки "1C-Битрикс" на форме редактирования домена.