====== Плагин "Рассылка" ======
{{:plugins:delivery.gif }}Плагин предназначен для осуществления email рассылки. Использует в качестве источника адресов раздел на базе модуля [[:modules:users|"Пользователи"]].

===== Свойства =====
  * Входит в базовый дистрибутив: Да
  * Многократное использование: Да
  * Вид плагина: Улучшение модуля [[:modules:users|"Пользователи"]]

===== Ключевые возможности =====
  * Формат писем: текст или html;
  * Поддержка вложенных файлов;
  * Поддержка внешнего SMTP сервера для отправки;
  * Порционная отправка писем из текущей очереди по расписанию сron;
  * Персонализация писем;
  * Архив всех отправленных писем.

===== Создание дополнения =====
Для создания дополнения нужно перейти к управлению дополнениями в "Сайт" -> "Дополнения" и добавить новое, выбрав при этом в качестве базового плагина "Рассылка".

===== Управление =====
Панель управления разделом, состоит из двух секций:

==== Письма ====
Здесь хранится архив всех писем. Старые письма можно редактировать и снова добавлять в очередь на отправку.

{{ :plugins:plugindelivery.jpg }}

=== Персонализация писем ===
В тексте письма допускаются специальные конструкции, которые на этапе отправки заменяются на данные пользователя. Это позволяет персонализировать каждое письмо, например путем приветсвия по имени.

  * **{username}** - Полное имя пользователя.
  * **{userlogin}** - Логин пользователя.

==== Настройки ====
Здесь приведен список опциональных значений для раздела. Каждое значение можно менять, для этого достаточно кликнуть по названию опции, чтобы вызвать специальную форму для редактирования.

^ Название ^ Идентификатор ^ По умолчанию ^ Описание ^
|Количество писем в порции на отправку  |sendcount |  100  | За один запуск отправки будет выслано заданное количество писем из очереди.  |
|Шаблон письма html  |mailhtml |  delivery_html.tpl  | Этот шаблон используется в качестве обрамления для писем в формате html.  |
|Шаблон письма text  |mailtext |  delivery_text.tpl  | Этот шаблон используется в качестве обрамления для писем в текстовом формате.  |

===== Шаблоны обрамлений =====
Вышеописанные шаблоны обрамлений содержат следующие данные:

==== $mail ====
Массив с данными письма, состоит из следующих ключей:

=== name === 
Тема письма.

=== content === 
Текст письма.

==== $user ====
Массив с данными пользователя. Структура данных аналогична [[:modules:users:templates#user|одноименным пременным в шаблонах]].

===== Условная подписка =====
Пользователям можно дать возможность выбирать хотят ли они получать рассылку. Для этого в разделе пользователей нужно создать дополнительное поле с логическим типом, например поле subscribe с описанием вида: "Хочу получать новости на email".  Созданное поле необходимо выбрать в качестве фильтра в рассылке на закладке "Настройки". После этого в момент регистрации пользователи смогут сделать выбор, хотят ли они получать письма.

===== Рассылка очереди по расписанию =====
База пользователей может быть очень велика и в этом случае необходимо автоматизировать отправку писем из сформированной очереди. Для этого необходимо настроить запуск по расписанию скрипта cron.php который находится в корне рабочего каталога.