method public static

YandexCampaignTable::onBeforeAdd()

Класс: \Bitrix\Seo\Adv\YandexCampaignTable

Сигнатура

public static onBeforeAdd(Event $event) : EventResult

Описание

Выполняет валидацию полей и добавляет новую кампанию Yandex.Direct.

Параметры

$event Event
Данные события.

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

EventResult

Как применяется в YandexCampaignTable

YandexCampaignTable::onBeforeAdd() — метод класса \Bitrix\Seo\Adv\YandexCampaignTable модуля «Поисковая оптимизация». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_YandexCampaign, наборы — как EO_YandexCampaign_Collection. Метод достаётся YandexCampaignTable от DataManager::onBeforeAdd: поведение общее для всех сущностей, а данные, поля и классы — свои.

Событие OnBeforeAdd сущности YandexCampaignTable. Статический метод в классе — обработчик по умолчанию; чтобы вмешаться в запись из своего кода, подпишитесь на событие через ORM-менеджер событий \Bitrix\Main\ORM\EventManager: он принимает класс сущности и код события из константы.

use Bitrix\Main\Loader;
use Bitrix\Main\ORM\EventManager;
use Bitrix\Main\ORM\Event;
use Bitrix\Main\ORM\EventResult;
use Bitrix\Main\ORM\EntityError;
use Bitrix\Seo\Adv\YandexCampaignTable;

Loader::includeModule('seo');

EventManager::getInstance()->addEventHandler(
    YandexCampaignTable::class,
    YandexCampaignTable::EVENT_ON_BEFORE_ADD,
    function (Event $event) {
        $fields = $event->getParameter('fields');
        $result = new EventResult();
        // $result->addError(new EntityError('Причина отказа'));
        return $result;
    }
);

Собственные методы YandexCampaignTable

  • getEngine() Возвращает ссылку на объект транспортного движка.
  • getFilePath() Возвращает путь к файлу, содержащему определение класса.
  • setSkipRemoteUpdate()

onBeforeAdd() есть и у других классов модуля «Поисковая оптимизация»: AdvEntity, AutologTable, LogTable, OrderTable, YandexBannerTable, YandexGroupTable, YandexRegionTable.

Исходный файл: source/seo/lib/adv/yandexcampaign.php:148

Что будем искать? Например,Продвижение