Решение проблемы несинхронизации оценок и результатов в Quizle и LearnPress

Диагностика проблемы с синхронизацией результатов Quizle и LearnPress

Несинхронизация оценок и результатов тестов, созданных на базе Quizle, с данными LearnPress — частая проблема при интеграции плагинов для обучающих платформ. В результате пользователь видит неправильный прогресс курса, а администратор — некорректные отчеты.

Основные признаки проблемы:

• Результаты тестов отображаются в Quizle, но не обновляют статус урока или курса в LearnPress.
• В отчетах LearnPress отсутствуют оценки или они не соответствуют фактическим результатам Quizle.
• Прогресс пользователя не меняется после прохождения теста.

Причины возникновения проблемы

• Отсутствие правильно настроенных хуков между Quizle и LearnPress.
• Кэширование на уровне сайта или сервера, блокирующее обновления.
• Конфликты с другими плагинами, особенно с кэш-плагинами и плагинами безопасности.
• Некорректная обработка AJAX-запросов, отвечающих за обновление статусов.

Пошаговое решение проблемы синхронизации

1. Проверка и добавление нужных хуков для обновления статусов

Quizle не всегда автоматически обновляет статусы LearnPress после завершения теста. Для решения добавим кастомный обработчик события завершения теста:

add_action('quizle_test_completed', 'lp_update_lesson_status_after_quizle', 10, 2);
function lp_update_lesson_status_after_quizle($user_id, $quiz_id) {
    // Получаем объект курса и урока
    $lesson_id = get_post_meta($quiz_id, '_lp_lesson_id', true);
    if (!$lesson_id) {
        return;
    }
    // Обновляем статус урока у пользователя
    lp_update_user_lesson_status($user_id, $lesson_id, 'completed');
    // Обновляем прогресс курса
    $course_id = learn_press_get_course_id_by_lesson($lesson_id);
    if ($course_id) {
        lp_update_user_course_progress($user_id, $course_id);
    }
}

Замените хуки и функции на актуальные, если в вашей версии LearnPress или Quizle они отличаются. При этом quizle_test_completed — это событие, которое должен вызывать Quizle после завершения теста.

2. Отключение кэширования для AJAX-запросов LearnPress и Quizle

Рекомендуется исключить из кэширования AJAX-запросы, отвечающие за обновление статусов:

function exclude_lp_quizle_ajax_from_cache($excluded_uris) {
    $excluded_uris[] = '/wp-admin/admin-ajax.php?action=lp_update_lesson_status';
    $excluded_uris[] = '/wp-admin/admin-ajax.php?action=quizle_complete_test';
    return $excluded_uris;
}
add_filter('rocket_cache_reject_uri', 'exclude_lp_quizle_ajax_from_cache'); // пример для WP Rocket

Проверьте аналогичные настройки для вашего плагина кэширования.

3. Проверка конфликтов с другими плагинами

Отключите все плагины кроме LearnPress и Quizle, проверьте, работает ли обновление статусов. Если да — включайте по одному для выявления конфликта.

Как проверить, что решение сработало

• Пройдите тест в Quizle под тестовой учетной записью.
• В админке LearnPress проверьте, обновился ли статус урока и курса для этого пользователя.
• Проверьте, что отчет о прохождении теста отображает актуальные оценки.
• Откройте инструменты разработчика в браузере и убедитесь, что AJAX-запросы завершаются успешно (статус 200).

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

• Хук не вызывается: убедитесь, что Quizle действительно генерирует событие завершения теста. Проверьте документацию или исходный код плагина.
• Неправильные ID уроков или курсов: проверьте, что метаданные _lp_lesson_id корректно привязаны к quiz.
• Кэширование мешает обновлению: временно отключите кэш, чтобы убедиться в этом. Настройте исключения для AJAX.
• Конфликты с другими плагинами: отключайте плагины поочередно, чтобы выявить конфликт.

Практические советы по оптимизации и безопасности

• Добавляйте проверку прав пользователя в функциях, обновляющих статусы, чтобы исключить возможность подделки запросов.
• Используйте nonce для AJAX-запросов, чтобы повысить безопасность.
• Оптимизируйте функции обновления прогресса, минимизируя количество запросов к базе данных.
• Регулярно обновляйте LearnPress и Quizle, чтобы использовать актуальные API и исправления.

Сравнение способов решения проблемы