Документация KinoCraft

Что такое KinoCraft

KinoCraft — коммерческий комплект для WordPress: KinoCraft Theme отвечает за внешний вид, KinoCraft Core за каталог и административные модули. В зависимости от тарифа устанавливаются LoreCraft, CineQuiz и KinoCraft Social. Сайт может работать как информационный портал без онлайн-видео.

Демо: kinocraft.streltsov.digital. Доступность сторонних TMDB, AI API и видеосервисов зависит от их правил и сети вашего хостинга. Начните с темы и Core, затем подключайте необязательные модули.

Требования к хостингу

Используйте актуальную поддерживаемую версию WordPress с HTTPS, PHP и расширениями cURL, JSON, mbstring, GD/Imagick для изображений, а также MySQL/MariaDB. В комплекте тема заявляет совместимость с WordPress 6.2+ и PHP 7.4+, но для нового проекта рекомендуется более новая поддерживаемая версия PHP.

Для импорта постеров необходимы права записи в wp-content/uploads; для обращения к TMDB — исходящие HTTPS-запросы с сервера. Проверьте WP-Cron, лимит памяти PHP, объём диска и корректную работу почты WordPress. Сначала настройте резервное копирование.

Комплектация четырёх тарифов

Basic — 9 900 ₽, 1 домен: Theme + Core. Standard — 17 900 ₽, 3 домена: Basic + LoreCraft + CineQuiz. Business — 29 900 ₽, 10 доменов: Standard + KinoCraft Social + White Label. Unlimited — 49 900 ₽: полный комплект, безлимит активаций и приоритетная поддержка.

Бессрочное использование и обновления включённых компонентов предусмотрены на период развития продукта, техническая поддержка — 12 месяцев. Хостинг, ключи AI, права на изображения/видео и коммерческая лицензия TMDB не входят в покупку.

Как получить архивы после покупки

После подтверждённой оплаты откройте кабинет Streltsov Digital → «Мои продукты» / «Лицензии» / «Загрузки». Скачайте ZIP только тех компонентов, которые включены в ваш тариф. Ключ вида KC-… используется для всех разрешённых компонентов на одном сайте.

Не распаковывайте ZIP перед установкой через WordPress. Сохраните полученные файлы и ключ в приватном месте. Не публикуйте ключи, токены TMDB и Cloudflare в открытых тикетах и скриншотах.

Установка темы KinoCraft

1. Сделайте резервную копию сайта и базы данных.
2. WordPress → Внешний вид → Темы → Добавить новую → Загрузить тему.
3. Выберите архив kinocraft-theme-…zip, установите и активируйте.
4. Проверьте, что на сайте работают шапка, подвал и мобильное меню.
5. Если замещаете старую версию, согласитесь на замену в интерфейсе WordPress; ручные изменения файлов родительской темы будут потеряны.

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

Установка KinoCraft Core

WordPress → Плагины → Добавить новый → Загрузить плагин. Выберите kinocraft-core-…zip, установите и активируйте. В левом меню появится группа KinoCraft. Сначала откройте «Обзор», затем «Лицензия и обновления», «TMDB · подключение» и параметры темы.

Theme и Core должны соответствовать совместимому комплекту. При ошибке активации отключите проблемный ZIP, проверьте журнал PHP и версию WordPress/PHP; не удаляйте таблицы или контент в попытке исправить активацию.

Порядок установки дополнений

В тарифах Standard и выше установите LoreCraft, затем CineQuiz; Business/Unlimited дополнительно устанавливают KinoCraft Social. Каждый — отдельный плагин через «Плагины → Добавить новый → Загрузить плагин».

Перед настройкой дополнительного модуля убедитесь, что он активирован и совместим с KinoCraft Core. Если какой-то плагин отсутствует в лицензии, не устанавливайте его из посторонних источников. Личные сообщения в KinoCraft Social не предусмотрены.

Первый запуск за 15 шагов

1. Установите Theme и Core. 2. Активируйте лицензию. 3. Задайте название и HTTPS-адрес сайта. 4. Выберите логотип/цвета. 5. Настройте меню. 6. Проверьте индексацию. 7. Получите собственный TMDB ключ и права использования. 8. Подключите TMDB. 9. Запустите диагностику API. 10. Импортируйте один фильм. 11. Импортируйте один сериал. 12. Проверьте сезон и актёров. 13. Оформите каталоги и категории. 14. Настройте SEO. 15. Проверьте мобильный экран и резервное копирование.

Не начинайте массовый импорт, пока тестовые карточки и изображения не выглядят корректно.

Как устроено меню управления

Панель KinoCraft сгруппирована по задачам: «Начало работы», «Каталог и контент», «Редакция», «TMDB и импорт», «Киноклуб», «Внешний вид», «SEO и автоматизация», «Система и интеграции». Группы можно разворачивать; поиск на обзорном экране помогает найти инструменты.

Настройки темы управляют дизайном и публичными надписями, Core — источниками данных, импортом, пользователями и лицензиями. Это разные зоны WordPress; не ищите настройки TMDB в стандартном меню «Внешний вид».

