FV Видео портал на WordPress

Пошаговая инструкция по установке, настройке и обновлению видеопортала на WordPress «FV Видео портал».

1. Требования

• WordPress 6.5 и новее (проверено на 7.1).
• PHP 8.1 и новее (проверено на 8.5).
• HTTPS — обязателен для входа через VK ID и Яндекс ID и для оплаты через ЮKassa.
• Обработка видео на сервере: для автоматического сжатия роликов на хостинге должны быть установлены программа ffmpeg и разрешена PHP-функция shell_exec. Проверить это можно в разделе FV Tools → FV Видео портал → Журнал → Окружение (строка «ffmpeg»). Если её нет, попросите поддержку хостинга включить ffmpeg.
• Лицензионный ключ с портала fvtools.ru.

2. Что входит в архив

• fv-videoportal-1.0.2.zip — основная тема. Внутри неё лежит плагин-ядро «FV Видео портал — ядро»: тема устанавливает и обновляет его сама, отдельно ставить не нужно.
• fv-videoportal-child-1.0.0.zip — дочерняя тема для ваших правок (по желанию).

3. Установка

1. Консоль → Внешний вид → Темы → Добавить → Загрузить тему.
2. Выберите fv-videoportal-1.0.2.zip, нажмите «Установить», затем «Активировать». Плагин-ядро развернётся и включится автоматически.
3. Если вы планируете менять код или стили темы, установите таким же способом fv-videoportal-child-1.0.0.zip и активируйте дочернюю тему. Основная тема должна оставаться установленной.

4. Активация лицензии

1. Откройте FV Tools → FV Видео портал, вкладка «Лицензия».
2. Вставьте лицензионный ключ и нажмите «Активировать». Ключ привязывается к домену сайта.

Пока лицензия не активирована, в админке доступна только вкладка «Лицензия», а меню «Видео» скрыто. Сайт для зрителей при этом продолжает работать.

5. Мастер настройки

Сразу после активации лицензии открывается мастер настройки.

• «Создать страницы и меню» — создаёт страницы «Челленджи», «Теги», «Избранное», «Обновления», «Тур» и «Премиум» и добавляет меню в шапку сайта. Уже существующие страницы не дублируются.
• «Отмена» — ничего не создаёт; в шапке остаётся только кнопка входа.

Запустить мастер повторно можно в любой момент: FV Tools → FV Видео портал → Общие → «Страницы и меню» → «Мастер настройки».

6. Меню администратора

• FV Tools → FV Видео портал — все настройки портала по вкладкам: «Лицензия», «Общие», «Компрессия», «Хранилище», «Эл. почта», «Вход через соцсети», «Премиум», «Оплата · ЮKassa», «Журнал».
• Видео — список роликов, «Загрузка видео», «Теги», «Челленджи», «Статистика», «Заявки на премиум», «Платежи».

У полей настроек есть значок «?» — при нажатии на него открывается подробная подсказка.

7. Загрузка роликов

1. Сначала создайте теги и челленджи: Видео → Теги и Видео → Челленджи. Для каждого можно задать картинку-плитку.
2. Откройте Видео → Загрузка видео.
3. Перетащите в поле от 1 до 50 файлов или нажмите «Выберите файлы». Название ролика берётся из имени файла. Поддерживаемые форматы и максимальный размер файла на вашем хостинге указаны прямо на странице.
4. Выберите доступ: «Публичное» (видят все) или «Премиум» (только подписчики).
5. Отметьте теги и челленджи — они применятся ко всем загружаемым роликам в порядке нажатия.
6. По желанию укажите дату публикации: ролик появится на сайте не раньше этой даты.
7. Нажмите «Начать загрузку». Файлы загружаются по одному, поэтому это безопасно и для медленного хостинга. Сжатие идёт в фоне — страницу можно закрыть.

В списке Видео видны доступ, статус обработки и число просмотров. Ролики можно фильтровать по тегу, челленджу и доступу, массово менять доступ («Публичное» / «Премиум») и запускать повторную обработку кнопкой «Переобработать».

8. Вкладка «Общие»

