Диагностика и проверка работы

Вкладка «Диагностика» собирает основные признаки готовности модуля. Её следует открывать после установки, после смены CAPTCHA и при проблемах с отдельными формами.

[Скриншот 1: вкладка Диагностика с блоками статуса модуля, CAPTCHA и форм]

Статус модуля

Проверьте:

• включён ли модуль;
• включено ли логирование;
• существует ли таблица журнала;
• сколько записей накоплено.

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

Состояние CAPTCHA

Диагностика показывает выбранного провайдера и проверяет наличие необходимых ключей для основных поддерживаемых вариантов.

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

Таблица защиты форм

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

• название;
• активна ли защита;
• выбранный тип;
• сводный статус.

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

[Скриншот 2: таблица форм в Диагностике с активными и неактивными строками]

Проверка в публичной части

Диагностика административной страницы — только первый этап. После неё обязательно откройте реальную форму:

1. обновите страницу после сохранения настроек;
2. проверьте появление блока защиты;
3. выполните неправильную проверку;
4. убедитесь, что форма не отправилась;
5. выполните правильную проверку;
6. убедитесь, что форма отправилась обычным способом и пользователь увидел штатный результат.

Если блок защиты не появился

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

Если неправильный ответ всё равно отправляет форму

Проверьте, что блок относится именно к нужной форме и что отправка происходит через стандартное событие формы. Для нестандартных сценариев или сторонних компонентов может потребоваться адаптация шаблона.

Если штатная веб-форма после проверки не создаёт результат

Версия 0.9.02 содержит исправление именно для этого сценария: при программной отправке сохраняется исходная submit-кнопка, а для штатных веб-форм используется серверная проверка перед добавлением результата. Если проблема остаётся после обновления, проверьте, что файлы модуля действительно обновлены до 0.9.02 и страница не использует старый JavaScript из кэша.

Если CAPTCHA не проходит

Проверьте выбранного провайдера, публичный и секретный ключи, а для reCAPTCHA v3 — минимальный score. Для custom-провайдера дополнительно проверьте поле ответа и адрес проверки.

Проверка в режиме инкогнито

Для диагностики полезно открыть форму в приватном окне. Это снижает влияние старого кэша, расширений и сохранённого состояния страницы.

[Скриншот 3: успешная проверка формы в публичной части и новая запись в статистике]

После каждого изменения

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