Активация лицензионного ключа

Откройте KinoCraft → Лицензия и обновления, введите свой ключ KC-… и выполните активацию для текущего HTTPS-домена. Дождитесь именно подтверждённого ответа сервера Streltsov Digital, а не только сообщения «ключ сохранён».

Лицензия включает проверку доменного слота и доступных компонентов. При переносе сайта сначала деактивируйте старый домен; затем активируйте ключ на новом. Если сеть недоступна, не считайте сохранённый локально ключ доказательством активации.

Домены и перенос лицензии

Basic разрешает один активный домен, Standard — три, Business — десять, Unlimited — без лимита. Для staging-среды или переноса учитывайте правила активных доменов своего тарифа.

Переносите файлы и БД штатным инструментом миграции; обновите URL WordPress, HTTPS, ссылки медиатеки и постоянные ссылки. После переезда сверьте ключ в «Лицензия и обновления» и освободите прежний слот, если он больше не нужен.

Автоматические обновления WordPress

Сначала сохраните резервную копию. Откройте Консоль → Обновления либо KinoCraft → Лицензия и обновления и выполните проверку доступных версий. Закрытый сервер релизов отдаёт только ZIP, разрешённые тарифом и подтверждённой лицензией.

Обновляйте сначала Core (если это указано в релизе), затем тему и дополнительные плагины. После установки откройте каталог, импорт, личный кабинет и фронтенд. Не обновляйте на production одновременно пять компонентов без резервной копии.

Почему лицензия не активируется

Проверьте: точность ключа, активность доменного слота, HTTPS, исходящий доступ WordPress к Streltsov Digital, время сервера и отсутствие WAF-блокировки. Ответ «лицензия не проверена» отличается от «недействительна»: первый может означать сетевую ошибку.

При обращении в поддержку сообщите домен, версию Core, HTTP-код ответа и время проверки. Сам полный ключ, пароль или токен не отправляйте в открытом сообщении.

White Label и брендинг

White Label предусмотрен для Business и Unlimited. Через доступные настройки дизайна можно заменить публичный логотип и бренд-подписи владельца киноcайта. White Label не означает передачу авторских прав на программный код или право перепродавать ZIP.

Проверьте верхнее меню, подвал, кабинет и страницы дополнений после смены брендинга. Указание источника TMDB и необходимые правовые уведомления могут требоваться независимо от выбранного оформления.

Резервное копирование и откат

Перед обновлением экспортируйте базу данных и каталог wp-content, особенно uploads. Проверьте версию файлов в WordPress. При аварийном откате восстановите согласованную пару файлов и базы, если миграция изменила схему данных.

Не отключайте плагины путём удаления их таблиц и не копируйте ZIP из тестового проекта поверх production без проверки версий. Для исправлений лучше использовать staging-домен.

Что импортирует TMDB

KinoCraft использует TMDB для метаданных: названия, год, описание, постеры, кадры, жанры, актёры и команда, сезоны/эпизоды, франшизы, рейтинг, возрастные сертификаты (если доступны), бюджет и кассовые сборы фильма, производственные компании и телесети. Некоторые данные могут отсутствовать или быть неполными — система не должна придумывать их автоматически.

TMDB не поставляет видеопоток и не выдаёт права на просмотр фильма. Доступность по подписке нужно проверять отдельно от студии-производителя.

Где получить TMDB API Key

1. Откройте themoviedb.org с компьютера и зарегистрируйтесь.
2. Войдите в аккаунт → Settings → API; запросите API-учётные данные, заполните заявку и примите условия.
3. В настройках API будут API Key (v3) и/или API Read Access Token.
4. Скопируйте одно подходящее значение в приватное поле KinoCraft; не добавляйте ключ в публичные JS-файлы или ссылки.

Официальная инструкция: TMDB Getting Started.

Коммерческое использование TMDB

Ключ TMDB не равен коммерческой лицензии. В KinoCraft при подключении выбирается режим прав: «Не подтверждён», «Некоммерческое использование» или «Есть коммерческое разрешение TMDB». Для монетизируемого сайта заранее проверьте условия провайдера и получите необходимое разрешение, если ваш сценарий коммерческий.

При использовании API/изображений TMDB требует надлежащую атрибуцию и оговорку об отсутствии аффилиации. Указывайте TMDB в разделе «О сайте/Источники» с официальным обозначением. Официальный FAQ.

Настройка прямого подключения

В WordPress откройте KinoCraft → TMDB · подключение. Введите API Key (v3) или Read Access Token, подтвердите права использования, включите TMDB. В поле «Тип подключения» выберите «Прямое TMDB API — рекомендуется», задайте язык ru-RU и при необходимости импорт изображений.

Сохраните. Нажмите «Проверить все возможности». Успешные ответы API означают, что хостинг может обращаться к TMDB. После этого переходите к «TMDB · импорт». Не включайте Cloudflare, пока прямое подключение работает стабильно.

Диагностика TMDB

