Розсилки

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

Модуль пошти надсилає розсилки — дайджест новин або випуски, написані в адмін-панелі, — а також зберігає шаблони листів сайту.

Розсилки

  • «Рассылки» (Розсилки, /admin/mail-subscriptions/): назва й опис кожною мовою; «Источник данных» (Джерело даних) — «Новости» (Новини) або «CRM-рассылка» (CRM-розсилка); «Периодичность» (Періодичність) — щогодини, щодня, щотижня або щомісяця; «Подписывать новых подписчиков автоматически» (Підписувати нових підписників автоматично); «Не показывать в списке подписок» (Не показувати у списку підписок); вкладки «Подписанные пользователи» (Підписані користувачі) та «Подписанные e-mail» (Підписані e-mail).
  • «Сообщения рассылки» (Повідомлення розсилки, /admin/mail-crm/) — випуски CRM-розсилок із «Дата выпуска» (Датою випуску) та «Включать в рассылку» (Включати до розсилки).
  • «Подписчики рассылок» (Підписники розсилок, /admin/mail-subscribers/) — підписники за e-mail.
  • На /subscribe/ «Подписка на рассылку» (Підписка на розсилку) відвідувач вказує e-mail і потрапляє до всіх активних розсилок, що підписують нових підписників автоматично. Авторизовані користувачі обирають свої розсилки на /subscriptions/ «Мои подписки» (Мої підписки).

Відправлення

Розсилки надсилає консольна команда; запускайте її з кореневої директорії проєкту:

php cli/mail_sender.php run

У релізі планувальник не налаштовано: запускайте команду через cron, наприклад щогодини. Кожен запуск надсилає розсилки, у яких минув заданий період, — з новинами або випусками з моменту останнього відправлення (не більше 100) — по одному листу кожному підписнику мовою за замовчуванням. Листи надсилаються через PHP-функцію mail(). При увімкненому site.debug розсилки не надсилаються, а дописуються до htdocs/uploads/tmp/mailout.txt — файлу, який роздає вебсервер; див. Відомі ризики.

Шаблони листів

«Шаблоны писем» (Шаблони листів, /admin/mail-templates/) зберігає листи реєстрації, відновлення пароля, форми зворотного зв'язку та розсилок: для кожної мови — тему, текст і HTML із макросами на кшталт [user_name], перелік яких наведено у «Подсказки (доступные макросы)» (Підказки — доступні макроси). У HTML значення екрануються. Шаблон не можна видалити, лише вимкнути.

Для розробників

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