Contact Form 7: запрет отправки пустых форм с пользовательской валидацией

Диагностика проблемы: почему пустые формы проходят валидацию

Contact Form 7 по умолчанию проверяет только обязательные поля, помеченные атрибутом required. Если в форме нет обязательных полей или они неправильно указаны, форма может отправляться пустой. Это приводит к получению мусорных заявок и ухудшает качество данных.

Проверка:

• Создайте форму с несколькими полями без атрибута required.
• Попробуйте отправить форму без заполнения.
• Если форма отправляется, проблема подтверждена.

Пошаговое решение: добавление пользовательской проверки пустых полей на стороне сервера

Для точного контроля над валидацией используйте хук wpcf7_validate, который позволяет добавить собственные проверки для любого поля.

Пример кода, который запрещает отправку, если все поля пустые:

add_filter('wpcf7_validate', 'cf7_custom_empty_fields_validation', 20, 2); 
function cf7_custom_empty_fields_validation($result, $tag) {
    // Только для конкретной формы (по ID)
    $form_id = 123; // замените на ID вашей формы
    $submission = WPCF7_Submission::get_instance();
    if (!$submission) {
        return $result;
    }
    $posted_data = $submission->get_posted_data();
    if (!$posted_data) {
        return $result;
    }

    if ($tag->basetype === 'text' || $tag->basetype === 'email' || $tag->basetype === 'tel' || $tag->basetype === 'textarea') {
        // Проверяем все поля, кроме скрытых
        $all_empty = true;
        foreach ($posted_data as $key => $value) {
            if (!empty(trim($value))) {
                $all_empty = false;
                break;
            }
        }
        if ($all_empty) {
            $result->invalidate($tag, 'Пожалуйста, заполните хотя бы одно поле.');
        }
    }
    return $result;
}

Обязательно замените $form_id на ваш реальный ID формы, чтобы не влиять на все формы сайта.

Как узнать ID формы Contact Form 7

ID отображается в списке форм в админке WordPress, либо в шорткоде [contact-form-7 id="123"].

Проверка результата после внедрения

• Откройте страницу с формой.
• Попытайтесь отправить форму с пустыми полями.
• Должна появиться ошибка валидации с сообщением «Пожалуйста, заполните хотя бы одно поле.» и форма не отправится.
• Заполните хотя бы одно поле и отправьте — форма должна успешно отправиться.

Частые ошибки и как их исправить

• Хук не срабатывает: Убедитесь, что код добавлен в файл functions.php темы или в плагин для пользовательского кода и что он выполняется.
• Ошибка из-за некорректного ID формы: Проверьте, что $form_id совпадает с ID вашей формы.
• Проверка всех полей, включая скрытые: В коде фильтра можно исключить поля с типом hidden, чтобы не блокировать отправку.
• Сообщение об ошибке не отображается: Проверьте, что в настройках CF7 включена поддержка вывода ошибок и что тема корректно отображает ошибки.

Практические советы по безопасности и производительности

• Не используйте required на всех полях без необходимости — это ухудшает UX.
• Пользовательская валидация на сервере — обязательна для защиты от обхода JavaScript на клиенте.
• Избегайте тяжелых циклов и сложных условий в хуках валидации, чтобы не замедлять обработку формы.
• Если форма большая, ограничьте проверку только нужных полей по имени или типу.

Альтернативные методы решения