Общий обзор
Основным понятием плагина является Рассылка. Рассылка представляет из себя, по сути, контейнер для шаблонов сообщений (или просто: сообщений) с определённым набором характеристик: названием, расписанием отправки (или его отсутствия), способом отправки, типом контактов, которые могут осуществлять подписку на рассылку, набором условий отправки рассылки.
На данный момент системой поддерживаются следующие типы отправки сообщения:
по E-mail;
по SMS (через шлюзы smsc.ru, enterix.ru и smsaero);
через скрипт.
Сообщение рассылки представляет из себя шаблон, который перед отправкой конечному подписчику преобразуется в конкретное сообщение путём подстановок данных вместо различных макросов, например, номера договора, фамилии клиента, баланса на счёте и т.п. К сообщению также можно прикреплять файлы (однако их отправка может не поддерживаться какими-либо отправителями). Также имеется возможность задать собственное тело сообщения с помощью соответствующих макросов.
Рассылки можно функционально разделить на новостные и периодические рассылки:
Новостные рассылки - это рассылки, отправка сообщений которых происходит на каждой итерации срабатывания задачи отправки рассылок. При этом для отправки выбираются ещё неотправленные сообщения, время отправки которых уже пришло. После отрабатывания задачи они помечаются как "отправленные".
Периодические рассылки - это рассылки, у которых есть фиксированное расписание отправки, задаваемое аналогично расписанию выполнения задач планировщика (об этом ниже). Отправка сообщений таких рассылок происходит по указанному расписанию, причем при каждой отправке конечному пользователю отправляются все сообщения данной рассылки! В периодических рассылках, как правило, заводится одно сообщение.
Рассылки могут быть глобальными или персоналными:
Глобальные рассылки - по умолчанию для новых рассылок. Сообщения таких рассылок приходят всем подписчикам в одном и том же виде, в одно и то же время. Время отправки устанавливается для всей рассылки в целом.
Персональные рассылки - это рассылки, для которых подписчики могут указать дни недели, в которые они хотят получать сообщения. Также подписчики персональных рассылок могут указывать дополнительные условия, при которых нужно присылать сообщения, например, диапазон баланса для рассылки баланса или логин модуля, для получения детализации по нему.
Каждая рассылка характеризуется также типом контактов, которыми возможно подписаться на эту рассылку. Типы контактов заводятся администратором биллинга вручную, при этом указывается их описание и регулярное выражение для проверки корректности вводимых данных.
Каждый пользователь может заводить неограниченное количество контактов определённого типа. Каждый пользователь может создавать неограниченное количество подписок на рассылки. Подписка на рассылки характеризуется самой рассылкой, на которую была осуществлена подписка, списком контактов, а также (опционально) набором индивидуальных условий отправки сообщений рассылки.
Основное окно плагина расположено в меню Плагины => Рассылки.
На нем расположены три вкладки: Менеджер рассылок, Менеджер контактов и Методы отправки. Подробнее смотрите в следующих разделах документации.