Отправка e-mail сообщений с сайта является наиболее распространенной задачей, для решения которой и создается большинство форм обратной связи. На формах Chronoforms 6 для этого есть свой обособленный инструмент — функция «Email», которая позволяет отправлять не только текстовые сообщения, но и файлы.

Что касается методов отправки почты, то компонент Chronoforms 6 использует почтовые настройки сервера самой CMS Joomla 3. Поэтому, если вы получаете системные сообщения с сайта, то и с отправкой форм обратной связи проблем, как правило, не возникает. Исключения бывают только в случаях неправильной настройки параметров функции. Таких параметров немало и, прежде чем приступить к их настройке, нужно ознакомиться с их назначением и правилами применения.

Инструмент является частью функционала создаваемого проекта, а потому устанавливается и настраивается в категории «Функции» (Actions) раздела «Страницы» (Pages) в редакторе формы.

Окно редактирования функции «Email» в Chronoforms 6

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

Окно редактирования функции «Email» в Chronoforms 6

Рис. 1

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

  1. «Метка конструктора» (Designer label) — служебная метка, которая больше нигде не отображается, кроме как в окне редактирования. Может представлять собой краткое описание текущей задачи функции (см. п. 1 на рис. 1).
  2. «Имя» (Name) — собственное имя функции «Email», которое используется в качестве уникального идентификатора основным скриптом формы при обработке события, в теле которого она расположена (см. п. 2 на рис. 1).

Параметры e-mail сообщения открываются отдельно по нажатию на голубой значок шестеренки. Подразделяются на три группы-вкладки — «Основные настройки» (General), «Автошаблон»(Auto template) и «Шифрование» (Encryption) (см. рис. 1).

Группа параметров «Основные настройки» (General)

Эта группа параметров включает следующие поля:

Группа параметров  «Основные настройки» (General) в редакторе функции «Email» на формах Chronoforms 6

Рис. 2

  1. Переключатель, отвечающий за вызов функции «Email» в ходе обработки события на форме. Если он находится в положении «Отключено», функция работать не будет, а следовательно, сообщения с сайта также отправляться не будут.
  2. «Список получателей» (Recipients list) — список e-mail адресов почтовых ящиков получателей. Здесь можно размещать адреса как непосредственно, так и с помощью команд chrono syntax путем вызова значений полей формы, в которых такая информация содержится. Адреса получателей разделяются запятой без пробелов. Этот параметр является обязательным.
  3. «Тема» (Subject) — тема электронного сообщения. Поле обязательное. Также помимо обычного текста могут присутствовать шоткоды.
  4. Переключатель WYSIWYG-редактора, который может использоваться при создании тела сообщения.
  5. «Тело документа» (Body) — многострочное поле, которое используется для создания тела сообщения. Этот параметр является обязательным. По умолчанию автоматически не генерируется. При работе над шаблоном помимо html-кода, можно использовать js-, php-код, заключенный в соответствующие теги, а также команды chrono syntax. Для добавления автоконтента (см. п. 6) в строго определенном месте сообщения (см. п. 5 на рис. 2) следует использовать код специальный код вставки {AUTO_FIELDS} (иначе его содержимое будет добавлено в конец документа).
  6. «Автоконтент» (Auto content) — переключатель, определяющий возможность автоматического включения в тело документа значений полей формы. Предлагаются следующие варианты: «Включать все поля» (Include Pages templates), «Включать только поля, для которых разрешена Email отправка» (Include email enabled fields) и «Отключено» (Disabled). «Включать все поля» — все поля формы добавляются к тексту сообщения независимо от того, в каком положении в настройках их представлений находится переключатель «Включить значение поля в E-mail сообщение» (Include value in email). «Включать только поля, для которых разрешена Email отправка» — значения полей добавляются в тело документа в зависимости от положения переключателя «Включить значение поля в E-mail сообщение». «Отключено» — автоконтент добавляться не будет.
  7. «Отправить как» (Send as) — поле, определяющее формат e-mail сообщения. Два варианта — «HTML» и «Текст» (Text). Если к письму прикрепляются файлы, то следует использовать формат «HTML».
  8. «Применить дополнительный шаблон и стили» (Apply advanced template parsing and styles) — возможность применения дополнительной стилизации для сообщения. К автоконтенту собственная стилизация применяется автоматически и отключить ее нельзя.
  9. «Поля автовложения файлов» (Auto Attach file fields) — переключатель разрешения на автоматическое прикрепление содержимого всех полей «File Field», в настройках представлений которых переключатель «Прикрепить к e-mail сообщению» (Attach to email) находится в положении «Включено».
  10. «Список вложений» (Attachments list) — Многострочный список абсолютных путей к файлам (можно использовать chrono syntax).
  11. «Кому (E-mail)» (Reply email) — электронный адрес получателя ответа.
  12. «Кому (Имя)» (Reply name) — имя получателя ответа.
  13. «От (E-mail)» (From email) — электронный адрес отправителя. Как правило, используется электронный адрес сайта, с которого отправляется форма. В этом случае следует оставить данное поле пустым. В этом случае система его получит автоматически.
  14. «От (Имя)» (From name) — имя отправителя. Если требуется применить название сайта, то данное поле можно оставить пустым — система получит его автоматически из настроек Joomla.
  15. «CC» — (копия, carbon copy) список адресов получателей копии сообщения. При ее получении им будет виден весь данный список адресов.
  16. «BCC» — (скрытая копия, blind carbon copy) список адресов получателей скрытой копии сообщения. При ее получении они не увидят списка прочих получателей.

