Работа с формами

Добавление формы

Нужно написать пресет вызова. Для этого в папке core/elements/presets создаем файл ajaxformitlogin.inc.php. Пример содержимого файла можно увидеть ниже:

<?php

return [
  'callback_form' => [
    'validate' => 'name:required,phone:required,email:email,message:required',
    'name.vTextRequired' => 'Укажите Ваше имя',
    'phone.vTextRequired' => 'Укажите телефон',
    'message.vTextRequired' => 'Укажите суть обращения',
    'aliases' => 'name==,phone==,email==,message==',
    'hooks' => 'FormItSaveForm,email',
    'successMessage' => 'Форма успешно отправлена.',
    'validationErrorMessage' => 'Исправьте ошибки в форме!',
    'emailTpl' => '@FILE chunks/emails/letter.tpl',
  ],
];

Затем необходимо разметить форму в вёрстке для возможности вырезать её в чанк. Для этого следует использовать следующие атрибуты:

• data-mpc-chunk - в качестве значения принимает путь к чанку формы.
• data-mpc-copy - если нужно вызвать одну форму дважды, но с разными параметрами и чтобы вёрстка бралась из первой встреченной на странице формы, обязательно установить значение 1
• data-mpc-ssf - если нужно вызвать одну форму дважды, но с разными параметрами, чтобы эти параметры брались из пресета, работает только при запуске из терминала, обязательно установить значение 1
• data-mpc-form - указывает что данный чанк является именно формой и должен быть заменён вызовом сниппета AjaxFormItLogin, если указано значение 1 форма будет распарсена сразу, в шаблонах это, как правило, не требуется, исключение составляет шаблон-обёртка, где лежат формы в модалках
• data-mpc-preset - ключ в массиве из файла с пресетами
• data-mpc-name - человекопонятное название формы

<form id="contact-form" method="post" class="form-validate form-horizontal" data-mpc-chunk="forms/callback_form.tpl" data-mpc-form=""
      data-mpc-preset="callback_form" data-mpc-name="Форма обратной связи">
  <div class="row-fluid">
    <div class="control-group col-lg-6 col-md-6 col-xs-12 col-sm-12">
      <div class="contact-label">
        <label id="jform_contact_name-lbl" for="jform_contact_name" class="hasTooltip required" title="">
            Ваше имя<span class="star">&nbsp;*</span>
        </label>
        <input type="text" name="name" id="jform_contact_name" value=""
                class="required input-block-level" size="30"
                aria-required="true" aria-invalid="true">
      </div>

      <div class="contact-label">
        <label id="jform_contact_emailmsg-lbl" for="jform_contact_emailmsg"
                class="hasTooltip required" title="">
            Телефон<span class="star">&nbsp;*</span>
        </label>
        <input type="text" name="phone" id="jform_contact_emailmsg" value=""
                class="required input-block-level" size="60"
                aria-required="true">
      </div>

      <div class="contact-label">
        <label id="jform_contact_email-lbl" for="jform_contact_email"
                class="hasTooltip required" title="">
            Email<span class="star">&nbsp;</span>
        </label>
        <input type="email" name="email" class="validate-email input-block-level"
                id="jform_contact_email" value="" size="30" autocomplete="email">
      </div>
    </div>

      <div class="control-group col-lg-6 col-md-6 col-xs-12 col-sm-12">
        <div class="contact-message">
          <label id="jform_contact_message-lbl" for="jform_contact_message"
                  class="hasTooltip required" title="">
              Обращение<span class="star">&nbsp;*</span>
          </label>
          <textarea name="message" id="jform_contact_message" cols="50" rows="10"
                    class="required input-block-level" aria-required="true"
                    style="height:160px;"></textarea>
        </div>
        <div class="contact-form-submit">
          <button id="button" style="margin-top:25px;"
                class="btn center-block btn-primary btn-large validate sp-rounded"
                type="submit"><i class="fa fa-envelope"></i>&nbsp;Отправить обращение
          </button>
        </div>
      </div>
  </div>
</form>

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

Автозаполнение параметров emailTo и emailFrom

Принцип заполнения параметра emailTo такой:

1. Максимальный приоритет имеет значение этого параметра в списке форм
2. Если у формы в админке параметр emailTo не задан, но в TV со списком контактов (по умолчанию contacts) есть хотя бы один email привязанный к форме, то будет взято его значение
3. Если привязанных emailов в списке контактов нет, то будет взято значение системной настройки mpc_email
4. Если значение системной настройки mpc_email пустое, будет взято значение системной настройки ms2_email_manager
5. Если значение системной настройки ms2_email_manager пустое, будет установлена заглушка info@имя_вашего_домена

Принцип заполнения параметра emailFrom такой:

1. Максимальный приоритет имеет значение этого параметра в списке форм
2. Если этот параметр не задан в админке, будет установлена заглушка noreply@имя_вашего_домена
3. Однако если вы используете SMTP, то будет использовано значение системной настройки mail_smtp_user, если там будет невалидный email, т.е. не будет @, то недостающая часть будет сформирована из первого значения в системной настройке mail_smtp_hosts