На формах обратной связи Chronoforms 5 функция «Email» осуществляет отправку сообщений.

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

Параметры функции «Email» в Chronoforms 5

Параметры функции «Email» в Chronoforms 5 составляют четыре основных раздела:

  1. «Основные настройки» (Basic) — статические настройки отправки почты и самого тела сообщения.
  2. «Дополнительно» (Advanced) — динамические и прочие настройки для отправки ответов, копий, скрытых копий и т. п.
  3. «Шифрование» (Encryption) — набор полей для подключения ключей шифрования и их активации для обработки e-mail сообщения.
  4. «Автошаблон сообщения» (Auto template) — группа полей для автогенерации кода почтового сообщения.

Раздел «Основные настройки» (Basic) включает в себя следующие параметры:

Функция  «Email» на формах Chrnonoforms 5. Раздел настроек 
 «Основные настройки» (Basic)

Рис. 1

  1. «Метка обработчика» (Action Label) — поля для ввода текстовой метки, которая будет отображаться только в конструкторе формы, во вкладке «Установка» (Setup).
  2. «Включить» (Enabled) — переключатель, отвечающий за включение или отключение функции. Имеет два варианта значений — «Да» (Yes) и «Нет» (No). Если установлен в положение «Нет», то функция не будет работать, а следовательно, не будет и отправлять сообщения с формы.
  3. «Кому» (To) — поле списка e-mail адресов получателей сообщения. Адреса указываются через запятую, без пробелов. Это поле является обязательным, если только не используется поле «Динамический e-mail (кому)» (Dynamic To) из раздела «Дополнительно» (Advanced).
  4. «Тема» (Subject) — текст темы сообщения. Это поле является обязательным, если только не используется поле «Динамическая тема» (Dynamic subject) из вкладки «Дополнительно» (Advanced).
  5. «От (имя)» (From name) — поле, где указывается имя отправителя сообщения. Как правило, здесь указывается название сайта или имя почтового робота. Это поле является обязательным.
  6. «От (email)» (From email) — адрес электронной почты отправителя сообщения. Здесь указывается адрес электронной почты сайта, с которого отправляется форма. Это поле — обязательное.
  7. «Формат Email» (Email format) — сообщение может быть представлено в двух вариантах — «HTML» и «Текст». Если выбран текстовый формат, то тело документа в полученном письме будет содержать неформатированный текст без стилизации. А для настройки отправки файлов необходимо установить для сообщения формат «HTML».
  8. «Генерация шаблона» (Template generation) — переключатель, определяющий порядок генерации шаблона тела сообщения. Если установлен в положение «Авто» (Auto), то тело сообщения при сохранении формы будет сгенерировано автоматически и будет содержать значения всех полей формы, заполненных пользователем на сайте. Если установлен порядок генерации «Пользовательский» (Custom), то тело сообщения создается только вручную и не зависит от содержимого запроса.
  9. «Переключить редактор» (Swtich Editor) — кнопка включения или отключения wysiwyg-редактора для редактирования шаблона сообщения.
  10. «Шаблон сообщения» (Email template) — многострочное поле, содержащее собственно контент сообщения. Помимо html-кода это поле может содержать также js или php-код, обязательно заключаемый в соответствующие теги. Для того, чтобы код, вводимый в это поле вручную, сохранялся, рекомендуется использовать порядок генерации шаблона «Пользовательский» (см. п. 8). Это поле является обязательным.
  11. «Прикрепленные файлы» (Attachment files) — список полей «File Field», файлы которых будут прикрепляться к данному письму. Имена полей указываются через запятую, без пробела.

Раздел «Дополнительно» (Advanced) содержит такие поля:

Функция  «Email» на формах Chrnonoforms 5. Раздел настроек «Дополнительно» (Advanced)

