К содержимому
Настройка

Настройка

Обновлено

Общая настройка

Откройте «Магазин» → «Плагины» → «Видео из RuTube».

Настройка Что делает Значения / по умолчанию
Кэш, секунд Поле объявлено в конфигурации, но его значение не читается кодом получения, хранения и вывода видео. Изменение поля не управляет сроком хранения метаданных в текущей реализации Поле ввода; по умолчанию 600

Подсказка к полю говорит, что 0 отключает кэш и кэшируются разобранные метаданные Open Graph. Реализация получает данные через JSON API RuTube и хранит их в базе данных. Поэтому не используйте это поле для принудительного обновления или отключения хранения метаданных.

Поля плейлиста

Откройте «Магазин» → «RuTube видео». Выберите существующий плейлист или нажмите «+ Новый плейлист».

Настройка Что делает Значения / по умолчанию
Название Название плейлиста; стандартный шаблон выводит его над роликами Текст, обязательное поле; у нового плейлиста пустое
Описание Описание всего плейлиста; стандартный шаблон выводит его под названием как текст Необязательный текст; у нового плейлиста пустое
Ссылки на видео RuTube Определяет состав плейлиста; при сохранении плагин извлекает ID роликов и обрабатывает метаданные По одной ссылке на строку; у нового плейлиста пустое; требуется хотя бы одна непустая строка

Названия, описания и превью отдельных роликов загружаются из RuTube. Полей для их ручного редактирования в форме нет.

Форматы ссылок

Распознаются следующие пути с идентификатором ролика из 32 шестнадцатеричных символов:

https://rutube.ru/video/VIDEO_ID/
https://rutube.ru/video/private/VIDEO_ID/
https://rutube.ru/play/embed/VIDEO_ID/
https://rutube.ru/shorts/VIDEO_ID/

VIDEO_ID нужно заменить реальным идентификатором. Распознавание пути video/private/ не гарантирует доступ к закрытому ролику: плагин не передаёт RuTube данные авторизации или параметры доступа из исходной ссылки в плеер.

Пустые строки при обработке пропускаются. Нераспознанные ссылки не попадают в список видео для вывода. Проверка сохранения требует непустого поля, но не гарантирует наличия в нём корректной ссылки.

Сохранение и удаление

Кнопка «Сохранить» сохраняет поля и обрабатывает список ссылок. Для новых видео плагин получает метаданные или копирует уже полученные данные такого же ролика из другого плейлиста. Если убрать ссылку и сохранить плейлист, соответствующее видео удаляется из его состава.

Сохранить полностью пустое поле «Ссылки на видео RuTube» нельзя: появится ошибка «Добавьте хотя бы одну ссылку на видео». Для удаления всего плейлиста нажмите «Удалить» и подтвердите «Удалить плейлист?». После удаления обновите шаблоны и записи блога, где использован его ID.

Не считайте число рядом с плейлистом проверкой доступности роликов: интерфейс считает строки исходного поля, а не успешно полученные метаданные.

Когда обновляются метаданные

Просмотр витрины читает данные из базы без запроса метаданных к RuTube. При повторном сохранении существующего видео запрос выполняется, если метаданные ещё не получены, отсутствует название или изображение. Также повторный запрос предусмотрен при счётчике получений от трёх и давности последнего получения более семи дней.

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