Центр подключения проверяет запросы отдельно: поиск, фильм, сериал, актёры, сезоны, франшизы и изображения. «Проверить всё» не создаёт новые записи. Если ошибка только у изображений — можно временно отключить загрузку постеров и продолжить с метаданными.

401 обычно связан с ключом/токеном; 403 — правами или правилами сети; 404 у /collection/{id} через Worker — отсутствующим разрешённым маршрутом; 429 — ограничением частоты; cURL 28 — тайм-аутом. Записывайте HTTP-код, конкретный тест и тип транспорта, но не публикуйте токены.

Проблемы IPv6 и хостинга

Если хостинг не соединяется с api.themoviedb.org или image.tmdb.org, включите в TMDB · подключение пункт «Только IPv4 при проблемах сети» и повторите диагностику. Эта настройка действует только для названных TMDB-хостов и не отключает проверку TLS-сертификатов.

Если не помогло, проверьте DNS, брандмауэр, разрешённые исходящие 443/TCP, cURL, CA-сертификаты и ограничения провайдера. Не отключайте sslverify ради успешного теста.

Когда нужен Cloudflare Worker

Cloudflare Worker — необязательный приватный транспорт, если WordPress-хостинг не может напрямую обратиться к TMDB. Он перенаправляет только разрешённые пути на официальные адреса TMDB по HTTPS. Это не обход лицензии, региональных прав или ограничений провайдера.

KinoCraft поддерживает три режима: Direct — только напрямую, Auto — напрямую с резервным Worker при сетевой ошибке, Worker — все запросы через ваш Worker. Пользователь разворачивает Worker в собственном Cloudflare-аккаунте; общего публичного прокси Streltsov Digital нет.

Создание Cloudflare Worker — пошагово

1. Создайте или откройте аккаунт Cloudflare → Workers & Pages.
2. Создайте Worker и откройте Edit code. Вставьте исходник KinoCraft TMDB Relay 0.9.8, приложенный к документации. Не используйте сторонние публичные прокси.
3. Deploy и сохраните собственный HTTPS-адрес вида https://your-worker.your-subdomain.workers.dev.
4. В Worker → Settings → Variables and Secrets добавьте секрет типа Secret с именем RELAY_SHARED_SECRET и случайным значением минимум 32 символа.
5. Сохраните/разверните изменения. Проверьте в браузере https://your-worker…/health — он должен вернуть JSON status: ok.

Скачать проверенный шаблон Worker — файл JavaScript, не ZIP для WordPress. В Cloudflare названия кнопок могут меняться.

Подключение Worker в KinoCraft

В KinoCraft → TMDB · подключение выберите «Прямое + мой Worker при сетевой ошибке» или «Только мой Cloudflare Worker». Введите HTTPS-адрес своего Worker без /api/3 на конце и тот же секрет из Cloudflare RELAY_SHARED_SECRET (не менее 32 символов).

Сохраните, затем «Проверить все возможности». KinoCraft передаёт секрет в заголовке X-KinoCraft-Relay-Key, а TMDB-учётные данные — серверным запросом. На страницах посетителей ключи не публикуются. Если Worker работает, но весь импорт даёт 401 — сравните секреты с обеих сторон.

Какие маршруты должен поддерживать Worker

Для базового импорта нужны пути /api/3/search/movie, /api/3/search/tv, /api/3/movie/{id}, /api/3/tv/{id}, /api/3/tv/{id}/season/{n}, изображения /image/t/p/{size}/{file}.

Для поздних модулей нужны /api/3/collection/{id}, /api/3/person/{id}, /api/3/person/{id}/images, /api/3/person/{id}/combined_credits, /api/3/search/company, /api/3/discover/movie, /api/3/discover/tv, /api/3/network/{id} и справочники. При 404 у отдельных функций обычно нужно обновить белый список путей Worker, а не переустанавливать KinoCraft.

Защита Cloudflare Relay

Рабочий Worker должен принимать только GET, требовать общий секрет в заголовке, разрешать только фиксированные хосты api.themoviedb.org и image.tmdb.org, отклонять произвольные пути/URL и перенаправления, проверять размер и Content-Type ответов. Секрет храните в Cloudflare Secrets, а не в исходном JS.

Открытый /health показывает только состояние, без ключей. 401 при прямом открытии защищённого API-маршрута без заголовка — ожидаемое поведение. Не убирайте авторизацию «для теста». Изображения могут потреблять трафик; учитывайте лимиты Cloudflare.

Worker: 404, 401, 502 и картинки

404: версия Worker не знает маршрут или вы добавили неверный префикс. 401: секрет или TMDB-авторизация отсутствуют. 502: Worker не получил корректный ответ TMDB, upstream редирект или Content-Type отклонён. 503: секрет Cloudflare не настроен. Изображение не скачалось: проверьте пути /image/t/p/…, MIME, доступность хостинга к Worker, ограничения размера и разрешение записи в медиатеку.

Проверяйте в таком порядке: /health → Worker secret → один фильм → один сериал → сезоны → франшиза → персона → изображения → студии. Не передавайте креденциалы службе поддержки.

