Skip to content
  1. Компоненты
  2. FetchIt
  3. Сниппет FetchIt

Сниппет FetchIt ​

Сниппет выводит чанк формы, сохраняет параметры вызова под ключом action и регистрирует фронтенд-скрипт. При отправке action.php поднимает эти параметры, проверяет защиту и запускает сниппет из snippet (по умолчанию FormIt).

Параметры ​

ПараметрПо умолчаниюОписание
formtpl.FetchIt.exampleЧанк с разметкой формы. С pdoTools можно @FILE, @INLINE и Fenom
snippetFormItОбработчик. Можно FormIt@PropertySet
actionUrl[[+assetsUrl]]action.phpURL коннектора
clearFieldsOnSuccess1Очистить поля после успешного AJAX-ответа

Остальные параметры уходят в указанный сниппет. Для FormIt это привычные hooks, validate, emailTo, validationErrorMessage, successMessage, placeholderPrefix и т.д.

successMessage при AJAX попадает в message ответа и в [data-success].

Пример ​

modx
[[!FetchIt?
  &form=`myForm.tpl`
  &hooks=`email`
  &emailSubject=`Тема письма`
  &emailTo=`info@domain.com`
  &validate=`name:required,email:required`
  &validationErrorMessage=`В форме содержатся ошибки!`
  &successMessage=`Сообщение успешно отправлено!`
]]
fenom
{'!FetchIt' | snippet : [
  'form' => 'myForm.tpl',
  'hooks' => 'email',
  'emailSubject' => 'Тема письма',
  'emailTo' => 'info@domain.com',
  'validate' => 'name:required,email:required',
  'validationErrorMessage' => 'В форме содержатся ошибки!',
  'successMessage' => 'Сообщение успешно отправлено!',
]}

FormIt и reCAPTCHA ​

Ошибки recaptcha, recaptchav2_error, recaptchav3_error из FormIt в AJAX-ответе схлопываются в один ключ data.recaptcha. В разметке используйте data-error="recaptcha". После успеха клиент вызывает grecaptcha.reset(), если виджет на странице есть.

Внимание

reCAPTCHA из FormIt 5.2 получает ответ через formit.js, который в формах FetchIt отключается вместе с AJAX-режимом FormIt. Для таких форм включайте капчу настройкой fetchit.captcha.

FormIt и property set ​

modx
[[!FetchIt?
  &snippet=`FormIt@ContactForm`
  &form=`tpl.contact`
]]
fenom
{'!FetchIt' | snippet : [
  'snippet' => 'FormIt@ContactForm',
  'form' => 'tpl.contact',
]}

Параметры property set сливаются с вызовом. Явные параметры FetchIt имеют приоритет при подготовке $scriptProperties для сниппета.

Файлы и контекст ​

Клиент шлёт FormData (включая файлы) на actionUrl с заголовком X-FetchIt-Action. В тело добавляется pageId: ID ресурса, с которого вызван сниппет. Коннектор может переключить контекст MODX по этому ID.

Пустой POST на action.php без action ведёт на стартовую страницу сайта.

Служебные поля ​

Сразу после тега формы сниппет добавляет скрытые поля защиты от спама: токен, при включённом proof-of-work — поле для решения, и поле-ловушку. Из $_POST они убираются до FormIt или вашего сниппета, так что в письма и в fields они не попадают.

Сниппет также сам ставит форме method="post" и атрибут data-fetchit, заменяя свои значения этих атрибутов.

Где хранятся параметры action ​

Ключ action: md5 от параметров вызова. Свойства пишутся в $_SESSION['FetchIt'][$action] или в cache fetchit/props_* на час. Если сессии на фронте отключены или кэш чистят агрессивно, ответ может быть fetchit_err_action_nf. Проверьте сессии и TTL кэша.

Чанк без pdoTools ​

Если pdoTools установлен, чанк рендерится через него. Иначе используется modX::getChunk.