Описание

---

Функции плагина

1. Метабокс в админ-панели

• Добавляет поле “Featured Video” на экран редактирования поста.

• Поля:

  • featured_video_url — URL файла видео.

  • Кнопка выбора видео через стандартную медиабиблиотеку WordPress.

  • Превью блок для проверки выбранного файла.

• Поддержка любых пост-тайпов при активации (через фильтр).

2. Загрузка видео через медиабиблиотеку

• Интеграция с wp.media.

• Открытие модального окна медиабиблиотеки.

• Фильтрация по типу файлов video/*.

• Автоматическое заполнение поля URL.

• Отображение <video> превью.

3. Сохранение данных

• Данные записываются в post_meta при сохранении записи.

• Валидация URL.

• Очистка меты при удалении значения.

4. Фронтенд-вывод

• Подмена стандартной миниатюры:

  • В архивных списках.

  • На странице одиночного поста.

• Логика:

  • Если видео есть → вывод <video muted autoplay loop playsinline>

  • Если нет → используется обычная миниатюра.

• Поддержка lazy-loading.

5. Короткий код для ручного вывода

[featured_video id="POST_ID"]
Опции:

• id — ID записи (по умолчанию текущей).

• Автоматический вывод <video> или пустой строки.

6. Глобальный JS и CSS

Frontend:

• Минимальный скрипт инициализации для корректного воспроизведения autoplay и muted.

• CSS для адаптивной вставки видео (object-fit: cover).

Admin:

• Логика открытия медиабиблиотеки.

• Обновление превью видео в реальном времени.

• Предотвращение выбора файлов неподдерживаемого типа.

7. Поддержка Gutenberg и Classic Editor

• Метабокс доступен в sidebar панели.

• Полная совместимость с редактором блоков.

8. Валидация и безопасность

• Nonce-проверка при сохранении.

• Sanitize URL.

• Ограничение типа данных video/*.

9. Логи

• Все ошибки JS/обработки сохранения выводятся в файл:
  /wp-content/uploads/logs/nstone-featured-video.log

11. Расширяемость

• Фильтр nstone_featured_video_post_types — список CPT, в которых активен функционал.

• Фильтр nstone_featured_video_html — позволяет изменить HTML-вывода <video>.