Кастомные формы

Вкладка «Кастомные формы» используется для форм, которые модуль не может однозначно определить как стандартные. Это могут быть собственные компоненты, формы в нестандартном шаблоне, формы стороннего решения или простая HTML-форма проекта.

[Скриншот 1: вкладка Кастомные формы с одной зарегистрированной формой]

Когда нужна регистрация кастомной формы

Используйте эту вкладку, если:

• форма отсутствует на вкладке «Настройки форм»;
• на странице есть несколько похожих форм, и нужно явно указать одну из них;
• форма создаётся собственным компонентом;
• автоматическое определение выбирает неправильный идентификатор;
• нужно дать форме понятное имя в административной части.

Поле «ID формы»

Уникальный идентификатор внутри SenDev: Protect. Используйте короткое стабильное значение, например contact_form, callback или price_request.

ID не должен меняться после настройки. Если изменить его, модуль будет воспринимать запись как другую форму, а старые индивидуальные настройки останутся привязаны к прежнему идентификатору.

Поле «Название»

Понятное название для администратора. Оно отображается в общем списке форм. Например: «Заказать звонок в шапке», «Запрос цены», «Форма дилера».

Поле «CSS-селектор (опционально)»

Поле можно использовать как служебную подсказку о том, где находится форма, например form#callback. Однако в стандартной логике версии 0.9.02 сохранённый селектор не является основным механизмом автоматического поиска формы.

Для надёжной привязки используйте явный атрибут data-sendev-form-id в теге формы. Его значение должно точно совпадать с «ID формы» в этой вкладке.

Что нужно передать разработчику

Если вы не редактируете шаблоны самостоятельно, достаточно сообщить разработчику две вещи:

1. ID, который создан на вкладке «Кастомные формы»;
2. необходимость добавить этот ID в data-sendev-form-id соответствующего тега формы.

После этого форма появится в общей конфигурации и сможет использовать индивидуальную защиту.

[Скриншот 2: пример поля ID кастомной формы и подсказки с data-sendev-form-id]

Как завершить настройку

1. Добавьте запись на вкладке «Кастомные формы».
2. Укажите ID и название.
3. Сохраните настройки.
4. Убедитесь, что публичная форма содержит соответствующий идентификатор.
5. Откройте вкладку «Настройки форм».
6. Найдите строку «Кастомная: ваше название».
7. Включите защиту и выберите тип.
8. Сохраните настройки и протестируйте страницу.

Если на странице несколько экземпляров одной формы

Если один и тот же ID используется у нескольких форм, настройки будут общими. Это удобно, когда одинаковая форма «Заказать звонок» повторяется в нескольких местах. Если формы должны иметь разную защиту, назначьте им разные ID.

Форма с собственным id или name

Модуль умеет получать идентификатор из некоторых стандартных признаков формы, однако такой автоматически сформированный ID может не совпасть с записью, которую вы создали вручную. Для предсказуемой работы кастомной интеграции лучше использовать явный data-sendev-form-id.

Что проверить при проблемах

• ID в административной части и на странице совпадает символ в символ;
• форма действительно находится внутри тега form;
• модуль включён;
• у кастомной формы включена защита на вкладке «Настройки форм»;
• страница была обновлена после сохранения настроек;
• нет ошибки JavaScript на странице.

[Скриншот 3: кастомная форма в общем списке Настройки форм после регистрации]

Что не нужно делать

Не создавайте несколько записей с одинаковым ID и не меняйте ID только ради изменения отображаемого названия. Название можно менять свободно, а идентификатор лучше оставить постоянным.