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

OnBeforeBlogAdd

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

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

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

ПараметрОписание
arParams Массив полей блога.

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

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

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

См. также

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

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


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


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