Разработчикам

События административного раздела: OnAdminContextMenuShow, OnAdminListDisplay, OnAdminTabControlBegin

Пользователь 11948 -> Всем

1 Март, 2011 1:01

Буквально недавно вышло чудное обновление главного модуля 9.5.10, в котором помимо прочего прилетела одна вкусность, идеологию которой я попытаюсь объяснить.
[spoiler]
С чего все началось. С открытием Marketplace все больше разработчиков начало создавать свои решения. Но все уперлось в то, что для добавления одной незначительной детали требовалось создавать не только свои модули, но и целые административные страницы, дублирующие уже существующие. Ну, например, чтобы расширить тип баннера своими настройками, нужно создавать свою копию страницы редактирования типа баннера. Мягко говоря, неудобно.

Решить эту проблему (хотя бы как-то) призваны следующие события:

OnAdminContextMenuShow:

OnAdminListDisplay:

(Да, прилетающий массив содержит ссылки на все эти элементы, доступы вы сможете получить к любому, дополнив список, или изменив его. Фактически вам отдается вообще весь контент списка. Возможности безграничны.)

OnAdminTabControlBegin

Все события имеют документацию, где в принципе все понятно объяснено. Я же опишу философию, что ли, применения. Рассмотрю на примере последнего события.

Итак, задача нашего модуля (а эти события прежде всего призваны помогать создавать удобные массовые решения, повторюсь) это снабдить каждый инфоблок настройкой "отправлять уведомления на e-mail об изменениях элементов". Этакий Документооборот на Старте.

Добавляем новый таб с чудо-HTML-вставкой:

За это отвечает такой код:

AddEventHandler('main', 'OnAdminTabControlBegin', 'MyOnAdminTabControlBegin');
function MyOnAdminTabControlBegin(&$form)
{
   if($GLOBALS['APPLICATION']->GetCurPage()=='/bitrix/admin/iblock_edit.php' && $_REQUEST['ID']>0)
   {
      $checked = COption::GetOptionString('main', 'asd_ib_send_'.$_REQUEST['ID']);
      $form->tabs[] = array('DIV' => 'ib_add_edit', 'TAB' => 'Дополнительно', 'TITLE' => 'Дополнительные параметры', 'CONTENT'=>
         '<tr valign="top">
            <td width="50%">Отсылать уведомление при добавлении элемента:</td>
            <td width="50%"><input type="checkbox" name="asd_ib_send_'.$_REQUEST['ID'].'" value="Y"'.($checked=='Y' ? ' checked="checked"' : '').' /></td>
         </tr>'
      );
   }
}

Как видите, с помощью COption::GetOptionString проверяем, установлена ли галочка. А как ее установить-то? Идем далее.

Тут нам поможет уже довольно старый обработчик OnBeforeProlog:

AddEventHandler('main', 'OnBeforeProlog', 'MyOnBeforePrologHandler');
function MyOnBeforePrologHandler()
{
   if ($_SERVER['REQUEST_METHOD']=='POST' && $GLOBALS['APPLICATION']->GetCurPage()=='/bitrix/admin/iblock_edit.php' && $_REQUEST['ID']>0)
   {
      COption::SetOptionString('main', 'asd_ib_send_'.$_REQUEST['ID'], $_REQUEST['asd_ib_send_'.$_REQUEST['ID']]=='Y' ? 'Y' : 'N');
   }
}

Ну все, дело за малым - при добавлении элемента ИБ просто проверяем стоит ли данная галочка - и если стоит, то шлем мыло