Как автоматически устанавливать миниатюры видео в WordPress

Автор: Татьяна Тарасова | Опубликовано: 30.12.2025

Миниатюры (thumbnails) играют ключевую роль в привлекательном отображении видео в WordPress. Особенно если вы ведёте видеоблог, новостной портал или учебный сайт с большим количеством видео контента, вручную создавать миниатюры для каждого видео неудобно и долго. В этой статье мы подробно разберём, как автоматически создавать и устанавливать миниатюры для видео в WordPress с помощью кода и полезных плагинов.

Почему автоматическое создание миниатюр для видео важно

Миниатюры — это первое, что видит пользователь, выбирая видео для просмотра. Хорошее изображение повышает кликабельность и улучшает UX сайта. Однако при большом количестве видео вручную создавать превью неэффективно. Автоматизация процесса позволяет:

Сэкономить время и силы на обработке каждого видео;
Обеспечить единообразие и качество миниатюр;
Избавиться от ошибок и забывчивости при добавлении превью;
Автоматически обновлять миниатюры при смене видео.

Давайте рассмотрим, как реализовать это на практике.

Автоматическая генерация миниатюр из загруженных видео — пример кода

Если видео загружаются на ваш сервер, можно автоматически извлекать кадр из видео и устанавливать его в качестве миниатюры записи. Для этого понадобится PHP-библиотека FFmpeg и WordPress-хук save_post.

Настройка FFmpeg на сервере

FFmpeg — мощный инструмент для работы с аудио и видео. Убедитесь, что он установлен и доступен из PHP, например, через команду ffmpeg -version в терминале. Если нет — обратитесь к хостеру или установите самостоятельно.

Пример функции для создания миниатюры из видео

function wpvideo_generate_video_thumbnail($post_id) {
    // Проверяем, что это видео-пост и что миниатюра не установлена
    if (get_post_type($post_id) !== 'post') return;
    if (has_post_thumbnail($post_id)) return;

    $video_url = get_post_meta($post_id, 'video_url', true); // Пусть видео хранится в мета-поле
    if (!$video_url) return;

    $upload_dir = wp_upload_dir();
    $thumbnail_path = $upload_dir['path'] . '/thumb_' . $post_id . '.jpg';

    // Путь к видео на сервере
    $video_path = str_replace($upload_dir['baseurl'], $upload_dir['basedir'], $video_url);

    // Команда FFmpeg для извлечения кадра на 5-й секунде
    $cmd = "ffmpeg -i " . escapeshellarg($video_path) . " -ss 00:00:05 -vframes 1 " . escapeshellarg($thumbnail_path) . " -y";

    exec($cmd, $output, $return_var);
    if ($return_var !== 0) return; // Ошибка при создании миниатюры

    // Добавляем изображение в медиа библиотеку
    $filetype = wp_check_filetype(basename($thumbnail_path), null);
    $attachment = array(
        'post_mime_type' => $filetype['type'],
        'post_title' => 'Thumbnail for post ' . $post_id,
        'post_content' => '',
        'post_status' => 'inherit'
    );
    $attach_id = wp_insert_attachment($attachment, $thumbnail_path, $post_id);
    require_once(ABSPATH . 'wp-admin/includes/image.php');
    $attach_data = wp_generate_attachment_metadata($attach_id, $thumbnail_path);
    wp_update_attachment_metadata($attach_id, $attach_data);

    set_post_thumbnail($post_id, $attach_id);
}
add_action('save_post', 'wpvideo_generate_video_thumbnail');

В этом коде при сохранении поста, в котором в мета-поле video_url указан путь к видеозаписи, создаётся миниатюра из 5-й секунды видео и устанавливается как изображение записи. Так вы полностью автоматизируете процесс.

Работа с видео с YouTube и Vimeo — как автоматически получить миниатюру

Если вы вставляете видео с YouTube или Vimeo, загружать видео на сервер нельзя. Но можно автоматически получить ссылку на миниатюру видео через API или простой парсинг URL.

Получение миниатюры YouTube

Для YouTube достаточно знать ID видео. Например, для ссылки https://www.youtube.com/watch?v=abc123 ID — abc123. Миниатюры доступны по адресу:

Максимальное качество: https://img.youtube.com/vi/abc123/maxresdefault.jpg
Стандартное качество: https://img.youtube.com/vi/abc123/hqdefault.jpg

Можно написать функцию для автоматического получения ID из URL и установки миниатюры:

function wpvideo_set_youtube_thumbnail($post_id) {
    if (has_post_thumbnail($post_id)) return;
    $video_url = get_post_meta($post_id, 'video_url', true);
    if (!$video_url) return;

    preg_match('/v=([\w-]+)/', $video_url, $matches);
    if (empty($matches[1])) return;

    $video_id = $matches[1];
    $thumbnail_url = "https://img.youtube.com/vi/" . $video_id . "/maxresdefault.jpg";

    // Загружаем изображение в медиабиблиотеку
    $tmp = download_url($thumbnail_url);
    if (is_wp_error($tmp)) return;

    $file_array = array(
        'name' => $video_id . '.jpg',
        'tmp_name' => $tmp
    );

    $attach_id = media_handle_sideload($file_array, $post_id);
    if (is_wp_error($attach_id)) {
        @unlink($tmp);
        return;
    }

    set_post_thumbnail($post_id, $attach_id);
}
add_action('save_post', 'wpvideo_set_youtube_thumbnail');

Миниатюры Vimeo

У Vimeo миниатюры можно получить через API. Пример запроса:

https://vimeo.com/api/v2/video/VIDEO_ID.json

В ответе содержится URL миниатюры, который можно скачать и установить как миниатюру записи. Для автоматизации используйте функцию wp_remote_get и аналогично загрузите изображение в медиабиблиотеку.

Полезные плагины для работы с видео миниатюрами в WordPress

Если не хотите писать свой код, можно использовать готовые решения. Вот несколько плагинов, которые подходят для автоматической установки миниатюр видео:

Video Thumbnails — автоматически находит и задаёт миниатюры для видео с YouTube, Vimeo и загруженных файлов.
Featured Video Plus — позволяет назначить видео как миниатюру записи с поддержкой популярных видео платформ.
OmniVideo от WPSHOP — плагин для удобного добавления видео с автоматической генерацией превью, оптимизированный для SEO.

Использование таких плагинов сэкономит время и расширит возможности сайта без программирования.

Как интегрировать автоматическое создание миниатюр с WPGPT и Clearfy Pro

Если вы используете на сайте WPGPT для генерации описаний или Clearfy Pro для оптимизации, можно связать эти инструменты с созданием миниатюр:

WPGPT поможет автоматически создавать текстовые описания к видео, которые можно прикреплять к миниатюрам;
Clearfy Pro оптимизирует скорость загрузки сайта, снижая нагрузку от дополнительных запросов к миниатюрам и их кэширования.

Такой комплексный подход улучшит UX и SEO вашего видео портала.

Советы по отладке и оптимизации

При автоматической генерации миниатюр следите за следующими моментами:

Права доступа к видеофайлам и папкам загрузок должны позволять чтение и запись;
FFmpeg вызывает нагрузку на сервер — планируйте задачи по созданию миниатюр в моменты низкой загрузки;
Используйте кэширование миниатюр и CDN для быстрой отдачи изображений;
Проверяйте корректность URL видео и обработку ошибок в коде.

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