• «Только SD» — все зрители получают лёгкую версию ролика без кнопки HD. Подходит для недорогого хостинга без CDN.
• «Защита от скачивания» — включена по умолчанию: нет контекстного меню и кнопки скачивания, прямые ссылки на файлы закрыты. Галочка на этой вкладке отключает защиту.
• «Ссылки на ролики» — разрешает прямые ссылки на отдельные ролики. Без этой опции не работают кнопка «Поделиться», превью в соцсетях, разметка для поисковых систем и видеокарта сайта. Для продвижения в поиске включите её.
• «Потоковая подача (HLS)» — ролик отдаётся короткими фрагментами, а качество автоматически подстраивается под скорость интернета. Фрагменты выдаются только по подписанной ссылке, поэтому сохранить ролик одним файлом нельзя.
• «Водяной знак» — полупрозрачный логин зрителя и адрес сайта поверх премиум-роликов.
• «Комментарии» — комментарии под роликами. Каждый комментарий ждёт вашего одобрения в разделе «Комментарии».
• «Бесплатных страниц до премиум-гейта» — сколько страниц галереи доступно без подписки. Дальше зритель видит предложение оформить премиум. Закрытые страницы автоматически скрываются от поисковых систем.
• «Защита входа» — после 3 неудачных попыток входа IP-адрес блокируется на 24 часа. Здесь же можно сбросить счётчики.
• «Удаление» — удалять ли настройки и данные лицензии при удалении плагина. Ролики, страницы и пользователи не удаляются никогда.

9. Вкладки «Компрессия» и «Хранилище»

• «Компрессия» — ползунки качества для трёх версий ролика: SD для телефонов, SD для компьютеров и HD, а также качество и ширина превью. Ползунок влево — меньше файл, вправо — выше качество. Кнопка «Перекодировать все видео» применяет новые настройки к уже загруженным роликам по одному в фоне.
• «Хранилище» — размер каждого ролика в исходнике, SD и HD и общий объём на диске.

10. Вход через VK ID и Яндекс ID

Вкладка «Вход через соцсети». После настройки в окне входа появляются кнопки «Войти через VK ID» и «Войти через Яндекс ID». Новый зритель получает аккаунт автоматически.

VK ID

1. Откройте кабинет VK ID для бизнеса (ссылка есть на вкладке) и войдите в свой аккаунт VK.
2. Нажмите «Добавить приложение», тип — «Web», название — имя вашего сайта.
3. В поле «Базовый домен» укажите домен сайта, а в «Доверенный Redirect URL» вставьте адрес из поля «Redirect URL» на вкладке (копируйте точно).
4. В настройках доступа разрешите почту (Email).
5. Скопируйте ID приложения в поле «ID приложения», отметьте «Показывать кнопку VK ID» и сохраните. Защищённый и сервисный ключи не нужны.

Яндекс ID

1. Откройте «Создать приложение» в Яндекс OAuth (ссылка есть на вкладке).
2. Название — имя сайта; назначение — «Для авторизации пользователей», платформа — «Веб-сервисы».
3. В «Redirect URI» вставьте адрес из поля «Redirect URI» на вкладке, в «Suggest Hostname» — домен сайта.
4. Доступы: адрес электронной почты, имя и фамилия, портрет пользователя.
5. Скопируйте ClientID и Client secret в поля на вкладке, отметьте «Показывать кнопку Яндекс ID» и сохраните.

Если соцсеть не передала почту

Некоторые аккаунты VK не передают адрес почты. Тогда зрителю показывается окно «Укажите e-mail»: он вводит адрес и подтверждает его по ссылке из письма. Пока адрес не подтверждён, письма на служебный адрес не отправляются. Окно можно отложить — оно появится снова через неделю.

11. Регистрация и согласие с политикой конфиденциальности

В разделе Внешний вид → Настроить → «Вход / Регистрация» выберите страницу политики конфиденциальности. После этого в форме регистрации и у кнопок входа через соцсети появится обязательное согласие.

12. Премиум-подписка

Блок премиума выводится шорткодом [fv_videoportal_premium]. Мастер настройки размещает его на странице «Премиум», но его можно перенести на любую страницу или в запись. Пока у зрителя активна подписка, вместо формы оформления он видит статус подписки и переключатель автопродления.

Вкладка «Премиум»

