From In-Portal Developers Guide

Revision as of 11:53, 6 December 2008

This article is not finished yet! You see this message because current Article is finished yet or contains unverified information. How to write an Article.

События общего применения
Статьи в этой категории
OnItemBuild OnListBuild OnAfterConfigRead OnExport OnExportBegin OnBeforeExportBegin OnExportCancel OnDeleteExportPreset OnBeforeCSVLineImport

Событие OnAfterConfigRead происходит для каждого Unit на этапе инициализации системы, после того как в памяти уже собрана базовая конфигурация, основанная на Unit Configs. Соответственно, события OnAfterConfigRead генерируются модулем, ответственным за считывание конфигурации - kUnitConfigReader.

По умолчанию тело метода OnAfterConfigRead пусто. Однако, это событие широко используется для изменения базовой конфигурации - путём переопределения в классе-наследнике, либо путём создания hook к событию OnAfterConfigRead нужного префикса.

Вызывается из шаблона

Не вызывается из шаблонов.

Вызывается из событий

Не вызывается из событий.

Входные параметры

Отсутствуют.

Вызывает события

Не вызывает события.

Потенциальное применение

В событии OnAfterConfigRead можно переопределить поля базы данных, шаблоны, классы, секции в главном меню административной части сайта и любые другие настройки, доступные в Unit Configs без изменения базовых конфигурационных файлов.

Пример - делаем поле обязательным для ввода.

$fields = $this->Application->getUnitOption($event->Prefix, 'Fields');
$fields['FirstName']['required'] = 1;
$fields['LastName']['required'] = 1;
$this->Application->setUnitOption($event->Prefix, 'Fields', $fields);

Типичные действия таковы -

1. методом Application::getUnitOption считывается часть конфигурационного массива
2. делаются необходимые изменения в полученном ассоциативном массиве
3. методом Application::setUnitOption перезаписывется конфигурация

Ограничения

Особых ограничений нет.

Использует вспомогательные методы класса

Не использует вспомогательные методы класса.