SenDev: Protect — это универсальное решение для защиты форм на сайте от спам-ботов. Модуль автоматически определяет формы на сайте и применяет к ним выбранную защиту без необходимости правки исходного кода.

Возможности

Автоматическое определение форм

Модуль автоматически находит и защищает следующие формы:

• main_feedback — обратная связь (классический спам-таргет)
• main_register — регистрация (бот-регистрации)
• main_subscribe — подписка на рассылку (бот-подписки)

Методы защиты

Поддерживаемые CAPTCHA-провайдеры

• Google reCAPTCHA v2 — классическая капча с чекбоксом "Я не робот"
• Google reCAPTCHA v3 — невидимая капча с оценкой риска (0.0–1.0)
• Yandex SmartCaptcha — умная капча от Яндекса
• hCaptcha — приватная альтернатива Google
• Custom — универсальная интеграция для других сервисов (Turnstile, FriendlyCaptcha и др.)

Гибкая настройка

Для каждой формы можно настроить:

• Активность защиты — включить/выключить индивидуально
• Тип защиты — выбрать из 5 доступных методов
• Сложность — легкая, средняя, сложная (для математики, логики, игры)
• Таймаут — минимальное время заполнения (для защиты по времени)

Статистика и логирование

• Общая статистика — количество попыток, успешных отправок, заблокированных
• Статистика по дням — детальная информация за выбранный период
• Эффективность защиты — процент заблокированных попыток
• Экспорт логов — выгрузка данных в CSV
• Диагностика — проверка состояния модуля и настроек

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

Для форм, которые не определяются автоматически, можно:

1. Добавить атрибут data-sendev-form-id="ваш_id" к тегу <form>
2. Зарегистрировать форму в настройках модуля
3. Настроить параметры защиты

Преимущества

Как настроить защиту для конкретной формы

Пошаговая инструкция

1. Откройте настройки модуля

Перейдите в административную панель сайта:

Сервисы → SenDev: Protect → Настройки

2. Перейдите на вкладку «Настройки форм»

В интерфейсе настроек вы увидите несколько вкладок. Выберите «Настройки форм» — там отображается список всех доступных форм на вашем сайте.

3. Найдите нужную форму

Модуль автоматически сканирует сайт и находит все формы. В таблице вы увидите:

4. Включите защиту

Установите галочку в колонке «Защита» напротив нужной формы.

5. Выберите тип защиты

В выпадающем списке «Тип» выберите один из доступных методов:

6. Настройте сложность

В колонке «Сложность» выберите уровень:

• Легкая — простые примеры и вопросы
• Средняя — умеренная сложность
• Сложная — сложные задания

7. Установите таймаут (для защиты по времени)

Если выбрали тип «Время», укажите минимальное время заполнения формы в секундах (рекомендуется 3-5 секунд).

8. Сохраните настройки

Нажмите кнопку «Сохранить» внизу страницы. Настройки применятся мгновенно.

Рекомендации по выбору типа защиты

Для разных типов форм

Советы

• Не используйте сложную защиту для форм авторизации и регистрации — это может отпугнуть пользователей
• Для защиты по времени достаточно 3-5 секунд — этого хватит, чтобы отличить человека от бота
• CAPTCHA лучше использовать только для критически важных форм, так как она может снижать конверсию

Что делать, если форма не определяется автоматически?

Некоторые формы (особенно кастомные или созданные через сторонние компоненты) могут не определяться модулем автоматически. В этом случае нужно зарегистрировать форму вручную.

Шаг 1: Добавьте атрибут к форме

Откройте файл с формой (обычно это .php файл в папке шаблона) и добавьте атрибут data-sendev-form-id к тегу <form>:

<!-- Было -->
<form action="/send.php" method="post">
    <input type="text" name="name">
    <input type="email" name="email">
    <button type="submit">Отправить</button>
</form>

<!-- Стало -->
<form action="/send.php" method="post" data-sendev-form-id="my_contact_form">
    <input type="text" name="name">
    <input type="email" name="email">
    <button type="submit">Отправить</button>
