WPForms отладка проблем с переадресацией после отправки формы в WordPress

Одной из частых проблем, с которой сталкиваются пользователи плагина WPForms, является некорректная переадресация после отправки формы. В этой статье мы подробно разберем, почему возникают ошибки с редиректом, как их диагностировать и решать, а также приведем примеры кода и настроек, которые помогут настроить правильное поведение формы.

Почему возникают проблемы с переадресацией в WPForms

WPForms позволяет настраивать действия после отправки формы, включая показ сообщения, перезагрузку страницы или редирект на URL. Однако неправильная настройка, конфликты с другими плагинами, кэширование и особенности темы могут привести к тому, что переадресация не работает или ведет на неправильный адрес.

Основные причины проблем с редиректом:

Конфликт с JavaScript на странице, блокирующий выполнение скриптов WPForms.
Использование кэш-плагинов, которые кэшируют страницу с формой и не позволяют корректно выполнить редирект.
Ошибка в URL переадресации (например, опечатка или неправильный формат).
Особенности темы или дочерней темы, которые переопределяют обработку скриптов.
Неправильное использование хуков WordPress для кастомизации поведения формы.

Как диагностировать проблемы с редиректом в WPForms

Первый шаг — проверить настройки самой формы. В WPForms в разделе Настройки > Подтверждения можно выбрать тип подтверждения: сообщение, страница или URL (редирект). Для редиректа необходимо выбрать «Перенаправление (Redirect)» и указать корректный URL.

Если настройки правильные, но редирект не происходит, рекомендуем выполнить следующие действия:

Отключить все плагины, кроме WPForms, и проверить форму — если редирект работает, значит конфликт вызван одним из плагинов.
Активировать дефолтную тему WordPress (например, Twenty Twenty-Three) для проверки влияния темы.
Включить режим отладки WordPress (define('WP_DEBUG', true); в wp-config.php) и посмотреть ошибки в консоли браузера и логе.
Проверить консоль браузера на наличие JavaScript-ошибок, которые могут прерывать выполнение скриптов WPForms.

Пример проверки JavaScript-консоли

Откройте инструменты разработчика браузера (F12 или Ctrl+Shift+I), перейдите на вкладку Console и посмотрите, нет ли ошибок красным цветом. Если есть ошибки, связанные с WPForms или другими скриптами, их нужно исправить.

Практические решения для исправления редиректа в WPForms

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

1. Отключение AJAX для формы

Иногда AJAX-отправка формы конфликтует с редиректом. В WPForms можно отключить AJAX, чтобы форма отправлялась стандартным способом и редирект срабатывал корректно.

Для этого в настройках формы в разделе Настройки > Общие снимите галочку с «Включить AJAX». После этого форма будет отправляться по классическому HTTP-запросу, и редирект будет работать надежно.

2. Использование хука для кастомной переадресации

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

Пример кода, который нужно добавить в файл functions.php вашей темы или в кастомный плагин:

add_action('wpforms_process_complete', 'wpform_ru_custom_redirect', 10, 4);function wpform_ru_custom_redirect($fields, $entry, $form_data, $entry_id) {    if ($form_data['id'] == 123) { // замените 123 на ID вашей формы        wp_redirect('https://wpform.ru/thank-you');        exit;    }}

Этот код проверяет ID формы и выполняет редирект на страницу благодарности после успешной обработки формы.

3. Проверка и очистка кэша

Если у вас установлен плагин кэширования (WP Super Cache, W3 Total Cache, LiteSpeed Cache и другие), убедитесь, что он не кэширует страницы с формой и не мешает работе JS. В настройках кэш-плагина добавьте исключения для страниц с формой, либо отключите кэширование на время теста.

4. Настройка корректного URL редиректа

В разделе подтверждения формы обязательно указывайте абсолютный URL с протоколом (https://), например https://wpform.ru/thank-you, а не относительный путь. Это уменьшит вероятность ошибок с неправильным редиректом.

Дополнительные советы и рекомендации

Использование консольных функций WPForms для отладки

WPForms предоставляет глобальный объект JavaScript wpforms, который можно использовать для отладки. Например, можно подписаться на событие отправки формы и логировать данные:

document.addEventListener('DOMContentLoaded', function() {    wpforms.ready(function() {        wpforms.on('submit', function(formData) {            console.log('WPForms submit:', formData);        });    });});

Этот подход поможет отследить, вызывается ли событие отправки, и понять, есть ли проблемы на клиентской стороне.

Резюме по устранению проблем с редиректом

Проверяйте настройки подтверждения в WPForms — используйте абсолютный URL для редиректа.
Отключайте AJAX, если он вызывает проблемы с редиректом.
Используйте хук wpforms_process_complete для программных решений.
Проверяйте конфликты с другими плагинами и темой.
Исключайте страницы с формой из кэширования.