notifications_send.before
Срабатывает перед отправкой всех уведомлений о заказах, настроенных для каждого события. Позволяет изменить содержимое отправляемых уведомлений.
Доступно начиная с версии 8.0.0.
Shop-Script
Входящие параметры (передаются по ссылке)
$params['event'] string Идентификатор события.
$params['notifications'] array Список уведомлений, настроенных для данного события. Каждый элемент списка — массив со следующими ключами:
$params['notifications'][]['id'] int ID уведомления.
$params['notifications'][]['name'] string Название уведомления.
$params['notifications'][]['transport'] string Обозначение транспорта отправки: 'email', 'sms', 'http'.
$params['notifications'][]['subject'] string Тема email-уведомления.
$params['notifications'][]['body'] string Шаблон email-уведомления.
$params['notifications'][]['text'] string Шаблон SMS-уведомления.
$params['notifications'][]['to'] string Получатель уведомления: 'customer' (покупатель), 'admin' (администратор магазина) или указанный адрес электронной почты (для email-уведомлений) либо номер телефона (для SMS-уведомлений).
$params['data'] array Дополнительные данные в виде массива со следующими ключами:
$params['data']['order'] array Свойства заказа в виде массива со следующими ключами:
$params['data']['order']['id'] int ID заказа.
$params['data']['order']['id'] int ID заказа.
$params['data']['order']['contact_id'] int ID контакта покупателя.
$params['data']['order']['create_datetime'] datetime Дата и время создания.
$params['data']['order']['update_datetime'] datetime Дата и время обновления.
$params['data']['order']['state_id'] string Идентификатор статуса.
$params['data']['order']['total'] float Стоимость заказа.
$params['data']['order']['currency'] string 3-буквенное обозначение валюты заказа.
$params['data']['order']['rate'] float 3-буквенное обозначение валюты заказа.
$params['data']['order']['tax'] float Размер рассчитанной суммы налога.
$params['data']['order']['shipping'] float Стоимость доставки.
$params['data']['order']['discount'] float Размер скидки.
$params['data']['order']['paid_year'] int Номер года из даты оплаты заказа.
$params['data']['order']['paid_quarter'] int Номер квартала года из даты оплаты заказа.
$params['data']['order']['paid_month'] int Номер месяца из даты оплаты заказа.
$params['data']['order']['paid_date'] date Дата оплаты заказа.
$params['data']['order']['paid_datetime'] datetime Дата и время оплаты заказа.
$params['data']['order']['is_first'] datetime Дата и время оплаты заказа.
$params['data']['order']['comment'] string Комментарий к заказу.
$params['data']['order']['shipping_datetime'] datetime|null Дата и время, соответствующие концу периода времени, выбранному в поле «Доставка курьером» при выполнении действия «Изменить параметры доставки».
$params['data']['order']['courier_contact_id'] int|null ID контакта выбранного курьера.
$params['data']['order']['id_str'] string Форматированный ID заказа.
$params['data']['order']['total_str'] string Локализованное обозначение стоимости заказа в валюте, подготовленное для отображения в HTML-коде веб-страницы.
$params['data']['order']['create_datetime_str'] string Локализованное обозначение даты и времени создания заказа.
$params['data']['order']['payment_url'] string URL ссылки на оплату.
$params['data']['order']['state'] object Экземпляр класса
$params['data']['order']['params'] array Параметры заказа в виде массива со следующими ключами:
$params['data']['order']['params']['auth_pin'] int PIN-код для просмотра статуса заказа.
$params['data']['order']['params']['coupon_code'] string|null Название применённого купона.
$params['data']['order']['params']['coupon_discount'] float|null Размер скидки по применённому купону.
$params['data']['order']['params']['coupon_id'] int ID применённого купона.
$params['data']['order']['params']['customer_timezone'] string Обозначение часового пояса покупателя.
$params['data']['order']['params']['departure_datetime'] datetime Рассчитанные дата и время готовности заказа к отправке.
$params['data']['order']['params']['ip'] string IP-адрес покупателя.
$params['data']['order']['params']['landing'] string Относительный URL страницы, с которой покупатель начал посещение сайта.
$params['data']['order']['params']['payment_id'] int ID выбранного способа оплаты.
$params['data']['order']['params']['payment_name'] string Название выбранного способа оплаты.
$params['data']['order']['params']['payment_plugin'] string Идентификатор плагина выбранного способа оплаты.
$params['data']['order']['params']['sales_channel'] string Обозначение канала продаж.
$params['data']['order']['params']['shipping_address.city'] string Название населённого пункта в адресе доставки.
$params['data']['order']['params']['shipping_address.country'] string 3-буквенное обозначение страны в адресе доставки.
$params['data']['order']['params']['shipping_address.region'] mixed Код региона в адресе доставки.
$params['data']['order']['params']['shipping_currency'] string 3-буквенное обозначение валюты стоимости доставки.
$params['data']['order']['params']['shipping_currency_rate'] float Курс валюты стоимости доставки к основной валюте магазина.
$params['data']['order']['params']['shipping_id'] int ID выбранного способа доставки.
$params['data']['order']['params']['shipping_name'] string Название выбранного способа доставки.
$params['data']['order']['params']['shipping_rate_id'] string Название выбранного варианта доставки.
$params['data']['order']['params']['storefront'] string Адрес витрины, на которой оформлен заказ.
$params['data']['order']['params']['user_agent'] string Обозначение User-Agent браузера покупателя.
$params['data']['order']['params']['tracking_number'] string Идентификатор отправления.
$params['data']['customer'] object Экземпляр класса
$params['data']['status'] string Название статуса заказа.
$params['data']['action_data'] array Свойства действия с заказом, соответствующее событию, для которого были отправлены уведомления.
$params['data']['action_data']['text'] string Текст, введённый сотрудником магазина при выполнении действия с заказом.
$params['notifications'] array Список уведомлений, настроенных для данного события. Каждый элемент списка — массив со следующими ключами:
$params['notifications'][]['id'] int ID уведомления.
$params['notifications'][]['name'] string Название уведомления.
$params['notifications'][]['transport'] string Обозначение транспорта отправки: 'email', 'sms', 'http'.
$params['notifications'][]['subject'] string Тема email-уведомления.
$params['notifications'][]['body'] string Шаблон email-уведомления.
$params['notifications'][]['text'] string Шаблон SMS-уведомления.
$params['notifications'][]['to'] string Получатель уведомления: 'customer' (покупатель), 'admin' (администратор магазина) или указанный адрес электронной почты (для email-уведомлений) либо номер телефона (для SMS-уведомлений).
$params['data'] array Дополнительные данные в виде массива со следующими ключами:
$params['data']['order'] array Свойства заказа в виде массива со следующими ключами:
$params['data']['order']['id'] int ID заказа.
$params['data']['order']['id'] int ID заказа.
$params['data']['order']['contact_id'] int ID контакта покупателя.
$params['data']['order']['create_datetime'] datetime Дата и время создания.
$params['data']['order']['update_datetime'] datetime Дата и время обновления.
$params['data']['order']['state_id'] string Идентификатор статуса.
$params['data']['order']['total'] float Стоимость заказа.
$params['data']['order']['currency'] string 3-буквенное обозначение валюты заказа.
$params['data']['order']['rate'] float 3-буквенное обозначение валюты заказа.
$params['data']['order']['tax'] float Размер рассчитанной суммы налога.
$params['data']['order']['shipping'] float Стоимость доставки.
$params['data']['order']['discount'] float Размер скидки.
$params['data']['order']['paid_year'] int Номер года из даты оплаты заказа.
$params['data']['order']['paid_quarter'] int Номер квартала года из даты оплаты заказа.
$params['data']['order']['paid_month'] int Номер месяца из даты оплаты заказа.
$params['data']['order']['paid_date'] date Дата оплаты заказа.
$params['data']['order']['paid_datetime'] datetime Дата и время оплаты заказа.
$params['data']['order']['is_first'] datetime Дата и время оплаты заказа.
$params['data']['order']['comment'] string Комментарий к заказу.
$params['data']['order']['shipping_datetime'] datetime|null Дата и время, соответствующие концу периода времени, выбранному в поле «Доставка курьером» при выполнении действия «Изменить параметры доставки».
$params['data']['order']['courier_contact_id'] int|null ID контакта выбранного курьера.
$params['data']['order']['id_str'] string Форматированный ID заказа.
$params['data']['order']['total_str'] string Локализованное обозначение стоимости заказа в валюте, подготовленное для отображения в HTML-коде веб-страницы.
$params['data']['order']['create_datetime_str'] string Локализованное обозначение даты и времени создания заказа.
$params['data']['order']['payment_url'] string URL ссылки на оплату.
$params['data']['order']['state'] object Экземпляр класса
shopWorkflowState, соответствующий статусу заказа.$params['data']['order']['params'] array Параметры заказа в виде массива со следующими ключами:
$params['data']['order']['params']['auth_pin'] int PIN-код для просмотра статуса заказа.
$params['data']['order']['params']['coupon_code'] string|null Название применённого купона.
$params['data']['order']['params']['coupon_discount'] float|null Размер скидки по применённому купону.
$params['data']['order']['params']['coupon_id'] int ID применённого купона.
$params['data']['order']['params']['customer_timezone'] string Обозначение часового пояса покупателя.
$params['data']['order']['params']['departure_datetime'] datetime Рассчитанные дата и время готовности заказа к отправке.
$params['data']['order']['params']['ip'] string IP-адрес покупателя.
$params['data']['order']['params']['landing'] string Относительный URL страницы, с которой покупатель начал посещение сайта.
$params['data']['order']['params']['payment_id'] int ID выбранного способа оплаты.
$params['data']['order']['params']['payment_name'] string Название выбранного способа оплаты.
$params['data']['order']['params']['payment_plugin'] string Идентификатор плагина выбранного способа оплаты.
$params['data']['order']['params']['sales_channel'] string Обозначение канала продаж.
$params['data']['order']['params']['shipping_address.city'] string Название населённого пункта в адресе доставки.
$params['data']['order']['params']['shipping_address.country'] string 3-буквенное обозначение страны в адресе доставки.
$params['data']['order']['params']['shipping_address.region'] mixed Код региона в адресе доставки.
$params['data']['order']['params']['shipping_currency'] string 3-буквенное обозначение валюты стоимости доставки.
$params['data']['order']['params']['shipping_currency_rate'] float Курс валюты стоимости доставки к основной валюте магазина.
$params['data']['order']['params']['shipping_id'] int ID выбранного способа доставки.
$params['data']['order']['params']['shipping_name'] string Название выбранного способа доставки.
$params['data']['order']['params']['shipping_rate_id'] string Название выбранного варианта доставки.
$params['data']['order']['params']['storefront'] string Адрес витрины, на которой оформлен заказ.
$params['data']['order']['params']['user_agent'] string Обозначение User-Agent браузера покупателя.
$params['data']['order']['params']['tracking_number'] string Идентификатор отправления.
$params['data']['customer'] object Экземпляр класса
shopCustomer со свойствами покупателя.$params['data']['status'] string Название статуса заказа.
$params['data']['action_data'] array Свойства действия с заказом, соответствующее событию, для которого были отправлены уведомления.
$params['data']['action_data']['text'] string Текст, введённый сотрудником магазина при выполнении действия с заказом.
… код плагина …
Результат работы плагина
Shop-Script
Пример кода плагина
PHP
public function notificationsSendBefore($params)
{
waLog::dump($params, 'shop/plugins/' . $this->id . '/notifications-send-before.log');
}