• «Срок действия премиума» — в часах или днях; 0 — без ограничения. Для проверки удобно поставить 1 час.
• Заголовок и подзаголовок блока — если оставить поля пустыми, используется стандартный текст на языке сайта.
• «Оффлайн-подключение» — зритель оставляет заявку, вы получаете письмо, договариваетесь об оплате и включаете премиум в разделе Видео → Заявки на премиум (или в профиле пользователя).
• Адрес для уведомлений, письмо зрителю о подключении премиума и напоминание об окончании срока.

Вкладка «Оплата · ЮKassa» (бета)

1. Отметьте «Показывать способ „ЮKassa“ в блоке премиума».
2. Выберите режим: «Тестовый (без настоящей оплаты)», «Боевой» или «Боевой + тестовый для администратора». Пройдите весь путь оплаты в тестовом режиме, прежде чем принимать реальные платежи.
3. Введите shopId и секретный ключ из личного кабинета ЮKassa (Интеграция → Ключи API). Ключ хранится в базе и больше не показывается.
4. Укажите цену премиума и описание платежа (можно использовать {site}, {user}, {period}).
5. При необходимости включите передачу данных для чека (54-ФЗ) и выберите ставку НДС.
6. Скопируйте Webhook URL в личный кабинет ЮKassa → Интеграция → HTTP-уведомления и отметьте события payment.succeeded и payment.canceled.
7. По желанию включите автопродление премиума и уведомления о каждой оплате.
8. Укажите обязательные согласия (оферта, политика конфиденциальности) — зритель отмечает их перед оплатой.

Все платежи видны в разделе Видео → Платежи.

13. Внешний вид (Кастомайзер)

Раздел Внешний вид → Настроить. Все изменения видны в предпросмотре сразу.

• «Свойства сайта» — логотип и ползунок «Размер логотипа». Рекомендуемые пропорции логотипа — 4:1 (например, 800×200 пикселей); слишком тяжёлые файлы не принимаются.
• «FV Видео портал — Дизайн» — цвета и шрифт.
• «FV Видео портал — Главная» и «Кнопки главной (Блок 2)» — содержимое главной страницы.
• «FV Видео портал — Пагинация» — для каждого раздела («Обновления», «Тур», «Популярное», «Избранное», ролики тега и челленджа, «Теги», «Челленджи») свой вид навигации: номера страниц, «Показать ещё» или бесконечная прокрутка, а также число роликов на странице.
• «Вход / Регистрация» — страница политики конфиденциальности (см. раздел 11).

14. Статистика

Видео → Статистика: просмотры, лайки, комментарии, регистрации, оплаты и выручка за выбранный период, графики по дням, подборки «Популярное за неделю» и «Больше всего просмотров за всё время». Просмотры администраторов и редакторов не учитываются, а повторный просмотр того же ролика тем же зрителем в течение 30 минут засчитывается один раз.

15. Поисковые системы

• Видеокарта сайта доступна по адресу https://ваш-сайт/fv-video-sitemap.xml и обновляется автоматически. Она работает, если на вкладке «Общие» разрешены «Ссылки на ролики».
• С Yoast SEO видеокарта сама добавляется в общую карту sitemap_index.xml, а превью для соцсетей и разметка роликов передаются через Yoast. Без SEO-плагина видеокарта работает самостоятельно.
• robots.txt: если на сайте нет физического файла robots.txt, портал сам добавляет в него нужные строки. Если файл создан вручную, допишите в блок User-agent: *:Disallow: /fv-stream/Sitemap: https://ваш-сайт/fv-video-sitemap.xml
• Добавьте адрес видеокарты в Яндекс Вебмастер и Google Search Console.

16. Плагины кеширования

Портал совместим с WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache и кешем хостинга. Личные данные зрителей (плеер, блок премиума, итоги оплаты, страницы для вошедших) автоматически исключаются из общего кеша, поэтому зрители никогда не видят чужие данные. Дополнительно настраивать ничего не нужно.

17. Обновление

1. Консоль → Внешний вид → Темы → Добавить → Загрузить тему.
2. Выберите архив новой версии и нажмите «Установить», затем «Заменить текущую версию загруженной».
3. Появится уведомление «обновлено до версии …». Плагин-ядро обновится автоматически.

Ролики, страницы, зрители, подписки, настройки и лицензия при обновлении сохраняются. Дочерняя тема при обновлении основной не меняется, поэтому ваши правки в ней остаются на месте.

