Почтовые события

Управлять автоматическими почтовыми сообщениями и уведомлениями можно в панели администратора

В панели администратора можно создавать почтовые события и управлять отправляемыми сообщениями посетителям сайта и администратору. Здесь рассмотрены названия почтовых событий и доступные элементы, которые можно использовать в текстах сообщений.

Поля в панели администратора

Событие - выбираем тип почтового события
Сайт - указываем сайт (можно настроить разные сообщения для каждого сайта)
Название - понятное название для администратора
Примечания - пояснение к почтовому событию или инструкция
Тема письма - обязательное поле, тема, которая будет отправлена получателю
Текст письма - обазтельное поле, текст сообщения
Активность - работает событие или нет
Формат письма HTML - активировать HTML в письме
Письмо пользователю - покупателю, автору вопроса и т.д.
Письмо администратору - берётся из настроек сайта
Доп.адреса - можно дополнительно указать адрес (или через запятую несколько адресов), куда отправить уведомление
SMS - отправить SMS сообщение
Телефон - номер для СМС в международном формате. Например, +79261234567. Можно указать несколько номеров через запятую.

Вызов почтового события

$ar = prepare_order_info($id, $message);
send_email_event($event, $ar);

Массив данных для использования в шаблоне

$event - название почтового события, например, order_new

$ar - массив передаваемых в шаблон почтового события данных.
При создании собственного скрипта обязательно укажите данные пользователя в массиве $ar['customer'] = array( 'email' => 'test@simpla.es',  'name' => 'Ivan' );

Сгенерировать массив можно, запросив функции:

prepare_order_info($id, $message);
prepare_fb_info($id, $message);
prepare_user_info($id, $message);
prepare_subs_info($id, $message);

Описание стандартных почтовых событий

Событие Описание
order_new Новый заказ
order_paid Заказ оплачен
order_remind Напомнить про заказ
order_done Заказ выполнен
order_comment Комментарий в заказе
order_new_manager Назначен новый исполнитель
fb_new Новый запрос через форму обратной связи
fb_comment Комментарий к запросу
page_comment Комментарий на странице
subscriber_cancel Подписка отменена
subscriber_invitation Предложение подписки на новости
subscriber_new Новый подписчик
user_invitation Ссылка для активации аккаунта
user_new Новый пользователь
user_lost_password Ссылка на сброс пароля
user_password_changed Пароль изменен

Почтовые события расширенной версии с CRM

Событие Описание
crm_project_new Новый проект
crm_project_changed Проект изменен
crm_project_deleted Проект удален
crm_project_comment Комментарий в проекте
crm_post_new Новая публикация
crm_post_comment Комментарий к публикации
crm_post_changed Публикация изменена
crm_post_deleted Публикация удалена
crm_task_new Новая задача
crm_task_comment Комментарий к задаче
crm_task_status Статус задачи изменен
crm_task_deleted Задача удалена
crm_deal_new Новый договор
crm_deal_comment Комментарий к договору
crm_deal_updated Договор изменен
crm_deal_status Изменен статус договора
crm_deal_deleted Договор удален
crm_invoice_new Новый счет
crm_invoice_comment Комментарий к счету
crm_invoice_updated Счет изменен
crm_invoice_status Статус счета изменен
crm_invoice_deleted Счет удален
crm_fin_new Новая финансовая операция
crm_fin_status Статус финансовой операции изменен
crm_fin_deleted Финансовая операция удалена
crm_contact_new Новый контакт
crm_contact_deleted Контакт удален
crm_contact_comment Комментарий к контакту
crm_contact_updated Контакт изменен

Далее расписаны элементы, которые можно использовать в шаблоне сообщений.

Внимание, если в заказе или запросе установлен исполнитель, то ему будут приходить все комментарии по этому заказу! Для этого не обязательно создавать почтовое событие, а если оно создано для настройки текста сообщения, то установка опций адреса отправки не требуется, достаточно указать текст.

Информация о заказе

Актуально для почтовых событий order_new, order_done, order_remind, order_paid и order_comment.

Если добавляется статус заказа, то при поиске уведомления для этого статуса идет запрос по названию order_меткастатуса. Например, после добавления статуса заказа delivery, будет отправляться уведомление order_delivery.

