Частые вопросы

Нужен ли токен VK?

Нет. Настройки токена в плагине нет: метаданные извлекаются из страницы встроенного плеера VK. Сервер магазина должен иметь доступ к vk.com.

Почему плейлист не сохраняется?

Заполните «Название» и «Ссылки на видео ВК». При пустых значениях сервер возвращает «Укажите название плейлиста» или «Добавьте хотя бы одну ссылку на видео». Если появляется «Ошибка сохранения», разработчику нужно проверить ответ запроса сохранения и журнал wa-log/shop/plugins.log.

Почему сохранение длится долго?

Метаданные получаются во время сохранения. Для роликов, требующих запроса к VK, предусмотрено до трёх HTTP-попыток с паузами; таймаут одного запроса — 30 секунд. Дождитесь ответа формы. На витрине метаданные читаются из базы и повторно не запрашиваются.

Почему счётчик показывает видео, а карточек нет?

Счётчик в списке управления считает строки поля «Ссылки на видео ВК». Нераспознанные строки и пустые строки не становятся карточками. Проверьте формат ссылок и размещайте по одному URL на строку. Непустое поле с неверными ссылками может сохраниться без видео.

Почему нет превью или вместо названия показано «Видео VK …»?

Плагину не удалось извлечь соответствующие данные из ответа VK либо найденные значения не прошли проверку. Без названия хелпер подставляет Видео VK с идентификатором ролика. Повторно сохраните плейлист: отсутствие названия или изображения вызывает новую попытку получения для уже сохранённого видео. Проверьте журнал запросов и доступность ролика для встраивания.

Почему изменение названия видео в VK не отражается на сайте?

На сайте показываются сохранённые данные. Полные метаданные не обновляются при каждом просмотре и не имеют срока действия, задаваемого настройкой «Кэш, секунд». Повторное сохранение тоже не гарантирует обновление полного набора данных: действуют условия повторного получения. Отдельной кнопки принудительного обновления нет.

Почему нажатие на карточку не запускает плеер?

Стандартный обработчик реагирует на нажатие на превью, а не на название карточки. Если изображения нет, области запуска тоже нет. При наличии превью проверьте JavaScript, непустой URL плеера, доступность встраивания ролика и разрешение iframe с vk.com в CSP сайта.

Почему на странице виден текст шорткода?

Шорткод обрабатывается только в тексте записей приложения «Блог». Используйте точную запись [ewshopvkvideos playlist=1] с существующим ID. Удалённый или несуществующий плейлист не заменяет шорткод. Для темы магазина нужен вызов хелпера.

Почему вызов render() ничего не показывает?

Проверьте ID в блоке «Код для вставки в шаблон:». Метод возвращает пустую строку, если ID не задан, плейлист не найден или список его видео пуст. Используйте ID сохранённого плейлиста, а не массив ссылок: вывод массива URL в текущей версии содержит ошибку реализации.

Как изменить оформление и порядок видео?

Оформление меняется переопределением шаблона ewshopvkvideos_plugin.frontend_videos.html в теме магазина или блога. Настройки оформления в форме плейлиста нет. Порядок строк сохраняется в служебном поле, но чтение видео не сортирует по нему: гарантировать перестановку карточек через форму в этой версии нельзя.