Группа параметров «Автошаблон» (Auto template)

Представлена тремя полями:

Группа параметров  «Автошаблон» (Auto template) в редакторе функции «Email» на формах Chronoforms 6

Рис. 3

  1. «Шапка» (Header) — многострочное поле для размещения кода верхнего колонтитула письма. В сообщении генерируется однократно.
  2. «Тело документа» (Body) — многострочное поле для размещения кода основного содержимого письма. Генерация контента осуществляется путем итераций, количество которых соответствует количеству полей формы.
  3. «Подвал» (Footer) — многострочное поле для размещения кода нижнего колонтитула письма. Генерируется однократно.

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

Если поля этого раздела заполнены и в разделе «Общие настройки» переключатель «Автоконтент» установлен как «Включать только поля, для которых разрешена Email отправка», то к сообщению будет добавлено содержимое автошаблона, за исключением полей, у которых e-mail отправка отключена.

Группа параметров «Шифрование» (Encryption)

Эта группа параметров используется только тогда, когда на сервере установлена и подключена в соответствующем скрипте компонента Chronoforms 6 библиотека GnuPG, о чем указано в отчете о результатах поиска класса «Crypt_GPG» (см. рис. 4).

Группа параметров  «Шифрование» (Encryption) в редакторе функции «Email» на формах Chronoforms 6

Рис. 4

Если класс найден, то шифрование почтовых сообщений можно активировать с помощью переключателя «Шифровать содержимое email сообщения» (Encrypt the email content) (см. п. 1 на рис. 4), а ID открытого ключа нужно поместить в поле «Секретный ключ GPG» (GPG security key). Следует помнить, что расшифровка сообщения возможна только при наличии у почтового клиента сохраненного закрытого ключа. Именно он и расшифровывает письмо после его получения.

Настройка e-mail сообщений на формах Chronoforms 6

Исходя из описанного выше, настройка e-mail сообщений на формах Chronoforms 6 в большинстве случаев сводится к следующему:

  1. Размещению на странице «submit» (она же является событием формы) визуального элемента «Email» из группы «Basic» (рис. 5).
  2. Включение функции и настройка всех трех ее обязательных полей (см. рис. 6).

Размещение визуального элемента «Email» в области события «submit» формы Chronoforms 6

Рис. 5

Настройка функции «Email» 
 на формах Chronoforms 6

Рис. 6

При использовании шоткодов для вызова значений полей формы, заполняемых пользователем на сайте, имена этих полей берутся со вкладки «Представления» (Views) той страницы, где они расположены. Например, команда получения значения поля с именем «message» будет выглядеть так: {data:message}. Подробнее о правилах составления и применении chrono syntax можно прочесть здесь.