Импорт одного фильма и сериала

Откройте KinoCraft → TMDB · импорт. Введите название или TMDB ID, проверьте результаты поиска и выберите точное произведение. Начните с одной карточки фильма, проверьте русское название, год, постер, кредиты, возрастной рейтинг и статус публикации. Затем импортируйте сериал и проверьте сезоны и эпизоды.

Новые записи могут появляться как черновики; для показа на публичном сайте опубликуйте их. Массовое создание без редакторской проверки увеличивает риск дублей и некорректных описаний.

Возрастные рейтинги, бюджет и сборы

Для фильмов KinoCraft читает возрастные сертификаты TMDB release_dates, для сериалов — content_ratings. Страну классификации можно выбрать в настройках импорта, для России — RU. Если российского сертификата нет, система не должна автоматически выдавать американский R за российские «18+».

Бюджет и мировые кассовые сборы относятся к фильмам и выражены в USD; нулевое/неизвестное значение скрывается. Данные можно скорректировать вручную. Для ранее импортированных записей используйте пакетное обновление возраста и финансов без перезаписи статей и SEO.

Постеры и фотографии в медиатеке

При включённой загрузке изображений файлы сохраняются в медиатеку WordPress. Проверьте права wp-content/uploads, расширение GD/Imagick и лимиты PHP. Если внешний CDN TMDB недоступен в браузере посетителя, предпочтительнее сохранять допустимые по правам файлы на сервере, а не ссылаться на image.tmdb.org напрямую.

Не загружайте картинки без необходимых прав. При ошибке 403/404/тайм-ауте попробуйте один файл, затем Worker либо импорт только текста.

Франшизы и серии фильмов

Раздел франшиз использует сведения TMDB о коллекциях. Можно импортировать состав франшизы, выявлять недостающие части и публиковать тематические страницы. Не все серии произведений представлены в TMDB как официальная коллекция; добавляйте и проверяйте связи вручную.

Если Worker возвращает 404 на /api/3/collection/{id}, обновите белый список маршрутов. Перед массовым импортом выполните диагностику одной франшизы.

Студии, телесети и платформы

KinoCraft → Студии и платформы: выберите готовые варианты (в том числе российские), выполните сопоставление с уже импортированным каталогом, при необходимости импортируйте новые произведения в черновики. Производственная компания и первоначальная телесеть не означают наличие произведения в подписке.

Если карточка студии пуста, проверьте её подтверждённый TMDB ID и наличие опубликованных фильмов/сериалов. Для некоторых платформ TMDB не даёт полноценных связей. Логотипы можно сохранить локально в медиатеку или назначить вручную.

Подбор по настроению (Mood Engine)

KinoCraft → Mood Engine позволяет посетителю искать фильмы и сериалы по настроению: расслабиться, расследование, приключение, напряжение и другие. Автоматическая классификация строится на доступных жанрах, ключевых словах и правилах, поэтому не всегда совпадает с редакторским мнением.

Проверьте заполнение после нескольких импортов, настройте доступные настроения, добавьте описания категорий и вручную исправьте ошибочные назначения. Пустые подборки лучше не выводить публично.

Фильмы: карточки и характеристики

KinoCraft → Фильмы: редактируйте название, оригинальное название, год, синопсис, постер/backdrop, длительность, жанры, возраст и рейтинги. Публичная карточка может содержать актёров, галерею, отзывы, партнёрские ссылки и опциональный плеер.

Проверяйте корректность SEO H1 и дату публикации WordPress: блок «Новое на сайте» сортирует по добавлению, а не по году производства.

Сериалы, сезоны и эпизоды

KinoCraft → Сериалы / Сезоны / Эпизоды. Сначала создайте сериал, затем проверьте импорт сезонов и конкретных серий. Сезон и эпизод должны быть связаны с правильным родительским сериалом. Лимиты вывода и статус «Вышла / Скоро» зависят от настроек и дат выхода.

При пропавших эпизодах проверьте TMDB ID, номер сезона, HTTP-ответ API и пагинацию, а не переимпортируйте всё содержимое без диагностики.

Персоны и фильмография

Импортируются актёры, режиссёры и другие персоны со связями с произведениями. Для фотографий требуется отдельный разрешённый маршрут TMDB и права на изображения. Сортировка главных ролей и лимиты карточек настраиваются отдельно.

Если фильмография не заполнена через Worker, проверьте /person/{id}/combined_credits; если нет биографии — /person/{id}. Редактор может корректировать биографию вручную.

Жанры и SEO посадочных

Каждый жанр может иметь своё название, URL, H1, вступление, дополнительный SEO-текст и обложку. Сопоставление с TMDB необходимо проверять после импорта, особенно для переведённых или объединённых жанров.

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

Редакционные и пользовательские подборки

Редакционные подборки связывают фильмы одной темой; можно менять порядок, выбирать обложку и featured-произведение, писать отдельный вводный текст. Пользовательские подборки создают зарегистрированные участники, а редактор модерирует их до публикации.

