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