Почтовые события
В панели администратора можно создавать почтовые события и управлять отправляемыми сообщениями посетителям сайта и администратору. Здесь рассмотрены названия почтовых событий и доступные элементы, которые можно использовать в текстах сообщений.
Поля в панели администратора
Событие - выбираем тип почтового события
Сайт - указываем сайт (можно настроить разные сообщения для каждого сайта)
Название - понятное название для администратора
Примечания - пояснение к почтовому событию или инструкция
Тема письма - обязательное поле, тема, которая будет отправлена получателю
Текст письма - обазтельное поле, текст сообщения
Активность - работает событие или нет
Формат письма 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 | 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, если да. Важно: такие сообщения могут попасть в СПАМ и не будут доставлены. |