SEO архивов редакционных и пользовательских коллекций различается. Добавляйте уникальные названия и описания; избегайте сотен пустых страниц.

Каталоги настроений

Выберите нужные настроения, подготовьте обложки и проверьте, что в каждом достаточно опубликованных произведений. Карточки Mood Engine используют собственные категории и не должны автоматически дублировать жанры.

Если пользователю показывается «нет подходящих фильмов», сначала расширьте опубликованный каталог и проверьте метаданные; отключать фильтры ради искусственного наполнения не рекомендуется.

Страницы студий и локальные логотипы

Для отдельной студии можно установить обложку hero-блока и локальный логотип из медиатеки. В каталоге используются только подтверждённые связи TMDB с опубликованными произведениями, а не все фильмы провайдера в мире.

Если логотип виден на ПК, но сломан на iPhone, откройте «Студии и платформы» → сохранение логотипов на сервере либо назначьте собственный локальный файл. В тёмной теме логотипы должны иметь контрастную подложку.

«Редакция»: статьи и рубрики

Для новых публикаций используйте WordPress → Записи → Добавить запись. «Редакция» — архив стандартных статей WordPress. В настройках темы найдите «Редакция · SEO и рубрики»: здесь управляются H1, SEO Title/Description самого архива, вступление и русские тематические рубрики.

Для статей выбирайте рубрики «Новости кино», «Рецензии», «Подборки фильмов», «Премьеры» и др. Не оставляйте Uncategorized; у рубрик может быть собственная SEO-страница.

Вставка фильмов в статьи

В редакторе Gutenberg добавьте блок «KinoCraft — фильм или сериал», найдите опубликованное произведение и выберите вариант карточки. Доступны номер в топе, постер, рейтинг, год, страна, возраст, жанры и ссылка. Кнопка «Добавить следующий» создаёт отдельный блок; «Заменить» меняет только текущий.

В классическом редакторе используется вставка [kinocraft_title id="123" number="1"]. Данные карточки подтягиваются динамически из каталога: изменение рейтинга в базе обновит его в статьях. Удалённые из публикации фильмы не должны отображаться.

Латинские URL статей

Для новых записей «Редакции» предусмотрена автоматическая транслитерация заголовка в латинский slug. Пример: «Топ-10 лучших фильмов 2026 года» → top-10-luchshih-filmov-2026-goda.

Уже опубликованные страницы не переименовываются автоматически: массовая смена адресов требует 301-редиректов и проверки внутренних ссылок. WordPress → Настройки → Постоянные ссылки — выберите понятную структуру и сохраните.

Настройки Theme Studio

Откройте KinoCraft → Настройки темы. Здесь находятся цвета, пресеты, типографика, плотность карточек, текстовые подписи, настройки главной, шапки, подвала и страниц. Сохраняйте изменения небольшими порциями и проверяйте фронтенд.

В коммерческой теме покупатель может заменить собственные логотипы, обложки и публичные тексты без изменения PHP-файлов. Изменения файлов родительской темы могут потеряться после обновления.

Главная: блоки и порядок

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

«Новое на сайте» показывает последние опубликованные произведения. Если фильм не виден, проверьте статус, дату публикации, лимит и кэш. Избыточное количество блоков может замедлить мобильную версию — оставьте действительно полезные.

Обложки каталогов и жанров

Для общих архивов фильмов и сериалов выберите фон в настройках оформления/текстов темы. Для отдельных студий, жанров, настроений, актёров и режиссёров откройте редактирование соответствующего термина → «Обложка шапки каталога».

Обложки должны оставлять хороший контраст для H1. Если файл не выбран, выводится тематический фон по умолчанию. Используйте собственные изображения или контент с разрешением.

Яркость backdrop фильма и сериала

В разделе «Фильмы и карточки» есть настройки фона: «Сбалансированный», «Светлее» и «Мягкое размытие». Они влияют на фоновый кадр в шапке карточек фильмов/сериалов, но не должны размывать текст, постер и кнопки.

При смене режима очистите CSS-кэш. На мобильных фон может специально затемняться сильнее ради читабельности.

Навигация и мобильное меню

Создайте и назначьте основное и нижнее меню WordPress. Проверьте доступность поиска, кабинета, «Редакции», каталога и энциклопедии на узком экране. Тяжёлые кнопки шапки могут быть спрятаны внутрь мобильного меню.

Если сайт уходит за правую границу экрана, временно отключайте пользовательские CSS/виджеты и проверяйте страницы LoreCraft, студий и кабинета отдельно.

Личный кабинет «Мой киномир»

Кабинет содержит группы «Моё кино», «Мои публикации», «Сообщество», «Аккаунт». На обзоре группы свёрнуты; при выборе страницы открывается только нужная группа. Здесь находятся избранное, списки «Хочу посмотреть» и «Просмотрено», рецензии, подписки и настройки профиля.

Проверьте права незарегистрированного пользователя: кабинет и личные данные не должны индексироваться или открываться по прямому URL без авторизации.