18. Журнал и диагностика

Вкладка «Журнал»: отметьте «Включить журналирование», чтобы видеть события портала. Блок «Окружение» показывает версии WordPress и PHP, наличие ffmpeg и другие параметры сервера. Кнопка «Копировать отчёт» собирает всё в один текст для обращения в поддержку.

19. Решение проблем

Ролик загрузился, но не сжимается

Проверьте строку «ffmpeg» в блоке «Окружение» на вкладке «Журнал». Если там «нет», попросите хостинг включить ffmpeg и функцию shell_exec, затем нажмите «Переобработать» у ролика.

Кнопка «Поделиться» не появляется, видеокарта пустая

Включите «Ссылки на ролики» на вкладке «Общие».

Вход через VK ID или Яндекс ID выдаёт ошибку адреса возврата

Адрес в настройках приложения VK ID или Яндекс OAuth должен в точности совпадать с полем «Redirect URL» / «Redirect URI» на вкладке «Вход через соцсети», включая https:// и отсутствие лишнего слеша в конце.

Оплата прошла, а премиум не включился

Проверьте, что Webhook URL добавлен в ЮKassa и отмечены события payment.succeeded и payment.canceled. Статус платежа виден в разделе Видео → Платежи.

Не могу войти после нескольких попыток

IP-адрес заблокирован на 24 часа после 3 неудачных попыток. Сбросьте счётчики на вкладке «Общие» → «Защита входа».

Удаление

Ролики, страницы и пользователи при удалении темы и плагина не удаляются. Настройки и данные лицензии удаляются, только если на вкладке «Общие» отмечена соответствующая опция.

Дополнение к документации: как настроить системный cron, чтобы ролики обрабатывались, а подписки продлевались вовремя, и какой сервер выбрать под нужное число зрителей онлайн.

1. Зачем порталу cron

Часть работы видеопортал выполняет в фоне по расписанию WordPress (WP-Cron):

• Обработка загруженных роликов (сжатие в SD, SD для компьютеров и HD, обложки, превью) — каждую минуту. За один запуск обрабатывается столько роликов, сколько успеет за 2,5 минуты, по одному, без перегрузки сервера.
• Отложенная публикация — ролики с будущей датой появляются на сайте при очередном запуске.
• Подготовка потоковой подачи (HLS) для уже загруженных роликов — каждые 5 минут.
• Окончание срока премиума — каждые 5 минут.
• Автопродление подписок через ЮKassa и письма-напоминания — каждый час.
• Пересчёт подборки «Популярное за неделю» и статистики — раз в сутки ночью.

Стандартный WP-Cron срабатывает только тогда, когда кто-то открывает сайт. На сайте без посетителей (например, ночью или сразу после запуска) ролики будут ждать в очереди, а продление подписки может запоздать. Пока открыта вкладка админки, обработка идёт и без cron, но полагаться на это нельзя. Поэтому для рабочего сайта обязательно настройте системный cron.

Признак того, что cron не настроен: над списком роликов появляется предупреждение «очередь видео никто не запускает: нет системного cron и нет посетителей сайта».

2. Как настроить системный cron

Шаг 1. Добавьте задание в планировщик

В панели хостинга найдите раздел «Планировщик задач» или «Cron» (он есть в ISPmanager, cPanel, Plesk, FastPanel, а также в панелях Beget, Timeweb и REG.RU). Создайте задание с периодичностью раз в минуту (* * * * *). Выберите один из вариантов команды.

1. Через PHP (рекомендуем) — без ограничений по времени со стороны веб-сервера, поэтому длинные ролики обрабатываются надёжнее:cd /путь/к/сайту && /usr/bin/php wp-cron.php >/dev/null 2>&1Путь к сайту — папка, в которой лежит wp-config.php. Путь к PHP на разных хостингах разный (например, /usr/bin/php, /usr/local/bin/php или /opt/php83/bin/php): уточните его в панели или у поддержки. Версия PHP в cron должна быть той же, что и у сайта (8.1 или новее).
2. Через WP-CLI, если он установлен на сервере:wp cron event run --due-now --path=/путь/к/сайту --quiet
3. Через адрес сайта — если запуск PHP в планировщике недоступен:wget -q -O - "https://ваш-сайт.ру/wp-cron.php?doing_wp_cron" >/dev/null 2>&1илиcurl -s "https://ваш-сайт.ру/wp-cron.php?doing_wp_cron" >/dev/null 2>&1

