Email хук FormIt

Email хук отправляет содержание Вашей формы на любой электронный адрес(а).

 

Доступные свойства<br /><br /><br />

Имя	Описание
emailTpl	Запрашиваемое. Tpl чанк для email сообщения. Если не указан, будет посылаться список полей с их значениями.
emailSubject	Тема email сообщения.
emailUseFieldForSubject	Если 1 и поле «subject» пройдено, то будет использоваться значение этого поля в качестве строки темы email-а.
emailTo	Разделенный запятыми список писем для отправки
emailToName	Опционно. Разделенный запятыми список имен вместе со значениями emailTo.
emailFrom	Опционно. Если установлено, будет определять From: адрес для email. Если не установлено, сначала будет искать  поле формы «email». Если ничего не найдено, настройка системы по умолчанию – «emailsender»  .
emailFromName	Опционно. Если установлено, будет определять From: имя для email.
emailHtml	Опционно. Так или иначе, email должен быть в HTML-формате. По умолчанию 1.
emailConvertNewlines	Опционно. Если установлено 1, будет преобразовывать все разрывы строки в br теги.
emailReplyTo	Еmail, который установлен как «ответа на».
emailReplyToName	Опционно. Имя поля Reply-To.
emailCC	Разделенный запятыми список электронных адресов для отправки через cc.
emailCCName	Опционно. Разделенный запятыми список имен вместе со значениями emailCC.
emailBCC	Разделенный запятыми список электронных адресов для отправки через bcc.
emailBCCName	Опционно. Разделенный запятыми список имен вместе со значениями emailBCC.
emailMultiWrapper	Обрабатывает значения, представленные флажками/мульти-селекторами с этим значением. По умолчанию только значение. (1.6.0 +)
emailMultiSeparator	Разделяет флажки/ мульти-селекторы этим значением. По умолчанию разрыв строки. (1.6.0 +)

 

Любое из свойств email хуков может содержать плейсхолдеры или  имена полей из Вашей формы, которые будут оцениваться.

 

Использование<br /><br />

Просто укажите его в своем запросе FormIt, а затем также добавьте в него специфичные email свойства.<br /><br /><br />

 

[[!FormIt?

   &emailTpl=`CentralizedDebtObligationEmailTpl`

   &emailSubject=`Some Sucker Bought Another CDO`

   &emailTo=`sales@mortgagemoney.com`

   &emailCC=`boss@mortgagemoney.com`

   &emailBCC=`fbi@gov.com`

   &emailBCCName=`CDO Fraud Informant`

]]

<br /><br /><br />

Обратите внимание, что свойство &emailTpl указывает на имя Chunk. В этом Chunk у Вас будут плейсхолдеры для каждого поля в форме. Наш Chunk может выглядеть следующим образом:<br /><br /><br />

<p>Hello,</p>

<p>

[[+name]] 

just purchased the CDO package:

[[+cdo_package]]

.</p>

<p>Their email:

 [[+email]]

</p>

<p>Thanks!</p>

Это предполагает, конечно, что в Вашей форме есть поля «name», «cdo_package» и «email».

 

Определение динамических адресов

 

В примере использована форма для определения адресатов:  <br /><br /><br />

 

[[!FormIt?

   &emailTo=`[[+addressTo]]`

]]

...

<select name="addressTo">

   <option value="john@doe.com" [[!+fi.addressTo:FormItIsSelected=`john@doe.com`]]>John</option>

   <option value="jane@doe.com" [[!+fi.addressTo:FormItIsSelected=`jane@doe.com`]]>Jane</option>

</select>

 <br /><br />

Таким образом email  отправляется тому, кто выбран в поле «addressTo».

 

Использование поля темы в качестве строки темы еmail-а<br /><br />

Скажем, у Вас есть поле темы в форме. Вы хотите, чтобы содержимое было темой письма email рассылки. Хук email может:<br /><br />

 

[[!FormIt?

    &emailUseFieldForSubject=`1`

]]

 

 

Далее идет поиск поля «subject», которое будет использоваться в email. Если оно не найдено или пустое, то по умолчанию – свойство &emailSubject.

 

Управление флажками и мультиселектами в e-mail<br /><br />

FormIt, версия 1.6.0 +, будет автоматически обрабатывать флажки и объединять их в одно поле. Можно использовать свойства &emailMultiSeparator и &emailMultiWrapper, чтобы следить за добавлением. Например, чтобы сделать флажки неразрывными в тегах LI:<br /><br />

 

[[!FormIt?

  &emailMultiWrapper=`
<ul>
<li>[[+value]]</li>
</ul>
`

]]

<br /><br />

Или просто разделить их с тегами BR: 1<br /><br />

 

[[!FormIt?

  &emailMultiSeparator=`<br />`

]]

 

---