SMS - E-mail рассылка своими руками на Drupal

После наших манипуляций, наш сайт будет иметь функционал небольшой CRM.

Мы сможем создавать рассылки, с помощью которых будут автоматически отправляться нужные нам сообщения - нужным нам получателям.

Итак, нам понадобятся следующие модули:

• Rules
• Conditional Rules
• Date
• Mime Mail (для отправки E-mail'ов)
• Модуль для отправки SMS

Устанавливаем все, и вот что нам нужно включить:

• AWD SMS API
• AWD SMS Rules integration
• Conditional Rules
• Date
• Date API
• Date Popup (по усмотрению)
• Rules
• Rules Scheduler
• Rules UI

Ну, и все их зависимости, при необходимости, включаются автоматически (после нашего разрешения).

Создаем тип материала "Рассылка"

Переходим на страницу admin/structure/types/add, и создаем тип материала "Рассылка".

Добавляем поля:

Отправить СМС

• Метка - Отправить СМС
• Машинное имя - send_sms
• Тип данных - Логическое поле
• Виджет - Одиночный флаг

Добавляем настройки отображения значений:

В основных настройках указываем следующее:

• Использовать для отображения метку поля, вместо значения, указанного для значения "Да"

Сохраняем поле. Скриншот настроек поля.

Получатели (СМС)

• Метка - Получатели (СМС)
• Машинное имя - recipient_sms
• Тип данных - Текст
• Виджет - Текстовое поле

В настройках ставим неограниченное количество значений поля. Скриншот настроек поля.

Сообщение (СМС)

• Метка - Сообщение (СМС)
• Машинное имя - message_sms
• Тип данных - Длинный текст
• Виджет - Много строчное текстовое поле

Будет простой текст, на 3. Скриншот настроек поля.

Дата и время рассылки

• Метка - Дата и время рассылки
• Машинное имя - date
• Тип данных - Дата
• Виджет - Всплывающий календарь

В предварительных настройках указываем степень детализации до минут.

В основных настройках - отмечаем обязательность заполнения поля, выбираем подходящий формат даты и выставляем значение по умолчанию - "Сейчас".

Скриншот настроек поля.

Немного передвигаем поля, и получаем вот такой тип материала.

Тип материала готов, приступаем к созданию компонента, отправляющего сообщения.

Переходим на страницу admin/config/workflow/rules/components/add, и добавляем новое правило:

Настраиваем компонент следующим образом:

• Имя - Рассылка
• Машинное имя - gratters

Добавляем переменную:

• Тип данных - Материал
• Метка - Node
• Машинное имя - node
• Использование - Параметр

Скриншот настроек компонента.

Добавляем условие - "Тип материала", в котором проверяем соответствие нашему типу материала:

Теперь нам будут доступны все поля нашего материала.

Добавляем условное действие:

Теперь добавим условие "Если:"

Здесь доступны точно те же условия, что и в блоке условий, и работать с ними можно точно так же. Это позволяет нам создать логику правила, по аналогии с программированием:

Все это предоставляет модуль расширяющий стандартные возможности Rules - Conditional Rules, который мы установили в самом начале. Без него нам бы пришлось создавать несколько разных компонентов, делать кучу повторяющихся проверок и объединять их неудобной логикой.

Вернемся к нашему условию. Нам нужно условие - "Сравнение данных".

Для начала, проверим необходимость отправки СМС. В селекторе данных выбираем сначала "node", и после "node:field-send-sms":

Теперь, в настройках сравнения, оператор оставляем со значением "равно", а значение выбираем "Истинно". Скриншот настройки сравнения.

Таким образом, мы задали условие - "Если в материале отмечен чекбокс - Отправить СМС." Перейдем к действиям, которые необходимо выполнять если условие соответствует.

А именно, будем отправлять SMS-ки.

Получателей у нас может быть неограниченное количество, поэтому правильно будет делать отправку циклом (если Вы не в курсе что за "Цыклы" - ознакомьтесь с постом "Rules Loop. Выполняем правила циклично").

Добавляем цикл (важно производить все действия в рамках нашего условия, т.к. иначе действие будет выполняться во всех случаях):

В качестве списка для цикла будет выступать наше поле "Получатели (СМС)" (node:field-recipient-sms):

Далее, в цикл добавляем действие:

Действием выбираем "Отправить СМС". Это действие предоставляется модулем для отправки SMS, который мы установили в самом начале.

В настройках действия переключаем все текстовые поля на селекторы данных:

В поле "Телефон" выбираем текущий элемент списка.

В поле "Сообщение" указываем текст сообщения из материала "node:field-message-sms".

Транслитерацию включаем по своему усмотрению, а вот показ сообщений включать не стоит (будет целая куча сообщений, на каждое отправленное СМС).

Скриншот настройки действия.

Принцип создания действия по отправке E-mail - аналогичен отправке СМС. Я небуду его расписывать в подробностях, и так "чтиво" уже долгое, да и Вы уже всему научились. Расскажу в кратце.

Делаем проверку чекбокса "Отправить E-mail", если включен - отправляем письма циклом, всем получателям.

В качестве действия используем "Отправить HTML-письмо", предоставляемое модулем MIME-mail, установленном в начале. Скриншот действия.

В итоге должно получится как на этом скрине.

Поздравляю! Мы на финишной прямой. Осталось всего-ничего - создать планировщик рассылок. И это будет еще одно правило.

Теперь это будет обычное правило, реагирующее на событие при создании нового материала типа "Рассылка".

Переходим на страницу admin/config/workflow/rules/reaction/add и добавляем правило со следующими настройками:

• Имя - Планировщик рассылок
• Машинное имя - gratters_scheluler
• Реакция на событие - gratters_scheluler
• Тип материала - Рассылка

Скриншот создания правила.

И здесь все просто - добавляем действие "Запланировать выполнение компонента":

В качестве компонента выбираем созданный в прошлом шаге:

В настройках правила переключаем поле для выбора даты на селектор данных, и выбираем поле "Дата и время рассылки" из материала (node:field-date).

В качестве идентификатора нужно указывать уникальное значение, потому составим это значение из NID материала и условным названием компонента - получим "[node:nid]_gratters_scheluler".

И в качестве ноды выбираем наш материал.

Скриншот действия.

Все, материалы и правила мы настроили, теперь для планировки рассылки нам достаточно создать новый материал, заполнить все поля и указать нужные дату и время рассылки. И все, рассылка будет запланирована.

Но, для "правильной" рассылки (вовремя, как указано при создании) нам нужно настроить запуск выполнения регулярных процедур "CRON".

К счастью, это можно сделать, практически на любом хостинге. Рассмотрим пример настройки на распространенной Cpanel, которой управляются большинство сайтов на шаред-хостингах.

Первым делом, заходим на страницу отчетов о состоянии сайта (admin/reports/status), и там смотрим строку "Задачи, выполняемые по сron":

Копируем ключ запуска CRON (без адреса сайта).

В CPanel настройки CRON, обычно находятся в блоке дополнительных настроек:

Вставляем ключ CRON и выставляем нужный интервал запуска.

Теперь мы можем быть уверенны, что наша рассылка будет отправлена вовремя.

Важно! Для отправки сообщений 1-го числа в 00:00 - нужно выставлять дату в материале 31-е число (последний день прошлого месяца) и время, например 23:59:00. По крону выполняются все задачи, которые должны были выполнится по расписанию, на момент запуска, а если программировать на 00:00 - это будет считаться будущей задачей, и будет выполнена только при следующем запуске cron.