</form>

Важно:

• Значение атрибута должно быть уникальным для каждой формы
• Используйте только латинские буквы, цифры и символы подчеркивания
• Не используйте пробелы и специальные символы

Шаг 2: Зарегистрируйте форму в модуле

1. Откройте настройки модуля: Настройки → Настройки продукта → Модули → SenDev: Protect
2. Перейдите на вкладку «Кастомные формы»
3. Нажмите кнопку «+ Добавить форму»
4. Заполните поля:

5. Нажмите «Сохранить»

Шаг 3: Настройте защиту

1. Перейдите на вкладку «Формы»
2. Найдите вашу кастомную форму в списке (она будет помечена как «кастомная»)
3. Включите защиту и выберите тип, как описано выше
4. Сохраните настройки

Примеры использования

Пример 1: Защита формы обратной связи

<!-- HTML форма -->
<form action="/feedback.php" method="post" data-sendev-form-id="footer_feedback">
    <input type="text" name="name" placeholder="Ваше имя">
    <input type="email" name="email" placeholder="E-mail">
    <textarea name="message" placeholder="Сообщение"></textarea>
    <button type="submit">Отправить</button>
</form>

Настройки в модуле:

• Тип защиты: Математика
• Сложность: Легкая
• Таймаут: не требуется

Пример 2: Защита кастомной формы заявки

<!-- HTML форма -->
<form action="/order.php" method="post" data-sendev-form-id="quick_order">
    <input type="text" name="phone" placeholder="Телефон">
    <input type="text" name="product" placeholder="Товар">
    <button type="submit">Заказать</button>
</form>

Настройки в модуле:

• Тип защиты: Логика
• Сложность: Средняя
• Таймаут: не требуется

Настройки в модуле:

• Тип защиты: Время
• Сложность: не требуется
• Таймаут: 3 секунды

Возможные проблемы и решения

Проблема: Форма не появляется в списке

Решение:

1. Убедитесь, что модуль активен (вкладка «Основные настройки» → «Активность модуля»)
2. Очистите кэш сайта: Настройки → Настройки продукта → Производительность → Очистить кэш
3. Обновите страницу с настройками модуля
4. Если форма кастомная — проверьте правильность атрибута data-sendev-form-id

Проблема: Защита не отображается на форме

Решение:

1. Проверьте, что защита включена для этой формы (вкладка «Формы»)
2. Откройте консоль браузера (F12) и проверьте наличие ошибок JavaScript
3. Убедитесь, что на странице подключены скрипты модуля
4. Попробуйте открыть страницу в режиме инкогнито (без кэша)

Проблема: Форма не отправляется после включения защиты

Решение:

1. Проверьте, правильно ли введен ответ на вопрос защиты
2. Убедитесь, что в форме есть поля sendev_protect_answer и sendev_protect_token (они добавляются автоматически)
3. Проверьте логи модуля (вкладка «Статистика») — там могут быть подсказки об ошибке
4. Временно отключите защиту для этой формы и проверьте, отправляется ли форма без неё

Полезные советы

1. Тестируйте защиту

После настройки обязательно протестируйте форму:

• Откройте страницу с формой
• Попробуйте отправить форму с правильным ответом
• Попробуйте отправить форму с неправильным ответом
• Проверьте, что защита действительно блокирует неверные попытки

2. Используйте статистику

Регулярно проверяйте статистику (вкладка «Статистика»):

• Сколько попыток заблокировано
• Какая эффективность защиты
• Какие формы чаще всего атакуются

3. Настройте логирование

Включите логирование в основных настройках — это поможет отслеживать попытки спама и настраивать защиту более точно.

4. Обновляйте вопросы

Если используете логическую защиту, периодически обновляйте вопросы в настройках (вкладка «Вопросы и ответы»), чтобы спамеры не смогли «запомнить» ответы.

Эта инструкция поможет вам быстро и правильно настроить защиту для любых форм на вашем сайте!