Регистрация и пользовательские профили

Включите нужные настройки регистрации WordPress и KinoCraft. Проверьте страницу входа, восстановление пароля, редактирование профиля, аватар и выход. Участники могут вести коллекции и отзывы в рамках выбранных публичных модулей.

Защищайте административные роли; не выдавайте подписчикам права редактирования чужих материалов. Для регистрации настройте антиспам и рабочую отправку писем WordPress.

Отзывы и рецензии

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

Оценка TMDB, оценка редакции и голоса зрителей не должны смешиваться без подписи источника. Не создавайте искусственные отзывы и оценки ради наполнения каталога.

Подписки и лента

Посетители могут подписываться на авторов, отслеживать новые публикации и пользоваться лентой активности. В настройках приватности укажите публичные данные профиля и контролируйте видимость комментариев.

Если лента пуста, убедитесь, что подписки есть и новые записи опубликованы. Лента не заменяет обязательную модерацию пользовательских материалов.

Уведомления и колокольчик

Колокольчик показывает события: ответы, реакции, подписки и, при установленном KinoCraft Social, публикации групп/упоминания. Уведомления настраиваются по категориям внутри кабинета.

Если новые события не появляются, проверьте состояние подписок, права доступа к группе, кэш и JavaScript. Уведомления закрытых групп не должны раскрывать их контент бывшим участникам.

Ранги, достижения и Зал славы

Активность в отзывах, рецензиях, подборках и сообществе может открывать ранги, значки рядом с именем, достижения, секретные награды и попадание в Зал славы. Еженедельные задания мотивируют публиковать качественный контент.

Проверяйте пороги и защиту от накрутки. Ранги и награды принадлежат бренду сайта покупателя, а не обязаны называться «легенда KinoCraft».

Модерация и безопасность сообщества

Проверьте очереди пользовательских подборок, жалобы, комментарии и роли модераторов. Убедитесь, что редактирование или удаление чужих публикаций требует прав, а запросы защищены nonce/авторизацией.

Не открывайте свободную HTML-разметку для всех участников и не храните чувствительные данные в публичных профилях. Пользовательские изображения должны проходить ограничения формата и размера.

Установка LoreCraft (Standard+)

LoreCraft — самостоятельный плагин киноэнциклопедии, доступный с тарифа Standard. Установите ZIP, активируйте и откройте его разделы. Создайте тестовую запись о персонаже или вселенной и привяжите её к произведению каталога.

Проверьте публичную Wiki, права авторов/модераторов, русские названия и латинские URL. Не импортируйте чужие фанатские тексты без разрешения.

Вселенная, персонаж, локация, событие

Wiki объединяет связанные энциклопедические материалы: вселенные и истории, персонажей, локации, события и связи с фильмами/сериалами. У каждого материала должен быть понятный заголовок, краткое описание, обложка и внутренние ссылки.

Лучше начать с одной франшизы, оформить главную страницу Wiki и только затем масштабировать. Пустые разделы и незаполненные страницы закрывайте от индексации или оставляйте черновиками.

LoreCraft Design Studio, Quick Start, White Label

Покупатель может использовать штатные настройки оформления Wiki, цвета, логотип и структуру страниц. Quick Start помогает создать первые разделы. Возможность скрытия упоминаний разработчика зависит от тарифа/White Label — она не отменяет обязательную атрибуцию источников данных.

После настройки проверьте светлый/тёмный режим, меню Wiki, мобильные обложки и ссылки на каталог кино.

Участие пользователей в Wiki

Если модуль позволяет пользовательские правки или предложения статей, установите отдельные роли и предварительную модерацию. Раздел «Мой вклад» должен показывать автору собственные материалы и статусы.

Для чужих персонажей и вселенных проверяйте права на иллюстрации, точность фактов и возможные спойлеры. Не выдавайте фанатский текст за официальный первоисточник.

Установка CineQuiz (Standard+)

CineQuiz — отдельный плагин киноигр, входящий в Standard и выше. Установите его после KinoCraft Core. Проверьте, что в настройках доступны типы вопросов и связь с фильмами/сериалами из каталога.

Создайте тестовую викторину из нескольких вопросов и запустите её на опубликованной карточке фильма. Игровой блок может быть отключён или отсутствовать, пока нет опубликованных и привязанных вопросов.

Типы игр и вопросы

Можно создавать вопросы на узнавание по кадру, персонажу, описанию или цитате; вопросы привязываются к конкретному произведению. Добавляйте несколько ответов, правильный вариант и пояснение. Настраивайте сложность, баллы, лимиты повторных попыток и актуальность вопроса.

Используйте кадры и цитаты только при наличии прав/соответствующего разрешения, а ответы проверяйте вручную.

Турниры, рейтинги и ежедневные задания

Игроки получают очки и могут участвовать в рейтингах, турнирах и ежедневных заданиях. Для общественных таблиц лидеров предусмотрите защиту от повторного прохождения/накрутки и ясные правила начисления баллов.

