Настройка
Обновлено
Общая настройка плагина
В карточке «Видео из ВКонтакте» в разделе «Плагины» приложения «Магазин» объявлена одна настройка.
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Кэш, секунд | Подпись в интерфейсе обещает кэширование разобранных метаданных. Однако в текущем коде получение и вывод видео не читают эту настройку: изменение значения не управляет хранением метаданных в базе данных | По умолчанию 600. В подсказке указано «0 отключает кэш», но это поведение в коде не реализовано |
Не используйте значение 0 как способ обновить названия и превью. Фактическое хранение и повторное получение метаданных описаны в статье об интеграции.
Поля плейлиста
Откройте «Магазин → VK видео» и выберите существующий плейлист либо нажмите «+ Новый плейлист».
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Название | Название плейлиста в списке управления и заголовок стандартного блока на сайте | Текст, обязательное поле; у нового плейлиста пустое |
| Описание | Текст под заголовком стандартного блока | Необязательный текст; у нового плейлиста пустой |
| Ссылки на видео ВК | Исходные ссылки, из которых формируется плейлист | По одной ссылке на строку; поле должно быть непустым; у нового плейлиста пустое |
Название и описание плейлиста в стандартном шаблоне экранируются и выводятся как текст, а не как HTML-разметка. Название и описание каждого ролика плагин получает из VK; отдельных полей для их ручного редактирования нет.
Форматы ссылок
Распознаются ссылки с vk.com, www.vk.com, vkvideo.ru и поддоменами vkvideo.ru. Поддерживаются видео и клипы. Ниже приведены примеры формы ссылки, а не проверенные ролики:
https://vk.com/video-123456789_456239017
https://vk.com/clip-123456789_456239017
https://vkvideo.ru/video-123456789_456239017
https://vkvideo.ru/clip-123456789_456239017
https://vksport.vkvideo.ru/video-211023276_456239259Не вставляйте несколько ссылок в одну строку. Пустые строки пропускаются. Нераспознанные строки не превращаются в карточки видео: если все ссылки неверны, плейлист может сохраниться без видео.
Счётчик рядом с названием в списке управления считает строки исходного поля, поэтому не подтверждает число распознанных или доступных роликов. Не добавляйте один ролик несколько раз, в том числе ссылками с разных доменов: уникальность записей определяется идентификатором ролика внутри плейлиста.
Сохранение и удаление
Кнопка «Сохранить» записывает поля плейлиста и обрабатывает ссылки. Удалённые из поля ссылки исключаются из состава видео при следующем сохранении. Полностью пустое поле не принимается: появляется сообщение «Добавьте хотя бы одну ссылку на видео».
Для удаления откройте сохранённый плейлист, нажмите «Удалить» и подтвердите «Удалить плейлист?». Затем удалите его вызовы из темы и шорткоды из записей: вызов хелпера с отсутствующим ID не выводит блок, а шорткод отсутствующего плейлиста остаётся в тексте записи.
При сохранении обновляется служебное поле порядка видео, но метод чтения не задаёт сортировку по нему. Не рассчитывайте на гарантированное изменение порядка карточек после перестановки строк.