Элемент Описание Пример
$ar.order.order_id Номер заказа 12341234
$ar.order.id_formatted Отформатированный номер 1234-1234
$ar.site Название сайта Симпла
$ar.site_url Ссылка на сайт http://ru.simpla.es
$ar.order.status_title Название статуса Выполнен
$ar.order.phone Телефон покупателя 4343343434
$ar.order.address Адрес покупателя Москва, Красная площадь, д.1
$ar.order.memo Примечание к заказу Доставить после 19-00
$ar.order.delivery_title Название способа доставки Курьерская доставка
$ar.order.delivery_price Стоимость доставки 0
$ar.order.payd_status Статус оплаты, 1 или 0 (1 = оплачен) 0
$ar.order.coupon Название купона, если был применен COUPON1
$ar.order.url Ссылка на страницу заказа http://ru.simpla.es/order/?done=123456789
$ar.order.tinyurl Короткая ссылка на заказ http://ru.simpla.es/o/1234567
$ar.order.created Дата заказа 2016-06-27 17:07:36
$ar.order.created_f Дата отформатированная 27.06.2016 17:07
$ar.order.last_edit_f Последнее обновление 10.07.2016 21:27
Товары в заказе
$ar.cart Массив товаров Array
$ar.cart.title Название товара Книга
$ar.cart.title_link Ссылка на товар http://ru.simpla.es/book/
$ar.cart.price Цена 97.00
$ar.cart.discount Скидка 0
$ar.cart.currency Валюта rur
$ar.cart.qty Количество 1
$ar.cart.summ Сумма 97
Общая сумма заказа
$ar.total_summ Массив Array
$ar.total_summ.currency Валюта rur
$ar.total_summ.summ Сумма 97
$ar.total_summ.delivery Доставка 0
$ar.total_summ.discount Скидка 0
$ar.total_summ.total Итого 1097
$ar.total_summ.total_formatted Отформатированная сумма 1 097
$ar.total_summ.total_text Сумма текстом Девяносто семь рублей 00 копеек
Менеджер
$ar.manager.name Имя менеджера Александр
$ar.manager.login Логин менеджера alexander
$ar.manager.email Эл.почта менеджера alex@simpla.es
Покупатель
$ar.customer.email Эл.почта ivan@simpla.es
$ar.customer.name Имя Иван
Комментарий
$ar.message Текст комментария к заказу Ваш заказ ожидает оплату

Информация о запросе / форме обратной связи

Актуально для почтовых событий fb_new и fb_comment.

 

Элемент Описание Пример
$ar.id Номер 12
$ar.id_formatted Тикет 2016-06-GZLB-ZBKT-LUVJ
$ar.ticket Тикет 2016-06-GZLB-ZBKT-LUVJ
$ar.phone Телефон +7 (123) 456-78-90
$ar.subject Тема Тема сообщения
$ar.created Дата 2016-05-23 12:45:12
$ar.created_f Дата форматированная 23.05.2016 12:45
$ar.status Статус (1 - ответ выслан, 0 - нет) 1
$ar.ip_address IP адрес отправителя 1.2.3.4
$ar.from_page С какой страницы отправлена http://ru.simpla.es
$ar.message_original Текст первого сообщения Текст запроса
$ar.type Метка формы form1
$ar.comments Комментарии к запросу Массив с элементами:
id
userid
message
created
ip_address
active
notify
username
$ar.url Ссылка на запрос http://...
$ar.tinyurl Короткая ссылка http://...
Последний комментарий
$ar.last_comment.username Автор комментария Админ
$ar.last_comment.created_f Дата последнего комментария 23.05.2016 12:45
$ar.last_comment.message Текст комментария Сам текст
Менеджер
$ar.manager.name Имя менеджера Александр
$ar.manager.login Логин менеджера alexander
$ar.manager.email Эл.почта менеджера alex@simpla.es
Покупатель
$ar.customer.email Эл.почта ivan@simpla.es
$ar.customer.name Имя Иван
Комментарий
$ar.message Текст комментария к заказу Ваш заказ ожидает оплату

Информация о странице

Актуально для почтовых событий page_comment.

Элемент Описание Пример
$ar.id Номер страницы 12
$ar.url Ссылка на страницу http://ru.simpla.es/reviews/
$ar.title Заголовок страницы Отзывы посетителей
$ar.message Текст сообщения Хороший сайт!
$ar.customer.name Имя автора Иван
$ar.customer.email E-mail автора info@simpla.es

Информация о подписке и пользователе

Актуально для почтовых событий subscriber_cancel, subscriber_invitation и subscriber_new, также user_invitation, user_new.

Элемент Описание Пример
$ar.id Номер 12
$ar.name Имя пользователя Иван Петров
$ar.login Логин ivan_p
$ar.email E-mail ivan@simpla.es
$ar.news Подписка на новости 1 - подписан, 0 - нет
$ar.phone Телефон +7 123 456-78-90
$ar.country Страна Россия
$ar.city Город Москва
$ar.birth_day Дата рождения 23-05-2000
$ar.admin Администратор 1 - да, 0 - нет
$ar.gender Пол m - мужской, f - женский, - не выбран
$ar.url.news.add Ссылка подтверждения подписки на новости #
$ar.url.news.delete Ссылка отказа от подписки на новости #
$ar.url.activate Ссылка подтверждения аккаунта #

Отправка СМС-уведомлений

В панели администратора (обработка заказов и запросов), а также в почтовых событиях, можно назначить отправку СМС-сообщения. Например, дублировать информацию о заказе по СМС. Отправка происходит через шлюз smsc.ru.

Для работы функционала требуется регистриация на сайте smsc.ru и положительный баланс.

Элемент Описание Пример
sys_smsc_login Логин в SMSC login
sys_smsc_password Пароль в SMSC j%kL*Bv
sys_smsc_phone Моб.номер для отправки СМС +79251234567
sys_smsc_debug Режим отладки 1, если надо включить
sys_smsc_url Добавить ссылку на заказ или запрос 1, если да. Важно: такие сообщения могут попасть в СПАМ и не будут доставлены.