Отправка писем

Отправка писем

Контроллер Form позволяет отправлять данные формы в письме.

Параметры отправки почты

parseMailerParams

Разрешает использовать данные формы в параметрах отправки почты (&to=`[+user.email.value+]` и т.п.).

Возможные значения - 1, 0.

Значение по умолчанию - 0.

isHtml

Разрешает отправлять письмо в формате html. Проверка корректности кода письма возлагается на разработчика.

Возможные значения - 1, 0.

Значение по умолчанию - 1.

to

Адрес получателя. Если не указан, то письмо не отправляется, но считается успешно отправленным.

Возможные значения - email-адрес.

Значение по умолчанию - пусто.

from

Возможные значения - email-адрес.

Значение по умолчанию - параметр конфигурации emailsender.

fromName

Имя отправителя.

Возможное значение - строка.

Значение по умолчанию - параметр конфигурации site_name.

replyTo

Заголовок replyTo.

Возможные значения - email-адрес.

Значение по умолчанию - пусто.

cc

Заголовок сс.

Возможные значения - email-адрес.

Значение по умолчанию - пусто.

bcc

Заголовок bcc.

Возможные значения - email-адрес.

Значение по умолчанию - пусто.

noemail

Если параметр задан, то письмо не отправляется, но считается успешно отправленным.

Возможные значения - 1, 0.

Значение по умолчанию - 0.

ignoreMailerResult

Если параметр задан, то письмо отправляется, но результат отправки игнорируется.

Возможные значения - 1, 0.

Значение по умолчанию - 0.

subject, ccSubject, autoSubject

Тема письма.

Возможные значения - строка.

Значение по умолчанию - пусто.

subjectTpl, ccSubjectTpl, autoSubjectTpl

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

Возможные значения - имя шаблона, указанное по правилам задания шаблонов в DocLister.

Значение по умолчанию - значение параметра subject (ccSubject, autoSubject).

autosender

Адрес на который отправляется дополнительное письмо.

Возможные значения - email-адрес.

Значение по умолчанию - пусто.

autosenderFromName

Имя отправителя дополнительного письма.

Возможные значения - строка.

Значение по умолчанию - параметр конфигурации site_name.

ccSender

Если параметр задан, то на адрес указанный в поле формы отправляется письмо.

Возможные значения - 1, 0.

Значение по умолчанию - 0.

ccSenderField

Имя поля, в котором хранится адрес получателя.

Возможные значения - имя поля формы.

Значение по умолчанию - email.

ccSenderFromName

Имя отправителя письма на заданный в поле формы адрес.

Возможные значения - строка.

Значение по умолчанию - не указано.

ccMailConfig

Позволяет переопределить параметры отправки для писем, отправляемых по адресу из формы (isHtml, from, fromName, subject, replyTo, cc, bcc, noemail).

Возможные значения - json или php массив.

Значение по умолчанию - не указано.

autoMailConfig

Позволяет переопределить параметры отправки для дополнительно отправляемых писем (isHtml, from, fromName, subject, replyTo, cc, bcc, noemail).

Возможные значения - json или php массив.

Значение по умолчанию - не указано.

Защита от повторной отправки

protectSubmit

Защита от повторной отправки письма.

Возможные значения - 1, 0 или список полей, по которым определяется уникальность письма. Если список не задан, то используются поля, обязательные для заполнения.

Значение по умолчанию - 1.

submitLimit

Защита от частой отправки писем.

Значение - число секунд между повторной отправкой.

Значение по умолчанию - 60.

Шаблоны

reportTpl

Основной шаблон письма. В шаблоне письма reportTpl доступен плейсхолдер [+attachments.value+] со списком всех приложенных к письму файлов. Можно также вывести по отдельности: [+имя поля.value+]. Файлы отправляются только в письме c шаблоном reportTpl.

Возможные значения - имя шаблона, указанное по правилам задания шаблонов в DocLister.

Значение по умолчанию - список полей и их значений.

automessageTpl

Шаблон дополнительного письма.

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

Значение по умолчанию - значение параметра reportTpl.

ccSenderTpl

Шаблон письма на заданный в поле формы адрес. Обязательный параметр, если задан параметр ccSender.

Возможные значения - имя шаблона, указанное по правилам задания шаблонов в DocLister.

Значение по умолчанию - значение параметра reportTpl.

successTpl

Шаблон сообщения об успешной отправке писем.

Возможные значения - имя шаблона, указанное по правилам задания шаблонов в DocLister.

Значение по умолчанию - запись лексикона с ключом form.default_successTpl.

Отправка файлов

attachments

Имена полей, в которых хранятся файлы. Поддерживаются только поля с одним файлом (name="field" type="file") и поля с одномерным массивом файлов (name="field[]" type="file" multiple).

Значение по умолчанию - пусто.

attachFiles

Позволяет отправить произвольные файлы.

Возможные значения - массив:

&attachFiles=`{
"имя поля1":{
    "filepath":"assets/images/logo.png",
    "filename":"logo.png"
},
"имя поля2":[
    {
    "filepath":"assets/images/file1.jpg",
    "filename":"отчет.jpg"
    },
    {
    "filepath":"assets/images/file2.jpg",
    "filename":"отчет2.jpg"
    }
]
}`

deleteAttachments

Позволяет удалить файлы вложений после успешной отправки.

Возможные значения - 0 или 1.

Значение по умолчанию - 0.