Если хостинг не позволяет запускать задания чаще чем раз в 5 минут, поставьте */5 * * * * — портал будет работать, просто ролики начнут обрабатываться чуть позже.

Шаг 2. Отключите запуск WP-Cron при посещениях

Чтобы задания не запускались дважды и не замедляли открытие страниц, добавьте в файл wp-config.php перед строкой /* That's all, stop editing! */ (или «Это всё, дальше не редактируем»):

define( 'DISABLE_WP_CRON', true );

Делайте это только после того, как системный cron из шага 1 заработал, иначе фоновые задачи остановятся совсем.

Шаг 3. Проверьте

1. Загрузите тестовый ролик в разделе Видео → Загрузка видео и закройте вкладку админки.
2. Через 2–5 минут откройте список Видео: в колонке «Обработка» ролик должен быть готов, а предупреждение об очереди — исчезнуть.
3. Если ролик так и стоит в очереди, проверьте путь к PHP и к сайту в команде, а также строку «ffmpeg» на вкладке «Журнал» → «Окружение».

Посмотреть все запланированные задачи можно бесплатным плагином WP Crontrol: задачи портала начинаются с fv_videoportal_.

3. Что сильнее всего нагружает сервер

• Канал (скорость интернета сервера) — главное ограничение видеопортала. Каждый зритель, который сейчас смотрит ролик, постоянно скачивает видео.
• Процессор — сжатие загруженных роликов и обработка запросов зрителей. Каждая порция видео проходит проверку прав доступа, поэтому без ускоренной отдачи (раздел 6) процессор и PHP нагружаются сильнее.
• Диск — у каждого ролика хранится несколько копий разного качества.
• Оперативная память — число одновременно работающих процессов PHP и база данных.

Сколько трафика потребляет один зритель (ориентировочно)

• Телефон, SD: около 1–1,5 Мбит/с.
• Компьютер, SD до 1080p: около 2,5–4 Мбит/с.
• HD (в качестве исходника): 5–10 Мбит/с и больше — зависит от загруженного файла.

Для расчёта берите в среднем 2 Мбит/с на каждого зрителя, который смотрит одновременно. Час просмотра — примерно 0,5–1 ГБ трафика. Если тариф ограничивает трафик, умножьте это на число часов просмотра в месяц.

Сколько места занимают ролики (ориентировочно)

Минута видео со всеми копиями (SD для телефонов, SD для компьютеров, HD) при стандартных настройках сжатия занимает около 60–80 МБ. При включённой потоковой подаче (HLS) нарезанные копии хранятся дополнительно, и объём примерно удваивается — до 120–160 МБ на минуту. Например, 1000 роликов по 30 секунд — это около 60–80 ГБ с HLS. Точный объём своих роликов смотрите на вкладке «Хранилище».

4. Какой сервер выбрать

«Онлайн» в таблице — это зрители, которые смотрят ролики одновременно, а не посетители за сутки. Обычно одновременно на сайте находится 1–3% от суточной аудитории.

Одновременно смотрят	Сервер	Процессор / память	Диск	Канал
до 20	VPS (старт)	2 ядра / 4 ГБ	NVMe от 50 ГБ	от 100 Мбит/с
20–100	VPS	4 ядра / 8 ГБ	NVMe от 150 ГБ	от 300 Мбит/с, лучше 1 Гбит/с
100–300	Мощный VPS или выделенный сервер	8 ядер / 16 ГБ	NVMe от 300 ГБ	1 Гбит/с
300–1000	Выделенный сервер	16 потоков и больше / 32–64 ГБ	NVMe от 1 ТБ	1 Гбит/с с режимом «Только SD» или 10 Гбит/с
больше 1000	Несколько серверов или выделенный сервер с каналом 10 Гбит/с; архитектура подбирается индивидуально вместе с администратором сервера.

Это ориентиры для коротких вертикальных роликов при стандартных настройках. Если зрители смотрят в основном с телефонов, нагрузка на канал ниже; если с компьютеров и в HD — выше.

Рекомендации по выбору

