[modSendPulse] - Рассылки через SendPulse

Компонент modSendPulse предоставляет возможность интеграции с популярным русскоязычным сервисом Email рассылки SendPulse.

Основная задача текущей версии компонента — управление подписной базой.

Состав компонента:

1. Хук для Formit или ajaxForm
2. Компактный сниппет для ручной работы
3. Плагин срабатывающий при регистрации пользователя на сайте

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

1. Разумеется у Вас должен быть активный аккаунт в сервисе SendPulse и заведена хотя бы одна адресная книга
2. Открываем системные настройки, раздел modsendpulse и заполняем три обязательных параметра
3. modsendpulse_addressbook_user_create — Номер вашей адресной книги, куда по умолчанию будут добавляться email адреса. Номер можно посмотреть в адресной строке, открыв книгу в сервисе SendPulse
4. modsendpulse_client_id — ID из раздела API вашего аккаунта в системе SendPulse
5. modsendpulse_client_secret — Secret из раздела API вашего аккаунта в системе SendPulse

Хук для formIt

1. Создайте собственную подписную/контактную форму с уникальным дизайном, и графой E-mail.
2. По умолчанию хук ищет поля name и emai. Убедитесь что в форме поля названы именно так.l
3. Вызовите форму при помощи FormIt или AjaxForm
4. Добавьте к вызову хук modSendPulseHook
5. При обработке формы — отправитель добавится в вашу адресную книгу на сервисе SendPulse.

Пример вызова

[[!ajaxForm?
    &form=`tpl.podpiska`
    &hooks=`modSendPulseHook`
    &validate=`name:required,email:required:email`
]]

Сниппет-Хук легко адаптировать под собственные нужды, если Вы не пользуетесь FormIt, а предпочитаете обрабатывать формы используя собственные сниппеты.

// Вызываем класс 
if (!$modsendpulse = $modx->getService(
    'modsendpulse',
    'modsendpulse',
    MODX_CORE_PATH . 'components/modsendpulse/model/modsendpulse/'
)) {
    $modx->log(modX::LOG_LEVEL_ERROR, '[modSendPulseHook] - Not found class modsendpulse');
    return;
}

//Инициируем (получаем токен для запросов к API)
$modsendpulse->initialize($modx->context->key);
// Получаем email любым удобным способом, по вкусу проводим валидацию
$email = 'test@text.ru';
//Опционально добавляем Имя адресата любым удобным для Вас способом
$name = 'Петя Иванов';
//Получаем номер адресной книги из системных настроек компонента или указываем вручную
$book = $modx->getOption('addressbook_user_create');
// Вызываем метод добавления email в адресную книгу
$params['emails'] = array(
    array(
        'email' => $email,  
        'variables' => array(
            'name' => $name  
        )
    )
);
$modsendpulse->sendPulseAddEmailsToBook($params, $book);

Плагин, добавляющий пользователя в адресную книгу при регистрации
Срабатывает на событие OnUserSave. Плагин по умолчанию отключен. Если Вы хотите чтобы пользователь автоматически добавлялся в адресную книгу при регистрации на Вашем сайте — плагин нужно активировать.

Сервис предоставляет возможность отправки подписчику приветственного письма сразу же при добавлении в адресную книгу.
Также можно настроить цепочку писем с целой кучей тригеров, статистикой открываемости и прочей аналитикой.
Причем письмо можно оформить в виде крутого адаптивного шаблона. Нам достаточно лишь добавить подписчика в нужную адресную книгу.

Вы можете создать несколько адресных книг, привязав каждую к определенным действиям.
Попадание в одну адресную книгу — вызовет отправку прайс-листа или презентации
Попадание во вторую адресную книгу — вызовет цепочку писем. и так далее.

Все это вы можете подробнее прочитать на сайте сервиса. Ссылку думаю найдете.

$modsendpulse = $modx->getService('modsendpulse');
    $params['emails'] = array(
    array(
        'email' => $email,  
        'variables' => array(
            'name' => $name  
        )
    )
);
$modsendpulse->sendPulseAddEmailsToBook($params, $book);