modSendPulse

Интеграции с популярным русскоязычным сервисом Email рассылки SendPulse.
Версия 1.0.0-pl
Дата выпуска 30.06.2019
Загрузки 171
Просмотры 9 173
Внимание, этот компонент требует версию PHP 5.6 или выше! Если ваш сайт использует PHP ниже требуемого, установка этого дополнения может его сломать.
Внимание, этот компонент требует версию MODX не ниже 2.3 !
Компонент 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 и email. Убедитесь что в форме поля названы именно так.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;
}

//Инициализируем компонент
$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

1.0.0-pl - (30.06.2019)

  • Обновлена версия компонента от беты до стабильной
  • Добавлено return true в примере хука.

0.1.5-beta - (29.04.2017)

  • Исправлено автоотключение плагина modSendPulse при обновлении

0.1.4-beta - (23.04.2017)

  • Добавлен лексикон

0.1.3-beta - (23.04.2017)

  • Плагин modSendPulse оптимизирован для использования системных настроек компонента

0.1.2-beta - (22.04.2017)

  • Сниппет modSendPulseHook оптимизирован для использования системных настроек компонента

0.1.1-beta - (21.04.2017)

  • Исправлена ошибка инсталлятора
  • Обновление системных настроек

0.1.0-beta - (19.04.2017)

  • Базовая версия.
  • Включает в себя добавление Email из формы на сайте в указанную адресную книгу (Сниппет), добавление свежезарегистрированного пользователя в указанную адресную книгу (Плагин)

Последние обсуждения в сообществе MODX.pro