Если рейтинг не обновляется, проверьте опубликованность игры, настройки зачёта результатов, авторизацию и кэш.

CineQuiz Design Studio и White Label

Настройки оформления CineQuiz позволяют выбрать фирменные цвета, логотип, подписи и дизайн игровых карточек. Для коммерческого сайта проверьте, что бренд покупателя отображается во всех публичных блоках, в том числе в светлой теме.

Права White Label регулируются комплектацией лицензии. Не меняйте код ядра плагина ради визуальных доработок — обновления его перезапишут.

Установка Social, группы и фан-клубы

Плагин KinoCraft Social входит в Business и Unlimited. Установите ZIP, активируйте и откройте настройки сообществ. Пользователи могут создавать или посещать группы и фан-клубы, вести публичные обсуждения, оставлять реакции и комментарии.

Создайте тестовую группу, настройте права её участников, страницу группы и модерацию. Наличие групп не означает, что каждый пользователь может публиковать без ограничений.

Стены, посты, реакции и комментарии

Участник может публиковать текстовые сообщения на своей стене или в разрешённой группе, комментировать записи и оставлять реакции. Управляйте публичностью и жалобами; проверяйте отображение постов на телефоне и в обоих режимах оформления.

Личные сообщения между пользователями в KinoCraft Social намеренно отсутствуют. Плагин развивает публичные сообщества и обсуждения кино.

Social: подписки, упоминания и уведомления

Публикации групп, комментарии, упоминания через @ и реакции интегрируются с центром уведомлений Core. Учитывайте права доступа: уведомление от закрытой группы не должно открывать скрытый контент после исключения участника.

Для проверки используйте два тестовых аккаунта: создайте группу, подпишитесь, опубликуйте пост и проверьте колокольчик/счётчик.

Роли, группы и модерация

Настройте создание групп, назначение администраторов и модераторов, правила публикаций и блокировку нарушителей. Регулярно проверяйте жалобы и спам.

Плагины и программы автоматической рассылки сообщений не входят в KinoCraft Social. Внешние ссылки или медиа разрешайте только там, где соответствующие настройки действительно предусмотрены и соблюдены права на контент.

SEO главной, каталогов и карточек

Для публичных страниц подготовьте уникальные H1, SEO Title и Meta Description. Редактирование SEO архивов фильмов, сериалов и «Редакции» доступно в настройках Theme Studio, отдельных жанров и подборок — в соответствующих материалах. Используйте Yoast SEO или Rank Math по своему выбору.

Проверьте canonical, sitemap и meta robots в фактическом HTML. Не создавайте два несовместимых набора SEO-тегов от разных плагинов.

Google Search Console и Яндекс Вебмастер

Откройте KinoCraft → Поисковые системы, добавьте метакод google-site-verification и/или yandex-verification, сохраните. Проверьте HTML главной (<head>) и затем нажмите «Подтвердить» в соответствующей панели.

Убедитесь, что WordPress → Настройки → Чтение разрешает индексацию, а сайт отдаёт HTTP 200 и правильный canonical. После подтверждения отправьте sitemap, созданный SEO-плагином. Само подтверждение прав не гарантирует индексацию или позиции.

AI SEO Studio: провайдеры и ключи

AI SEO Studio помогает готовить Title, Description, ключевые фразы и редакционные черновики на основе каталога и внешнего AI-провайдера. Возможные варианты включают GigaChat и YandexGPT; доступность моделей и стоимость API определяет поставщик. Храните ключи в приватных настройках, а не в тексте статей.

Генерация не заменяет проверку фактов: нейросеть может ошибиться в фильмографии, датах и названиях. Проверяйте текст перед публикацией, особенно биографии персон.

AI SEO: проверка качества и сохранение

KinoCraft предупреждает о неподтверждённых названиях фильмов и датах по локальному каталогу, но отсутствие записи TMDB не доказывает, что факт ложен. Поэтому такие предупреждения не должны блокировать ручное сохранение выбранных SEO-полей.

Проверяйте уникальность, смысл, переспам и источники. Для больших объёмов генерируйте пакетами, не перезаписывая вручную отредактированные тексты без отдельного подтверждения.

Онлайн-плеер: опциональный модуль

KinoCraft → Онлайн-плеер по умолчанию выключен. Владелец может включить его для собственных или лицензированных видео: HTTPS MP4/WebM/OGG, нативный HLS, разрешённый iframe или внешний API, сопоставляющий TMDB ID и сезон/эпизод.

В карточке произведения выбирают ручной, API или выключенный режим. Некоторые сервисы запрещают iframe, используют DRM или ограничивают регион. KinoCraft не обходит такие меры и не предоставляет библиотеку фильмов. Для каждого источника нужны соответствующие права.

Подключение внешнего API видеоплеера

В настройках Player Center можно указать HTTPS endpoint с шаблонами {tmdb_id}, {type}, {season}, {episode} и выбрать метод авторизации. Сервер запрашивает JSON с типом источника и URL; тайм-аут и кэш ограничивают нагрузку.

