Рассылки

Редактор рассылок в панели управления Energine 2.13 с двумя рассылками, их источником данных, периодичностью, временем последней отправки и статусом
Панель управления Energine 2.13 — рассылки (интерфейс на русском языке)

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

Рассылки

  • «Рассылки» (Newsletters, /admin/mail-subscriptions/): название и описание на каждом языке; «Источник данных» (Data source) — «Новости» (News) или «CRM-рассылка» (CRM newsletter); «Периодичность» (Frequency) — ежечасно, ежедневно, еженедельно или ежемесячно; «Подписывать новых подписчиков автоматически» (Subscribe new subscribers automatically); «Не показывать в списке подписок» (Hide from the subscription list); вкладки «Подписанные пользователи» (Subscribed users) и «Подписанные e-mail» (Subscribed e-mails).
  • «Сообщения рассылки» (Newsletter messages, /admin/mail-crm/) — выпуски CRM-рассылок с полями «Дата выпуска» (Issue date) и «Включать в рассылку» (Include in the mailing).
  • «Подписчики рассылок» (Newsletter subscribers, /admin/mail-subscribers/) — подписчики по адресу электронной почты.
  • На странице /subscribe/ «Подписка на рассылку» (Newsletter subscription) посетитель указывает адрес электронной почты и подписывается на все активные рассылки, автоматически подписывающие новых пользователей. Авторизованные пользователи управляют своими подписками на странице /subscriptions/ «Мои подписки» (My subscriptions).

Отправка

Рассылки отправляются консольной командой; запускайте её из папки проекта:

php cli/mail_sender.php run

В дистрибутиве расписание не настроено: запускайте команду через cron, например ежечасно. При каждом запуске отправляются рассылки, у которых истёк период, — с новостями или выпусками начиная с момента последней отправки, не более 100, по одному письму каждому подписчику на языке по умолчанию. Письма отправляются через mail() PHP. При включённом site.debug рассылки не отправляются, а добавляются в файл htdocs/uploads/tmp/mailout.txt, который раздаётся веб-сервером — см. Известные риски.

Шаблоны писем

«Шаблоны писем» (Mail templates, /admin/mail-templates/) хранит письма для регистрации, восстановления пароля, формы обратной связи и рассылок: для каждого языка — тему, текст и HTML с макросами, например [user_name], перечисленными в «Подсказки (доступные макросы)» (Hints — available macros). В HTML значения экранируются. Шаблон нельзя удалить, только отключить.

Для разработчиков

  • Новый тип рассылки: значение mail_subscriptions.subscription_type, класс, реализующий Energine\mail\gears\IMailSource, и его запись в mail.subscriptions конфигурации.
  • Отправка письма из кода: Energine\mail\gears\MailTemplate заполняет шаблон, Energine\mail\gears\Mail отправляет его.