Как решить проблему неотображения видеоурока в LearnPress после обновления

Диагностика проблемы с видеоуроками в LearnPress после обновления

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

Чтобы диагностировать проблему, выполните следующие шаги:

• Откройте консоль браузера (F12 > Console) и проверьте наличие ошибок JavaScript.
• Проверьте, загружаются ли файлы видео с корректного URL (Network).
• Убедитесь, что в настройках урока в админке правильно указан тип видео (YouTube, Vimeo, локальный файл и пр.).
• Отключите временно все сторонние плагины, кроме LearnPress, чтобы исключить конфликт.
• Переключитесь на стандартную тему WordPress (например, Twenty Twenty-Three) для проверки влияния темы.

Пример ошибки в консоли

Частая ошибка – "Uncaught TypeError: Cannot read property 'play' of undefined", указывающая, что видео-плеер не инициализирован.

Пошаговое решение проблемы неотображения видеоуроков

1. Проверка и настройка типа видео в LearnPress

Перейдите в админку WordPress > LearnPress > Уроки > откройте проблемный урок. В мета-боксе "Видео урок" убедитесь, что выбран правильный тип видео:

• Если видео с YouTube/Vimeo – используйте URL в формате https://www.youtube.com/watch?v=xxxxx
• Для локальных видео – укажите правильный путь к загруженному файлу в медиабиблиотеке.

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

Добавьте в functions.php вашей дочерней темы следующий код, чтобы гарантировать загрузку JS плеера LearnPress:

function lp_force_enqueue_video_scripts() {
    if ( is_singular( 'lp_lesson' ) ) {
        wp_enqueue_script( 'learnpress-video', LP_PLUGIN_URL . 'assets/js/frontend/video.js', array( 'jquery' ), LP_VERSION, true );
    }
}
add_action( 'wp_enqueue_scripts', 'lp_force_enqueue_video_scripts' );

Замените LP_PLUGIN_URL и LP_VERSION на константы LearnPress, если они не определены, укажите путь и версию вручную.

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

Если в консоли ошибка, связанная с конфликтом библиотек, отключите плагины по очереди и проверьте повторное появление видео. Часто помогает добавление в functions.php следующего кода для устранения конфликта jQuery:

function lp_fix_jquery_conflict() {
    wp_deregister_script('jquery');
    wp_enqueue_script('jquery', includes_url('/js/jquery/jquery.js'), false, null, true);
}
add_action('wp_enqueue_scripts', 'lp_fix_jquery_conflict', 1);

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

После внесения изменений:

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

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

• Видео не загружается, а URL правильный: Проверьте настройки приватности видео на YouTube и Vimeo, видео должно быть доступно без ограничений.
• Плеер отображается, но кнопка воспроизведения не работает: Возможен конфликт JS. Попробуйте отключить другие плагины или использовать стандартную тему.
• Видео загружается, но не отображается в мобильной версии: Проверьте CSS-стили, возможно, плеер скрыт медиа-запросами.
• Ошибка «Uncaught ReferenceError» в консоли: Проверьте правильность подключения скриптов и порядок загрузки.

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

• Для локальных видео используйте современные форматы (MP4 с H.264) и обеспечьте поддержку потоковой передачи (HTTP Range requests).
• Используйте CDN для доставки видео, если трафик большой.
• Не загружайте все видеоуроки сразу на странице курса – загружайте по требованию через AJAX, чтобы уменьшить нагрузку.
• Ограничьте доступ к видео только для авторизованных пользователей с помощью плагинов защиты контента.

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