Примером может быть ваш лицензированный видеосервер, а не произвольный сайт с пиратским контентом. Для теста сначала проверьте один MP4, затем работу API на одном фильме и одном эпизоде.

Правообладатели, персональные данные и cookies

Владелец сайта несёт ответственность за права на используемые изображения, описания, трейлеры, цитаты и видеоконтент. Добавьте страницы политики конфиденциальности, cookies и контакты для правообладателей. Проверьте условия внешних API и аналитических сервисов.

Если используете вход, отзывы и пользовательские публикации, отдельно настройте условия обработки персональных данных и модерацию. Указание TMDB как источника не заменяет коммерческую лицензию на контент.

Ошибки 404 и постоянные ссылки

Если после установки не открываются фильмы, франшизы, студии или Wiki: WordPress → Настройки → Постоянные ссылки → Сохранить изменения; затем очистите кэш и повторите запрос. Проверьте, что нужная запись опубликована и соответствующий модуль активен.

Если URL должен быть латинским, не меняйте опубликованные адреса массово без 301-редиректов. При наличии CDN очистите правило кэша именно для затронутых страниц.

Почему не видно нового фильма или сериала

Чаще всего импорт создал черновик, а главная показывает только опубликованные записи. Проверьте статус, дату публикации, ограничения числа карточек, выбор featured-элементов и кэш.

Если фильм не вошёл в подборку по настроению или студии — проверьте правила классификации, подтверждённые TMDB ID и связь с термином. Пустая студия не должна заполняться ложными совпадениями.

Проблемы оформления после обновления

Очистите кэш оптимизатора CSS, WordPress, CDN и браузера. Сверьте версии Theme и Core, отключите пользовательские CSS-фрагменты для диагностики. Проверьте светлую/тёмную темы отдельно и размеры экрана 320–430 px.

Если логотипы студий не открываются на мобильном, переведите их в медиатеку. Если элементы съезжают — проверьте подключение всех стилей из темы и отсутствие старых минифицированных файлов в кэше.

Ошибки TMDB и Cloudflare по кодам

401: неверный ключ или секрет Worker. 403: ограничение доступа/прав. 404: неразрешённый маршрут Worker либо неправильный TMDB ID. 429: слишком много запросов. 500/502: серверная ошибка провайдера/прокси. cURL 28: ожидание ответа истекло. cURL 60: проверьте CA-сертификаты хостинга, не отключайте TLS-проверку.

Начните с теста отдельного API-запроса из «TMDB · подключение», затем конкретного режима транспорта и журнала ошибок.

Производительность и объём каталога

На сайтах с тысячами фильмов избегайте массового импорта без ограничения пакета. Настройте кэш, оптимизацию изображений, WP-Cron, резервные копии и достаточный PHP memory_limit. Периодически проверяйте размеры uploads и БД.

При длительной синхронизации не запускайте параллельно несколько импортов одних и тех же записей. Сначала тестируйте на staging и фиксируйте показатели времени ответа.

Безопасность ключей и прав

Никогда не размещайте API Key TMDB, ключи AI, токены активации и RELAY_SHARED_SECRET в публичном HTML, Git-репозитории или скриншотах. Используйте HTTPS, двухфакторную защиту аккаунтов администраторов, регулярные обновления и минимальные права ролей.

Не используйте «публичные бесплатные прокси» для TMDB — на них могут оказаться ваши учётные данные. Для Worker разрешайте лишь фиксированные маршруты на TMDB.

Отключение и удаление компонентов

Отключение Theme или одного из плагинов не должно требовать удаления базы данных. Перед удалением сделайте резервную копию и уточните, какие типы контента используются выбранным модулем (Wiki, quiz, группы и т. д.).

При переносе лицензии сначала деактивируйте прежний домен. Не удаляйте WordPress записи, термины или таблицы вручную без плана восстановления.

Поддержка Streltsov Digital

Разработчик: Streltsov Digital. Поддержка: Telegram @seovzlet. Укажите название продукта, WordPress/PHP, версии Theme/Core/дополнений, страницу проблемы, точные шаги воспроизведения и текст ошибки без секретных данных.

Техническая поддержка распространяется на штатные функции включённых в тариф компонентов. Хостинг, персональная разработка, коммерческие лицензии TMDB, покупка видеоконтента и платные AI-сервисы оплачиваются отдельно.

Контрольный список перед запуском сайта

• Тема и Core активны; лицензия подтверждена.
• Показаны корректные пункты меню, логотип и контактные данные.
• TMDB или собственные материалы импортированы законно; правовой режим проверен.
• Фильмы, сериалы, сезоны, эпизоды, персоны, студии отображаются без 404.
• Архив «Редакция», рубрики, латинские URL, H1 и SEO-поля заполнены.
• Search Console и Яндекс Вебмастер подтверждены, sitemap доступен.
• Профили и модерация проверены с тестовым пользователем.
• Optional-плеер выключен либо использует законный источник.
• Бэкап, HTTPS, кэш и мобильные версии проверены.