- Главная
- Документация
- Рассылки
Рассылки

Модуль почты отправляет рассылки — дайджест новостей или выпуски, созданные в административной панели, — и хранит шаблоны писем сайта.
Рассылки
- «Рассылки» (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отправляет его.