Как использовать хуки для расширения функциональности WP Quiz в WordPress

Плагин WP Quiz — мощный инструмент для создания интерактивных викторин на вашем сайте WordPress. Однако стандартный функционал иногда не позволяет реализовать все задумки, особенно если нужны нестандартные механики или интеграции. В таких случаях на помощь приходят хуки — действия (actions) и фильтры (filters), которые встроены в WP Quiz и позволяют расширять возможности плагина без изменения исходного кода.

Что такое хуки в WordPress и WP Quiz

Хуки — это специальные точки в коде, где можно «подцепить» свою функцию и выполнить дополнительный код. В WordPress они делятся на два типа:

• Actions (Действия) — позволяют выполнять код в определённый момент.
• Filters (Фильтры) — дают возможность изменить данные перед их использованием или выводом.

WP Quiz, как и многие качественные плагины, использует собственные хуки, которые позволяют вмешиваться в процесс создания и отображения квизов.

Основные хуки WP Quiz для разработчиков

Для начала разберём несколько основных хуков, которые предоставляет WP Quiz. Они пригодятся для добавления своих функций, изменения логики подсчёта баллов, кастомизации вывода вопросов или результатов.

Action hook: wpquiz_after_quiz_display

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

function wpquizru_add_custom_message_after_quiz() {
    echo '<div class="wpquiz-custom-message">Спасибо за участие в квизе!</div>';
}
add_action('wpquiz_after_quiz_display', 'wpquizru_add_custom_message_after_quiz');

Filter hook: wpquiz_question_content

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

function wpquizru_add_hint_to_question($content, $question) {
    $hint = '<p class="wpquiz-hint">Подумайте хорошо, прежде чем ответить!</p>';
    return $content . $hint;
}
add_filter('wpquiz_question_content', 'wpquizru_add_hint_to_question', 10, 2);

Filter hook: wpquiz_score_calculation

Этот фильтр позволяет модифицировать алгоритм подсчёта баллов. По умолчанию WP Quiz считает баллы просто, но если вам нужно, например, весить вопросы по-разному или учитывать время на ответ, этот фильтр поможет.

function wpquizru_custom_score_calculation($score, $answers) {
    $custom_score = 0;
    foreach ($answers as $answer) {
        // Добавляем 2 балла за каждый правильный ответ вместо 1
        if ($answer['is_correct']) {
            $custom_score += 2;
        }
    }
    return $custom_score;
}
add_filter('wpquiz_score_calculation', 'wpquizru_custom_score_calculation', 10, 2);

Примеры практического применения хуков WP Quiz

Добавление пользовательского CSS класса к результатам квиза

Допустим, вы хотите стилизовать блок с результатами в зависимости от набранных баллов. Для этого можно использовать фильтр, который изменит класс контейнера результатов:

function wpquizru_add_result_class($classes, $score) {
    if ($score > 80) {
        $classes[] = 'wpquiz-result-excellent';
    } elseif ($score > 50) {
        $classes[] = 'wpquiz-result-good';
    } else {
        $classes[] = 'wpquiz-result-bad';
    }
    return $classes;
}
add_filter('wpquiz_result_classes', 'wpquizru_add_result_class', 10, 2);

После этого можно добавить стили в файл темы или через кастомизатор:

.wpquiz-result-excellent {background-color: #d4edda; color: #155724;}
.wpquiz-result-good {background-color: #fff3cd; color: #856404;}
.wpquiz-result-bad {background-color: #f8d7da; color: #721c24;}

Автоматическое отправление email с результатами после прохождения квиза

Хотите, чтобы после прохождения квиза пользователь получал на почту свои результаты? С помощью action-хука можно отправить письмо:

function wpquizru_send_results_email($user_id, $quiz_id, $score) {
    $user_info = get_userdata($user_id);
    $to = $user_info->user_email;
    $subject = 'Ваши результаты квиза';
    $message = "Здравствуйте, {$user_info->display_name}!\nВы набрали {$score} баллов в квизе №{$quiz_id}. Спасибо за участие!";
    wp_mail($to, $subject, $message);
}
add_action('wpquiz_after_quiz_completed', 'wpquizru_send_results_email', 10, 3);

Как найти доступные хуки WP Quiz для своих задач

Чтобы эффективно использовать хуки, нужно знать, какие именно доступны в плагине. Можно сделать так:

• Открыть исходный код плагина и найти вызовы do_action() и apply_filters().
• Почитать официальную документацию WP Quiz, если она есть.
• Обратиться к сообществу или поддержке разработчиков WP Quiz.

Например, в файле includes/class-wpquiz-frontend.php часто находятся хуки, связанные с выводом квизов.

Советы по работе с хуками в WP Quiz

• Всегда используйте префикс (например, wpquizru_) для своих функций, чтобы избежать конфликтов.
• Проверяйте, что ваши функции работают корректно и не вызывают ошибок.
• Используйте хуки для расширения, а не изменения исходного кода плагина — так обновления не сломают ваши доработки.
• Тестируйте на тестовом сайте, прежде чем внедрять на боевой.

Использование хуков — это профессиональный способ кастомизации WP Quiz, позволяющий создать уникальный и функциональный квиз, который точно подойдёт под ваши задачи.

Если хотите ознакомиться с дополнительными плагинами для улучшения WP Quiz, рекомендую обратить внимание на WP Quiz Pro на сайте WPSHOP — он расширяет базовый функционал и также поддерживает хуки для разработчиков.