Системные события

Системное событие – это начало или завершение какого-либо процесса, связанного с взаимодействием пользователя и системы, либо с выполнением системой определенных транзакций.

Для всех процессов, происходящих в системе, можно фиксировать момент до наступления процесса и после.

Например, необходимо совершить какое-то действие до сохранения документа в кэше, а потом еще одно действие - после загрузки документа из кэша. Момент, когда необходимо выполнить действие, называется событием, а то, что необходимо сделать, реализуется с помощью плагинов.

Системные события являются объектами PHP-платформы Wad-er и отображаются в Каталоге объектов. Для работы с системными событиями используется меню Элементы сайта – Настройки – Системные события панели управления. В правом фрейме системные события могут отображаться в виде дерева или таблицы.

Системные события разделены на группы:

• Интерфейсы;
• Обработка страницы
  • До печати готовой страницы;
  • До сохранения в кэше;
  • После добавления записи в лог;
  • После загрузки страницы из кэша;
  • После загрузки шаблона страницы;
  • После инициализации страницы;
  • После парсинга страницы;
  • После посещения страницы;
  • Страница не найдена (404);
• Отчеты
  • До формирования отчёта;
  • До формирования фильтров отчёта;
  • После формирования отчёта;
  • После формирования фильтров отчёта;
• Прочие события
  • После входа в систему;
  • После выхода из системы;
• События базового класса (wPrototype)
  • До добавления объекта;
  • До добавления свойств объекта;
  • До обновления объекта;
  • До отображения заголовка карточки объекта;
  • До удаления объекта;
  • До формирования ленты новостей;
  • До формирования формы объекта;
  • После добавления объекта;
  • После обновления объекта;
  • После удаления объекта;
  • После формирования формы объекта;
• Таймеры
  • Таймер popup окна;
• Файлы
  • До формирования списка файлов;
  • После добавления файла в список.

К одному событию можно подключить несколько плагинов. И наоборот, один плагин можно подвязать к нескольким событиям.

Для установления связи между плагинами и системными событиями используется меню Элементы сайта – Настройки – События-плагины панели управления.  

На этой странице отображается кросс-матрица События-Плагины. В этой матрице необходимо установить "+" на пересечении нужной строки (события) и столбца (плагина).

Программный вызов события осуществляется следующим образом:

$name  = 'sys_onAddLog';
$pars = array('type' => $type, 'objtype' => $objtype, 'objid' => $objid, 'id' => $f->id);
$parser->invokeEvent($name, $pars);

Здесь  $name – Код (Id) события, $pars – массив параметров, которые можно использовать внутри плагинов.