Рис. 2

  1. «Динамический e-mail (кому)» (Dynamic To) — список из одного или нескольких e-mail адресов, разделенных запятыми, без пробелов. В качестве значений для этого поля используются имена полей формы, где указаны получатели сообщения. Используется в качестве альтернативы полю «Кому» (To) (см. п. 3 на рис. 1).
  2. «Динамическая тема» (Dynamic subject) — поле темы сообщения, значением для которого служит имя поля формы, где пользователь указывает тему сообщения. Используется в качестве альтернативы полю «Тема» (Subject) (см. п. 4 на рис. 1).
  3. «Ответить кому» (Reply to name) — имя получателя ответа.
  4. «Ответить на e-mail» (Reply to email) — адрес получателя ответа.
  5. «Динамическое имя получателя ответа» (Dynamic reply to name) — имя поля формы, в котором указано имя получателя ответа.
  6. «Динамический e-mail получателя ответа» (Dynamic reply to email) — имя поля формы, в котором указан адрес получателя ответа.
  7. «Динамическое имя отправителя» (Dynamic from name) — имя поля формы, где содержится имя отправителя сообщения.
  8. «Динамический e-mail адрес отправителя» (Dynamic from email) — имя поля формы, где содержится адрес отправителя сообщения.
  9. «Адрес CC» (CC) — список адресов получателей копий сообщения, разделенных запятыми (без пробелов).
  10. «Адрес BCC» (BCC) — список адресов получателей копий письма, которые должны быть скрыты от остальных получателей. Адреса указываются через запятую без пробелов.
  11. «Динамический адрес CC» (Dynamic CC) — имена полей формы, которые содержат адреса получателей копий сообщения. Разделяются запятыми, без пробелов.
  12. «Динамический адрес BCC» (Dynamic BCC) — имена полей формы, содержащие адреса получателей копий письма, которые нужно скрыть от остальных получателей. Разделяются запятыми, без пробелов.
  13. «Добавить IP-адрес» (Append IP address) — переключатель, отвечающий за добавление в сообщение IP-адреса пользователя, отправляющего форму.

Раздел настроек «Шифрование» (Encryption) включает всего два параметра:

Функция «Email» на формах Chrnonoforms 5. Раздел  настроек «Шифрование» (Encryption)

Рис. 3

  1. «Включить шифрование» (Enable encryption) — включение или отключение шифрования почтового сообщения. Для этого используется установленное в Joomla соответствующее стороннее расширение.
  2. «Ключ шифрования» (Encryption key) — поле для ввода текстового ключа шифрования, взятого из настроек расширения (см. п. 1).

Раздел настроек «Автошаблон сообщения» (Auto template) содержит такие параметры:

Функция «Email» на формах Chrnonoforms 5. Раздел  настроек «Автошаблон сообщения» (Auto template)

Рис. 4

  1. «Шаблон шапки сообщения» (Template header) — многострочное поле для кода верхнего колонтитула сообщения.
  2. «Шаблон тела сообщения» (Template body) — многострочное поле для кода тела документа. Здесь также можно размещать коды вставки {label} или {name}, которые при генерации будут заменены соответствующими метками и именами полей.
  3. «Шаблон подвала сообщения» (Template footer) — многострочное поле для кода нижнего колонтитула сообщения.

Все три поля, помимо html, могут также включать js- или php-код, заключенный в соответствующие теги. Если этот раздел будет целиком заполнен, то для формирования тела сообщения будет использоваться именно его содержимое, а не содержимое поля «Шаблон сообщения» (Email template) (см. п. 10 на рис. 1).

Настройка почтовых сообщений на формах обратной связи Chronoforms 5

Настройка почтовых сообщений на формах обратной связи Chronoforms 5 сводится к обязательному определению следующих значений:

  1. Имя отправителя.
  2. E-mail адрес отправителя.
  3. Список получателей.
  4. Тема.
  5. Собственно сообщение.

В связи с новыми ограничениями безопасности, принятыми большинством почтовых сервисов (Yandex, Google, Yahoo и т. д.), в качестве отправителя e-mail рекомендуется указывать именно сайт.

