Настройка
Обновлено
Общая настройка
Откройте «Магазин» → «Плагины» → «Видео из 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. При повторном сохранении существующего видео запрос выполняется, если метаданные ещё не получены, отсутствует название или изображение. Также повторный запрос предусмотрен при счётчике получений от трёх и давности последнего получения более семи дней.
Это проверка при сохранении плейлиста, а не фоновое расписание. Если название и изображение уже есть, простое повторное сохранение обычно не обновляет их. Отдельной кнопки принудительного обновления в форме нет.