Документация для разработчиков
Темная тема

OnBeforeBlogUpdate

Описание и параметры

bool
функция-обработчик(
 int   ID,
 array &arParams 
);

Событие вызывается в методе CBlog::Update до изменения блога и может быть использовано для отмены изменения или переопределения некоторых полей.

Параметры функции

ПараметрОписание
ID Идентификатор изменяемого блога.
arParams Массив полей блога.

Все параметры данного обработчика являются ссылками на исходные переменные. Поэтому, если вы измените значение параметра внутри обработчика, это приведет к смене значения исходной переменной, поступившей на вход функции-обработчика.

Возвращаемое значение

Для отмены изменения и прекращении выполнения метода CBlog::Update, необходимо в функции-обработчике создать исключение методом $APPLICATION->ThrowException() и вернуть false.

Смотрите также

Примеры использования

<?
// файл /bitrix/php_interface/init.php
// регистрируем обработчик
AddEventHandler("blog", 
                "OnBeforeBlogUpdate", 
                Array("MyClass", "OnBeforeBlogUpdateHandler"));


class MyClass
{
    // создаем обработчик события "OnBeforeBlogUpdate"
    function OnBeforeBlogUpdateHandler($ID, &$arFields)
    {
        if(strlen($arFields["DESCRIPTION"])<=0)
        {
            global $APPLICATION;
            $APPLICATION->throwException("Введите описание блога.");
            return false;
        }
    }
}
?>


© «Битрикс», 2001-2021, «1С-Битрикс», 2021
Наверх