Также, в настройках самого компонента Chronoforms 5 в качестве «Метода отправки почты» (Mailing method) следует выбрать именно «Joomla» с тем, чтобы ее настройки сервера в дальнейшем использовались и для отправки форм обратной связи.

Таким образом, первые два параметра, в большинстве случаев, только статические. Остальные же настройки, за исключением самого контента сообщения, могут быть либо статическими, либо динамическими.

Статические приводятся как есть, в виде исходных текстовых значений (см. пп. 3–6 на рис. 1), а для динамических чаще всего берутся имена полей формы из вкладки конструктора «Дизайнер» (Designer) (см. рис. 6).

Если используются динамические параметры, то соответствующие поля статических должны оставаться пустыми, т. к. при наличии тех и других одновременно, приоритет при обработке формы отдается статическим. Поэтому, если требуется применение и статических, и динамических параметров, на форму добавляется еще одна функция «Email».

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

В разделе «Основные настройки»  редактируемой функции, в поле «От (имя)» , нужно прописать название сайта, имя робота или другое необходимое значение строкового типа, указывающее на отправителя. Здесь же, в поле «От (email)» следует вписать тот электронный адрес, который указан в общих настройках Joomla в качестве почтового адреса сайта.

Функция «Email» на формах Chrnonoforms 5. Настройка почтовых сообщений. Имя и адрес отправителя

Рис. 5

Список получателей

Для отправки почты администраторам сайта чаще всего используется постоянный список адресов, и для этого целесообразно использовать поле «Кому» в разделе «Основных настроек» (см. п. 3 на рис. 1).

Если пользователю сайта отправляется копия его же письма без изменений, то следует применить поле «Динамический адрес CC», которое находится в разделе «Дополнительно» той же функции «Email» (см. п. 11 на рис. 2).

При необходимости отправки пользователю сообщения, контент которого отличается от содержимого отправленной им формы, копия письма уже не подойдет и нужно добавить в область события «On submit» еще одну функцию «Email» и для нее использовать уже динамический параметр — «Динамический e-mail (кому)»  (см. п. 1 на рис. 2).

Тема

Тема также может быть как статической, так и динамической. Исходя из этого, используется либо поле «Тема» в «Основных настройках», либо «Динамическая тема»  в разделе «Дополнительно», соответственно.

Функция «Email» на формах Chrnonoforms 5. Настройка почтовых сообщений. Тема сообщения и список получателей

Рис. 6

Сообщение

Тело сообщения можно сформировать тремя разными способами:

  1. Вручную «с нуля», включая значения полей, js- или php-код.
  2. Автогенерацией контента сообщения в формате html-таблицы.
  3. С помощью настраиваемого автошаблона.

В первом случае нужно переключатель «Генерация шаблона» (см. п. 8 на рис. 1) установить в положение «Пользовательский». Затем в поле «Шаблон сообщения»  по своему усмотрению создать контент. Здесь можно размещать не только html-, но и js- или php-код внутри соответствующих тегов. Для вызова значений полей формы, нужно заключать их имена в фигурные скобки. Например: для поля с именем text1 код вставки будет {text1}.

Для автоматической генерации шаблона в поле «Шаблон сообщения» ничего делать не нужно, а порядок генерации определяется значением «Авто» у переключателя «Генерация шаблона» (см. п. 8 на рис. 1). В этом случае контент сообщения будет представлять собой дефолтную html-таблицу со всеми полями формы, которые заполнял пользователь на сайте.

Функция «Email» на формах Chrnonoforms 5. Настройка почтовых сообщений. Тело документа

Рис. 7

Настраиваемый автошаблон (см. рис. 4) активируется только когда все три его поля в разделе «Автошаблон сообщения» заполнены. В этом случае именно он будет иметь приоритет и сгенерируется в поле «Шаблон сообщения» (в разделе «Основные настройки»). Каждое из трех полей также может включать в себя любой вид кода. В отличие от верхнего и нижнего колонтитулов, тело документа создается в несколько итераций, число которых зависит от количества полей формы.