docs.modx.pro
  1. Компоненты
  2. PageBuilder
  3. Каталог секций
  4. Pro
  5. Форма обратной связи

Форма обратной связи ​

Вы собираете набор полей в инспекторе (text, email, phone, textarea), задаёте Ключ формы и текст после отправки. Отправка идёт через FetchIt и сниппет PageBuilderContactForm. Из шаблона handler не вызывайте.

Информация

Требуются PageBuilder Pro и FetchIt.

Что даёт форма в PageBuilder ​

  • Набор полей собираете в repeater, не в коде формы
  • form_key стабильный id POST (pb_form_key)
  • Сообщение об успехе и redirect настраиваются в инспекторе
  • Персональные данные в published_json не пишутся

Типичные места ​

  • Для заявки с лендинга
  • Для обратной связи на странице контактов
  • Для лид-магнита: скачать PDF после email

Примеры страниц ​

form_key и поля ​

Ключ формы (form_key) должен быть уникален на странице, если форм несколько. Repeater Поля формы: name, label, type (text / email / phone / textarea), required. Имя поля: [a-z][a-z0-9_]*.

Получатель письма: emailsender или настройки почты сайта (как у handler). Без FetchIt секция показывает сообщение о недоступности формы.

Похожие секции ​

  • Квиз для многошагового сбора
  • CTA с одной ссылкой вместо полей
  • Контакты для tel:/mailto: без отправки формы

Параметры блока ​

ПараметрЗначение
keycontact_form
СлойPro
Категорияконверсия (conversion)
Chunkpagebuilderpro_contact_form
Требованияpro, FetchIt

Поля в редакторе ​

Заполните поля в инспекторе секции на ресурсе. Описание типов полей: справочник типов.

Заголовок (title) ​

Тип text. Необязательное.

Вступление (intro) ​

Тип textarea. Необязательное.

Ключ формы (form_key) ​

Тип text. Обязательное.

Поля формы (fields) ​

Тип repeater. Обязательное. Повторяющиеся строки. Кнопка «Добавить» в инспекторе.

В каждой строке:

ПолеТипПодписьОбязательно
nametextИмя поля (name)да
labeltextПодписьда
typeselectТип поляда
requiredyesnoОбязательноенет

Текст кнопки отправки (submit_label) ​

Тип text. Необязательное.

Сообщение об успехе (success_message) ​

Тип textarea. Необязательное.

URL после отправки (redirect_url) ​

Тип url. Необязательное.

Что видит посетитель ​

Секция pb-contact-form. AJAX через FetchIt → PageBuilderContactForm. Honeypot nospam: тихий success без письма.

Данные секции ​

Пример JSON после сохранения секции (схема полей, не ответы посетителя):

json
{
  "title": "Оставьте заявку",
  "intro": "Мы ответим в рабочее время.",
  "form_key": "contact",
  "fields": [
    {
      "_rowId": "00000000-0000-4000-8000-000000000001",
      "name": "name",
      "label": "Имя",
      "type": "text",
      "required": true
    },
    {
      "_rowId": "00000000-0000-4000-8000-000000000002",
      "name": "email",
      "label": "Email",
      "type": "email",
      "required": true
    }
  ],
  "submit_label": "Отправить",
  "success_message": "Спасибо! Мы свяжемся с вами в ближайшее время.",
  "redirect_url": "https://example.com/thanks"
}

Шаблон chunk ​

Fenom chunk pagebuilderpro_contact_form рисует обложку и при наличии FetchIt вызывает:

fenom
{'!FetchIt' | snippet : [
  'snippet' => 'PageBuilderContactForm',
  'form' => 'pagebuilderpro_contact_form_fields',
]}

Точный вызов смотрите в файле пакета. Без FetchIt: лексикон pagebuilder_fe_form_unavailable.

JSON-определение ​

PageBuilderPro/core/components/pagebuilderpro/sections/contact_form.json

Связанные страницы ​