• Виртуальный хостинг подходит только для старта и небольшой аудитории, и только если на нём есть ffmpeg и разрешена функция shell_exec (уточните у поддержки до покупки). Сжатие видео сильно нагружает процессор, и на виртуальном хостинге его могут ограничить. Для рабочего портала выбирайте VPS.
• Выбирайте серверы с дисками NVMe или SSD и безлимитным трафиком. Обращайте внимание на гарантированную скорость канала, а не только на максимальную.
• Сервер должен находиться ближе к зрителям: для аудитории из России — в российском дата-центре.
• Рекомендуемое ПО: Linux (Ubuntu или Debian), nginx + PHP-FPM, PHP 8.3 и новее, MySQL 8 или MariaDB 10.6 и новее, ffmpeg.
• Тариф удобно увеличивать по мере роста: большинство VPS позволяют добавить ядра, память и диск без переноса сайта.

5. Настройки PHP

• upload_max_filesize и post_max_size — не меньше размера самого большого загружаемого ролика (портал принимает файлы до 512 МБ).
• memory_limit — 256 МБ.
• max_execution_time — 300 секунд для загрузки больших файлов.
• Функция shell_exec должна быть разрешена — через неё запускается ffmpeg.
• PHP-FPM: число процессов (pm.max_children) подбирается по памяти — примерно 1 процесс на каждые 60–80 МБ свободной памяти. Без ускоренной отдачи (раздел 6) каждый зритель на время скачивания порции видео занимает один процесс.

6. Ускоренная отдача видео (для администратора сервера)

По умолчанию каждую порцию видео отдаёт PHP: он проверяет права зрителя и передаёт файл. Начиная примерно с 50 зрителей онлайн, рекомендуется включить ускоренную отдачу: PHP только проверяет права, а сам файл передаёт веб-сервер. Это заметно снижает нагрузку на процессор и освобождает процессы PHP.

nginx (X-Accel-Redirect)

1. В wp-config.php добавьте путь к папке wp-content сайта:define( 'FV_VIDEOPORTAL_XACCEL_ROOT', '/var/www/site/wp-content' );
2. В конфигурацию сайта в nginx (блок server) добавьте внутренний адрес, недоступный снаружи:location ^~ /uploads/video/ { internal; alias /var/www/site/wp-content/uploads/video/; }
3. Перезагрузите nginx и проверьте, что ролики открываются и перематываются — публичные и премиум.

Apache (X-Sendfile)

1. Установите модуль mod_xsendfile и разрешите папку с видео: XSendFile On и XSendFilePath /var/www/site/wp-content/uploads/video.
2. В wp-config.php добавьте: define( 'FV_VIDEOPORTAL_XSENDFILE', true );
3. Проверьте воспроизведение и перемотку роликов.

Пути /var/www/site в примерах замените на путь к своему сайту.

7. Защита папки с видео на nginx

На Apache портал сам закрывает прямое скачивание роликов файлом .htaccess. Если файлы отдаёт nginx (чистый nginx или связка nginx + Apache, где nginx раздаёт статические файлы), .htaccess не действует. Имена файлов роликов и так содержат случайный секретный ключ, но для полной защиты добавьте в конфигурацию nginx запрет прямого доступа (короткие беззвучные превью плиток остаются открытыми):

location ~* ^/wp-content/uploads/video/(?!.*-preview.mp4$).*.(mp4|m4v|mov|webm|mkv|avi|m4s|m3u8)$ { deny all; }

Обложки (.webp, .jpg) должны оставаться доступными — они показываются в галерее.

8. Как снизить нагрузку без смены сервера

• Включите «Только SD» на вкладке «Общие» — зрители на компьютерах будут расходовать в несколько раз меньше трафика (на телефонах SD используется и так).
• Сдвиньте ползунки на вкладке «Компрессия» влево — файлы станут легче.
• Включите потоковую подачу (HLS) — зритель загружает только то, что действительно смотрит, а не весь ролик.
• Подключите плагин кеширования страниц (WP Rocket, LiteSpeed Cache, W3 Total Cache или WP Super Cache) и объектный кеш Redis (плагин Redis Object Cache) — страницы будут открываться быстрее и нагружать базу данных меньше.
• Загружайте большие пачки роликов в часы с наименьшим числом зрителей: сжатие видео занимает процессор.