Настройки (Settings)

Содержание

1. Введение

Раздел Настройки (Settings) предназначен для конфигурирования всех системных аспектов KVS, за исключением отображения контента на сайте. Настройка сайта и управление им осуществляется в разделе UI сайта (Website UI), по которому существует отдельное руководство.

Важно! Изменение настроек может привести к частичной потере функциональности проекта (как со стороны админки, так и со стороны сайта).

2. Персональные настройки (Personal Settings)

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

• Выключить защиту по IP (Disable IP protection) - выключает защиту сессии по IP администратора. Вам стоит включить этот параметр только в том случае, если ваш IP постоянно меняется с течением времени работы с панелью администрирования. Если такое происходит регулярно, то вас будет постоянно выкидывать на страницу логина, т.к. с измененным IP ваша сессия становится устаревшей.
• Отображение скриншотов (Screenshots display) - позволяет настроить, в каком виде должны отображаться скриншоты на странице редактирования видео. По умолчанию они не отображаются, но вы можете включить их и выбрать формат скриншотов, отображение которого будет для вас наиболее удобным.
• Скриншотов в строке (Screenshots in a row) - указывает какое количество скриншотов в одной строке будет отображаться в панели администрирования при работе со скриншотами.
• Столбцы списка видео (Videos list columns) - позволяет настроить вид списка видео в панели администрирования. Если вы включите отображения тумбы, вам также будет необходимо выбрать формат скриншотов и указать размер, до которого будет ужиматься тумба при отображении.
• Изображений в строке (Images in a row) - указывает какое количество фотографий альбома в одной строке будет отображаться в панели администрирования при работе с фотоальбомами.
• Столбцы списка альбомов (Albums list columns) - позволяет настроить вид списка фотоальбомов в панели администрирования. Если вы включите отображения тумбы, вам также будет необходимо выбрать формат альбомов и указать размер, до которого будет ужиматься тумба при отображении.

3. Системные настройки (System Settings)

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

3.1. Настройки изображений (Images settings)

В данном разделе настроек указываются размеры изображений, которых должен придерживаться движок KVS (кроме размеров скриншотов видео). Все размеры указываются в формате NxM, где N - ширина изображения, M - соответственно, высота.

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

Детальное описание опций:

• Размер аватара пользователя (User avatar size) - строгий размер аватара пользователя. При загрузке на сайте или в панели администрирования происходит уменьшение размеров загружаемого файла до нужных размеров.
• Размер аватара категории (Category avatar size) - строгий размер аватара категории. При загрузке в панели администрирования происходит уменьшение размеров загружаемого файла до нужных размеров. Этот же размер используется и для аватаров групп категорий.
• Размер скриншота 1 модели (Model screenshot 1 size) и Размер скриншота 2 модели (Model screenshot 2 size) - строгие размеры для скриншотов моделей. При загрузке в панели администрирования происходит уменьшение размеров загружаемых файлов до нужных размеров.
• Размер обложки DVD 1 (DVD cover 1 size) и Размер обложки DVD 2 (DVD cover 2 size) - строгие размеры для обложек DVD. При загрузке в панели администрирования происходит уменьшение размеров загружаемых файлов до нужных размеров.

3.2. Настройки видео конвертации (Video convertation settings)

Детальное описание опций:

• Сохранять исходники (Save source files) - включает сохранение исходников видео. Исходники могут использоваться в будущем при добавлении новых форматов видео и при ручном граббинге скриншотов. Наличие исходников не является обязательным условием для операции создания новых форматов видео, поскольку при их отсутствии в качестве исходников будут выступать файлы уже существующих форматов видео. Однако в этом случае качество новых форматов будет сильно зависеть от качества уже существующих форматов, а не от качества исходников. Аналогичная проблема с качеством может возникнуть и в случае ручного граббинга скриншотов. Кроме этого, для некоторых типов видео, таких как Хотлинк файла и Embed код ручной граббинг скриншотов будет вовсе невозможен при отсутствие исходника и невозможности скачать его по указанной ссылке.
• Приоритет фонового процесса (Background process priority) - позволяет выбрать одну из нескольких возможных значений приоритета фонового процесса конвертации видео (в реальном времени, высокий, средний, низкий, очень низкий). Выбранное значение будет распространяться на все ресурсоемкие операции, которые задействуются при обработке видео на всех серверах конвертации и главном сервере.
• Минимум свободного места для хранения видео (Minimum free disc space for storing videos) - указывает лимит свободного места на серверах хранения, после наступления которого на сервере какой-либо группы серверов вы не сможете больше добавлять видео на эту группу.

3.3. Настройки видео скриншотов (Video screenshots settings)

Детальное описание опций:

• Количество (Count) - начальное количество обзорных скриншотов, которое будет создаваться автоматически при первичной обработке всех видео. Вы можете задать как фиксированное количество (в этом случае у каждого видео будет создаваться одинаковое количество обзорных скриншотов), так и указать интервал в секундах, через который будут сниматься скриншоты (тогда количество обзорных скриншотов для конкретного видео будет зависеть от его длительности).
• Кроп скриншотов (Screenshots cropping) - задает настройки кропа при создании скриншотов с видео. Задается для каждой строны изображения либо в пикселях, либо в % от размера изображения. Кроп выполняется перед уменьшением скриншотов до нужных размеров.
• Смещение первого скриншота (First screenshot offset) - смещение в секундах относительно начала видео перед снятием первого скриншота. Имеет смысл, если в начале видеофайлов отображаются какие-либо титры и другая статика.

Важно! Операция кропа используется только для скриншотов, которые создаются движком автоматически. При загрузке скриншотов вручную вы должны выполнить кроп самостоятельно.

3.4. Настройки защиты видеофайлов (Video files protection settings)

Настройки защиты видеофайлов предназначены для защиты видеофайлов от хотлинкования и несанкционированного доступа совместно с серверной технологией защиты (для Nginx это X-Accel-Redirect).

Для настройки полноценной защиты папка, в которой находятся видеофайлы должна быть объявлена внутренней в конфиге Nginx (директива internal). Если вы используете несколько серверов для хранения видеофайлов, то аналогичным образом на всех серверах, где хранится видео, папки хранения должны быть внутренними. Кроме этого, дата и время на всех серверах должно быть синхронизировано с главным сервером. Внутренняя папка Nginx запрещает прямой доступ к файлам, хранящимся в этой папке, соответственно файлы могут быть доступны только через скрипт раздачи get_file.php, в который встроены все проверки. Объявление внутренней папки в конфиге Nginx делается таким образом:

location ^~ /contents/videos/ {
    flv; # включение FLV стриминга
    root /usr/home/clients/ftp0/domains/kernel-tube.com/html; # указание полного пути к папке /contents/videos/
    internal; # запрет доступа к папке по прямым ссылкам
}

KVS предоставляет следующие опции для защиты видеофайлов:

• Включить анти-хотлинк скрипта отдачи видео (Enable anti-hotlink for video download script) - включает защиту скрипта раздачи get_file.php от хотлинкования. Это приведет к тому, что ссылки на скрипт get_file.php, которые используются на сайте, станут временными и не смогут быть использованы на других сайтах для хотлинкования. В случае срабатывания защиты вместо видеофайла будет возвращаться файл по URL-у, который указывается ниже.
• Настройка ограничений по IP (IP limitation options) - работает при включенной защите скрипта get_file.php от хотлинкования. Позволяет указать, какое количество видео можно смотреть с одного IP адреса в течение указанного промежутка времени. В случае срабатывания ограничения вместо видеофайла будет возвращаться файл по URL-у, который указывается ниже.
• Отображать файл по указанному URL при ограничении (Render file from this URL when limiting access) - файл по этому URL-у будет возвращаться вместо видеофайла при срабатывании защиты в скрипте get_file.php. Если это поле оставлено пустым, то скрипт раздачи вернет ошибку (403 Forbidden).

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

3.5. Настройки ротатора (Rotator settings)

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

Важно! Использование ротатора повышает нагрузку на ваш сервер (HDD и CPU).

Детальное описание опций:

• Включить ротатор видео (Enable videos rotator) - включает на сайте ротацию видео.
• Включить ротатор скриншотов (Enable screenshots rotator) - включает на сайте ротацию скриншотов видео. Для дополнительных настроек ротатора скриншотов используются опции ниже.
• Мин. показов видео (Min video shows) - первое из двух значений критерия завершенности ротации. Видео должно набрать указанное кол-во показов, чтобы ротатор мог завершить ротацию скриншотов по нему.
• Мин. кликов по видео (Min video clicks) - второе из двух значений критерия завершенности ротации. Видео должно набрать указанное кол-во кликов, чтобы ротатор мог завершить ротацию скриншотов по нему.
• Удаление скриншотов (Delete screenshots) - данная опция позволяет настроить удаление части худших скриншотов после завершения ротации скриншотов у видео. Если вы хотите удалять часть скриншотов, то вам необходимо указать число скриншотов, которое должно остаться после завершения ротации скриншотов.
• Степень завершенности (Completeness) - показывает распределение видео по степеням завершенности ротации скриншотов. Используются 5 степеней интервалов (0%-20%, 21%-40%, 41%-60%, 61%-80%, 81%-100%) и одна финальная степень (100%), которая при клике ведет на список видео, у которых ротация скриншотов завершена. Данная гистограмма позволяет оценить насколько адекватно выбран критерий завершенности ротации скриншотов. При изменении любого из двух значений критерия завершенности график может измениться.

Важно! Процесс включения ротатора постепенный и зависит от настройки кэширования сайта. Полностью ротатор включится только тогда, когда обновится весь кэш. Для ускорения процесса можно вручную сбросить кэш сайта (кэш Smarty и MemCache) - это делается в разделе UI сайта (Website UI). Не стоит забывать, что сброс кэша приведет к скачку нагрузки на вашем ресурсе.

3.6. Настройки изображений альбомов (Album images settings)

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

• Кроп изображений (Images cropping) - задает настройки кропа при создании форматов альбомов с исходных изображений. Задается для каждой строны изображения либо в пикселях, либо в % от размера изображения. Кроп выполняется перед уменьшением изображений до нужных размеров.
• Доступ к исходным изображениям (Access to source images for users) - позволяет указать какие типы пользователей имеют физический доступ к исходникам изображений альбомов через скрипт раздачи. По умолчанию пользователи сайта не имеют доступа к исходникам.

3.7. Настройки UI сайта (Website UI settings)

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

Детальное описание опций:

• Динамические HTTP параметры (Dynamic HTTP parameters) - таблица позволяет указать 3 динамических HTTP параметра и их значения по умолчанию. Эти параметры будут подхватываться движком сайта и заменяться на всех страницах сайта, в ссылках на контент провайдеры и страницы оплаты биллингов даже при использовании кэширования. Динамические HTTP параметры предназначены для тех случаев, когда вам необходимо принять сторонний HTTP параметр (который не поддерживается движком) и отобразить его значение на сайте или подставить в ссылки на контент провайдеров / биллинги. В качестве примера можно рассмотреть необходимость принимать траффик от вебмастеров и подставлять их идентификатор в ссылки на рекламу / биллинги. Данная задача не может быть реализована при включенном кэшировании без использования динамических HTTP параметров. Для того, чтобы вывести значение параметра с именем, например, param1, вам необходимо использовать токен %param1% в нужном месте шаблона страницы или ссылки. Тогда для пользователя, который заходит по ссылке, приведенной ниже, токен %param1% заменится на значение 123456. http://your_domain.com/page/?param1=123456 Важно! Использование динамических параметров немного снижает производительность сайта, поэтому не стоит указывать параметры, которые не используются.
• Паттерн для страницы видео на сайте (Video page URL pattern) - указывает паттерн, который используется для ссылок на страницы просмотра видео. Этот паттерн используется в панели администрирования и на сайте для создания ссылок на страницы просмотра видео. Паттерн должен содержать токен %DIR%, который будет заменен на значение директории видео, либо токен %ID%, который будет заменен на значение айди видео, либо оба этих токена. Важно! При изменении этого паттерна вам необходимо добавить новое правило в корневой htaccess файл, поскольку: (а) ссылки нового вида начнут работать только при появлении нового правила и (б) старое правило должно остаться, т.к. могут содержаться внешние ссылки старого вида.
• Паттерн для страницы альбома на сайте (Album page URL pattern) - указывает паттерн, который используется для ссылок на страницы просмотра фотоальбомов. Используется так же, как и аналогичный паттерн для видео.
• Синхронизировать статус пользователей (Sync member status) - включает синхронизацию статуса пользователя с базой данных и указывает интервал этой синхронизации. При использовании премиум зоны у пользователя может закончиться доступ во время его пребывания на сайте. Поскольку данная ситуация происходит редко, то нет смысла опрашивать базу данных при каждом запросе, чтобы узнать закончился ли доступ у пользователя или нет. Эта опция позволяет настроить интервал (в секундах), по которому будет происходить выборка статуса пользователя из базы данных. Если вы не используете премиум зону (пользователей с премиум статусом нет) - этот параметр стоит выключить.
• Синхронизировать online статус пользователей (Sync user online status) - включает синхронизацию состояния пользователя "на сайте" с базой данных и указывает интервал этой синхронизации. После входа в личную зону в браузере пользователя по расписанию раз в 60 секунд срабатывает небольшой скрипт, который посылает пинг на сервер. На сервере этот пинг может записать в базу данных информацию о том, что пользователь в данный момент времени находится на сайте. Если вам необходимо использовать эту информацию где-то на страницах сайта, либо вы хотите получить статистику кто сколько времени активно проводит на вашем сайте - вам необходимо включить этот параметр. Интервал указывает через какой промежуток времени информация "на сайте" будет сохраняться в базу данных (должен быть кратным 60 секундам, т.к. пинг срабатывает раз в 60 секунд независимо от этой опции).
• Синхронизировать новые сообщения пользователей (Sync member unread messages) - включает синхронизацию сообщений внутренней почты пользователя с базой данных и указывает интервал этой синхронизации. По мере навигации пользователей по сайту нет смысла каждый раз определять, появились ли у них новые сообщения внутренней почты. Вы можете включить эту опцию и указать интервал, через который для каждого пользователя будут проверяться новые сообщения его внутренней почты (например, чтобы показать в шапке сайта, что у него появились новые сообщения).

Важно! Опции Синхронизировать XXX работают для зарегистрированных и залогиненых пользователей сайта, т.е. на гостей они не распространяются.

3.8. Настройки по умолчанию для добавления видео (Videos adding defaults)

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

Детальное описание опций:

• Исходный рейтинг видео (Videos initial rating) - рейтинг видео при создании.
• Пользователь по умолчанию для добавления видео (Default user for adding videos) - устанавливает от какого пользователя по умолчанию будут добавляться видео в панели администрирования. Во время добавления видео вы сможете выбрать любого другого пользователя для данного видео. Если вам нужно загрузить видео от нескольких пользователей, воспользуйтесь импортом, т.к. импорт видео позволяет указать список пользователей.
• Статус по умолчанию для добавления видео (Default status for adding videos) - устанавливает статус видео по умолчанию. Во время добавления видео вы сможете выбрать другой статус при необходимости для добавляемого видео.
• Группа серверов по умолчанию (Default server group) - позволяет настроить, как будет выбираться группа серверов для хранения видео: автоматически с наибольшим свободным пространством, случайным образом или конкретная группа серверов.
• Время появления на сайте (Post time part) - настраивает механизм подстановки временной части даты появления видео на сайте. Во время добавления видео вы сможете указать любое конкретное время появления для данного видео.

3.9. Настройки по умолчанию для добавления альбомов (Albums adding defaults)

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

Детальное описание опций:

• Исходный рейтинг альбомов (Albums initial rating) - рейтинг фотоальбомов при создании.
• Пользователь по умолчанию для добавления альбомов (Default user for adding albums) - устанавливает от какого пользователя по умолчанию будут добавляться фотоальбомы в панели администрирования. Во время добавления фотоальбома вы сможете выбрать любого другого пользователя для данного фотоальбома.
• Статус по умолчанию для добавления альбомов (Default status for adding albums) - устанавливает статус фотоальбомов по умолчанию. Во время добавления фотоальбома вы сможете выбрать другой статус при необходимости для добавляемого фотоальбома.
• Время появления на сайте (Post time part) - настраивает механизм подстановки временной части даты появления альбомов на сайте. Во время добавления альбома вы сможете указать любое конкретное время появления для данного альбома.

3.10. Настройки доступа в админку (Admin panel access settings)

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

3.11. Настройки API (API settings)

KVS предоставляет небольшой API, который позволяет внешним скриптам создавать пользователей сайта и давать им / забирать у них премиум доступ. Вы можете использовать API для интеграции KVS с другими своими ресурсами при необходимости. Для информации о принимаемых параметрах смотрите скрипт /admin/api/kvs_api.php.

Детальное описание опций:

• Включить API (Enable API) - включает API.
• Пароль API (API password) - задает непустой секретный ключ, который необходим для использования API извне.
• URL доступа к API (API access URL) - URL по которому работает API. Его значение отличается у разных доменов.

4. Кастомизация (Customization)

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

Включив какие-либо из дополнительных полей, вы можете также указать их название, которое будет отображаться в панели администрирования (и только там!).

Вот некоторые примеры использования дополнительных полей:

• Для категорий по умолчанию включены 2 дополнительных поля, которые позволяют указать название и описание для отображения в HTML метаданных страницы (se-оптимизация). Эти значения будут использоваться (если не пустые) для каждой категории на странице списка видео по данной категории.
• Для контент провайдеров вы можете использовать большое количество полей для создания полноценных обзоров ваших спонсоров и любой другой рекламной информации.
• Дополнительные поля для обратной связи могут быть включены как обязательные в блоке обратной связи сайта (feedback). В этом случае при отправке обратной связи пользователь должен будет заполнить их.

5. Информация установки (Installation info)

Страница отображает некоторую отладочную информацию.

• Конфигурация (Configuration) - список всех конфигурационных параметров, которые задаются в файле /admin/include/setup.php. Большинство параметров являются различными путями или префиксами урлов и задаются при установке.
• Логи (Logs) - список системных логов с возможностью их просмотра.

6. Форматы (Formats)

6.1. Форматы видео (Video formats)

Форматы видео разбиты на 2 группы и тем самым позволяют задать координально разный набор видеофайлов для премиум видео и стандартного видео (публичные и личные видео).

Описание полей форматов видео:

• Название (Title) - название формата для отображения в панели администрирования.
• Постфикс (Postfix) - уникальный идентификатор формата, должен быть окончанием имени файла с расширением. Постфикс используется в названии видеофайла, перед ним стоит числовой идентификатор видео. Примеры постфиксов: .flv, .mp4, _hq.mp4, premium.wmv и т.д. Соответственно названия видеофайлов для приведенных постфикстов будут такие: 123.flv, 123.mp4, 123_hq.mp4, 123premium.wmv и т.д. Изменение постфикса после создания формата невозможно.
• Тип видео (Video type) - выбор группы форматов видео: группа стандартных видео или группа премиум видео. После создания формата выбрать другую группу будет невозможно.
• Status (Status) - статус формата видео, который определяет жизненный цикл файлов данного формата. Активный обязательный формат будет всегда создаваться автоматически для всех видео, если он не загружен вручную. Активный необязательный формат может быть загружен вручную, но никогда не будет создаваться автоматически. Неактивный формат не будет использоваться при создании видео - этот статус может понадобиться, если вы захотите убрать один из старых форматов, но не хотите потерять существующие видеофайлы этого формата. Галочка условно-необязательный позволяет задавать необязательные форматы, которые будут создаваться при условии, что длительность и размеры исходника видео позволяют создать такой формат.
• Размер видео (Video size) - позволяет либо указать фиксированный размер видеофайла, который должен создаваться форматом, либо указать, что видеофайл формата должен иметь такой же размер, как и исходное видео. Если вы задаете фиксированный размер видеофайла, то можно установить либо сохранение пропорций исходного видео (тогда высота будет плавающей), либо форсирование заданного размера (тогда по краям видео будет выполнен кроп для форсирования пропорций формата).
• Опции FFmpeg (FFmpeg options) - опции FFmpeg, которые отвечают за качество видео / аудио потоков, кодеки, формат контейнера и т.д. В качестве базы можно использовать такие опции: -vcodec libx264 -vpre medium -threads 0 -r 25 -g 50 -crf 33 -me_method hex -trellis 0 -bf 8 -directpred auto -acodec libfaac -ar 44100 -ab 128k -f flv
• Изображение watermark (Watermark image) - PNG изображение, которое будет накладываться поверх видео. Использование watermark изображений на видео зачастую требует установки отдельной версии FFmpeg, которая должна устанавливаться из SOC репозитория.
• Позиция watermark (Watermark position) - угол положения watermark изображения относительно видео.
• Уровень доступа (Access level) - позволяет выбрать категорию пользователей сайта, для которых видеофайлы данного формата будут доступны, соотв. для других пользователей файлы будут недоступны. Используется для настройки премиум зоны.
• Включить возможность скачивания (Enable ability to download) - включает возможность скачивать видеофайлы данного формата. Если эта опция не включена, то файлы доступны только из плеера. При включении этой опции для форматов видео, которые доступны всем посетителям сайта, будет ослаблена защита от хотлинкования видео.
• Выключить защиту от хотлинка (Disable hotlink protection) - позволяет хотлинковать видеофайлы данного формата.
• Ограничить длительность до (Limit duration to) - ограничивает длительность видеофайлов формата исходя из указанного кол-ва секунд или процентов. При указании ограничения в процентах позволяет также указать допустимые значения минимум и максимум в секундах.
• Кол-во частей (Number of parts) - используется совместно с ограничением длительности и позволяет сформировать трейлер указанной длительности из нескольких частей видео. С увеличением количества частей сильно увеличивается нагрузка на сервер конвертации.
• Смещение с начала (Skip from the start) - позволяет указать отступ от начала видео в секундах или процентах.
• Смещение с конца (Skip from the end) - позволяет указать отступ от конца видео в секундах или процентах.
• Ограничить скорость до (Limit speed to) - позволяет задать ограничение скорости отдачи файлов данного формата. Эта опция имеет смысл только когда отдача видео происходит через nginx.
• Создавать таймлайновые скриншоты (Create timeline screenshots) - включает создание таймлайновых скриншотов для видеофайлов этого формата. После включения этой опции для всех видеофайлов этого формата будут запущены фоновые задачи для создания таймлайновых скриншотов. При выключении этой опции существующие таймлайновые скриншоты удаляться не будут.
• Интервал снятия (Screenshots interval) - интервал в секундах, через который будут сниматься таймлайновые скриншоты.
• Название папки (Directory name) - название папки, в которой будут храниться таймлайновые скриншоты для каждого видеофайла этого формата. Вы должны указать именно название папки, а не путь к ней. Это название должно быть уникальным среди всех форматов видео и будет использоваться для составления пути к папки хранения таймлайновых скриншотов. Примеры названий папки: flv, mp4, mp4_premium_timelines и т.д. После того, как вы укажите название папки, изменить его будет невозможно.

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

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

При удалении формата видео будут удалены все видеофайлы данного формата со всех серверов хранения. Удаление файлов будет происходить на фоне. В течение этого времени формат будет находиться в статусе Удаление.

6.2. Форматы скриншотов (Screenshots formats)

Форматы скриншотов разбиты на 2 группы: обзорные и таймлайновые. Обзорные скриншоты создаются для каждого видео в целом на основе исходного файла видео. Количество обзорных скриншотов настраивается глобально в разделе системных настроек. Таймлайновые скриншоты привязываются к форматам видео, поэтому их количество настраивается в отдельных форматах видео путем указание интервала снятия таймлайновых скриншотов. Таким образом, у каждого видео обязательно будет хотя бы один обзорный скриншот, а также для каждого из форматов видео может быть свой отдельный набор таймлайновых скриншотов.

Описание полей форматов скриншотов:

• Название (Title) - название формата для отображения в панели администрирования.
• Группа (Group) - выбор группы формата (обзорная или таймлайновая). После создания формата выбрать другую группу будет невозможно.
• Размер (Size) - фиксированный размер скриншота для данного формата. Является уникальным идентификатором формата в группе, т.е. нельзя создать 2 обзорных формата скриншотов с одинаковым размером. Размер невозможно изменить после создания формата.
• Опции ImageMagick (ImageMagick options) - опции ImageMagick для обработки скриншотов данного формата. Опции должны содержать токены %INPUT_FILE%, %OUTPUT_FILE% и %SIZE%, которые заменятся на нужные пути и размер при выполнении операции. Данные опции ImageMagick будут использоваться только при автоматическом создании скриншотов по видео. Если вы вручную заливаете какие-либо скриншоты - изображение будет только смасштабировано до нужного размера.
• Аспект ратио скриншотов (Screenshots aspect ratio) - важная опция, которая позволяет указать механизм масштабирования скриншотов, снятых с видео, до размера требуемого данным форматом. Если аспект ратио исходного видео будет сохраняться, то на скриншотах могут появиться черные полосы по краям. Если же аспект ратио скриншотов будет подгоняться к требованию формата - черных полос не будет, однако исходные скриншоты будут обрезаны по краям при необходимости.
• Изображение watermark (Watermark image) - PNG изображение, которое будет накладываться поверх каждого скриншота.
• Позиция watermark (Watermark position) - угол положения watermark изображения относительно скриншота.

При создании нового формата скриншотов будет запущена одна фоновая задача для создания скриншотов данного формата для всех видео. Эта задача будет выполняться на главном сервере и может быть выполнена относительно быстро.

При удалении формата скриншотов будут удалены все скриншоты данного формата у всех видео. Удаление файлов будет происходить на фоне. В течение этого времени формат будет находиться в статусе Удаление. Перед удалением вам необходимо проверить, что в шаблонах сайта не осталось ссылок на скриншоты удаляемого формата. Для этого следует воспользоваться поиском по шаблонам в панели администрирования и искать использования размера формата в шаблонах сайта (например, 240x180).

6.3. Форматы альбомов (Albums formats)

Форматы альбомов разбиты на 2 группы: группа основных изображений и группа просмотра. Файлы форматов группы основных изображений создаются для каждой фотографии альбома. В то время как файлы форматов группы просмотра создаются для главной фотографии каждого альбома в единственном экземпляре.

Описание полей форматов альбомов:

• Название (Title) - название формата для отображения в панели администрирования.
• Группа (Group) - выбор группы формата (группа основных изображений или группа просмотра). После создания формата выбрать другую группу будет невозможно.
• Размер (Size) - размер фотографии для данного формата. Не является фиксированным размером, поскольку в отличие от скриншотов видео фотографии альбомов поддерживают динамические размеры с установленными максимальной шириной и высотой. Является уникальным идентификатором формата в группе. Размер невозможно изменить после создания формата.
• Опции ImageMagick (ImageMagick options) - опции ImageMagick для обработки фотографий данного формата. Опции должны содержать токены %INPUT_FILE%, %OUTPUT_FILE% и %SIZE%, которые заменятся на нужные пути и размер при выполнении операции. Данные опции ImageMagick будут использоваться при любых операциях с фотографиями.
• Аспект ратио изображений (Images aspect ratio) - важная опция, которая позволяет указать механизм масштабирования исходных фотографий до размера требуемого данным форматом. Если аспект ратио исходной фотографии будет сохраняться, то на фотографиях либо могут появиться черные полосы по краям (фиксированный размер), либо размер фотографии может быть меньше, чем размер формата (динамический размер). Если же аспект ратио фотографий будет подгоняться к требованию формата - черных полос не будет, однако исходные фотографии будут обрезаны по краям при необходимости.
• Изображение watermark (Watermark image) - PNG изображение, которое будет накладываться поверх каждой фотографии.
• Позиция watermark (Watermark position) - угол положения watermark изображения относительно фотографии.
• Уровень доступа (Access level) - позволяет выбрать категорию пользователей сайта, для которых фотографии данного формата будут доступны, соотв. для других пользователей фотографии будут недоступны. Ограничение доступа сработает только в тех случаях, когда вы используете защищенные ссылки на фотографии (через скрипт раздачи).
• Показывать изображение при отсутствии доступа (Show this image when no access) - позволяет указать конкретное изображение, которое будет показано пользователю при запросе через скрипт раздачи фотографии, доступа к которой у него нет. Если это поле оставлено пустым, то скрипт раздачи вернет ошибку (403 Forbidden).

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

При удалении формата альбомов будут удалены все фотографии данного формата у всех фотоальбомов. Удаление файлов будет происходить на фоне. В течение этого времени формат будет находиться в статусе Удаление. Перед удалением вам необходимо проверить, что в шаблонах сайта не осталось ссылок на фотографии удаляемого формата. Для этого следует воспользоваться поиском по шаблонам в панели администрирования и искать использования размера формата в шаблонах сайта (например, 120x160).

7. Администрирование (Administration)

Опции администрирования KVS позволяют:

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

8. Мультисерверность (Storage servers / Conversion servers)

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

8.1. Сервера хранения (Storage servers)

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

Описание полей серверов хранения:

• Название (Title) - название сервера для отображения в панели администрирования.
• Группа серверов (Server group) - группа серверов, к которой принадлежит данный сервер. Группы серверов позволяют настраивать балансировку нагрузки между серверами хранения.
• URL (URL) - HTTP ссылка к папке хранения видео.
• Тип подключения (Connection type) - влияет на способ копирования данных между серверами. Использование NFS не рекомендуется из-за проблем со стабильностью (опция NFS осталась для совместимости со старыми версиями KVS).
• Путь (Path) - полный путь к папке хранения видео. Папка, указанная в пути должна иметь права на запись (777) и соответствовать HTTP ссылке к папке хранения, указанной выше. При использовании Nginx папка хранения должна быть объявлена внутренней в конфиге Nginx.
• URL управляющего скрипта (Control script URL) - ссылка на управляющий скрипт remote_control.php, который должен быть скопирован на удаленный сервер конвертации. Управляющий скрипт находится в папке /admin/tools/. Данное поле заполняется автоматически, вам лишь необходимо скопировать скрипт remote_control.php и проверить, что он доступен по ссылке из этого поля. Если скрипт доступен, то он выведет слово connected., в противном случае вы не сможете добавить сервер конвертации.
• FTP хост (FTP host) - хост для соединения по FTP.
• FTP пользователь (FTP user) - пользователь для соединения по FTP.
• FTP пароль (FTP password) - пароль для соединения по FTP.
• FTP папка (FTP folder) - папка в которую нужно перейти, если FTP ведет не в нужную папку. Оставьте поле пустым, если FTP ведет в нужную папку.

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

8.2. Группы серверов хранения (Storage server groups)

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

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

Описание полей группы серверов хранения:

• Название (Title) - название группы для отображения в панели администрирования.

Описание столбцов таблицы балансировки:

• Сервер (Server) - название сервера хранения, опции которого настраивает строка таблицы.
• Статус (Status) - статус сервера хранения. Видео отдается только с активных серверов.
• Вес для балансировки (Load balancing weight) - указывает вес данного сервера при балансировке. Чем выше вес сервера по отношению к другим серверам, тем выше вероятность отдачи видео с этого сервера.
• Привязать страны (Assign countries) - позволяет привязать определенные сервера к определенным странам и отдавать видео с этих серверов только для пользователей указанных стран. Для одного сервера поле должно остаться пустым, что будет означать, что этот сервер используется для "всех остальных стран".

8.3. Сервера конвертации (Conversion servers)

Сервера конвертации предназначены для распределения нагрузки, которая возникает при операциях с видео.

Описание полей серверов конвертации:

• Название (Title) - название сервера для отображения в панели администрирования.
• Статус (Status) - статус сервера. Только активные сервера конвертации используются для работы.
• Макс. задач (Maximum tasks) - устанавливает максимальное количество задач, которое может быть передано на сервер конвертации одновременно. Это, однако, не устанавливает параллельного выполнения задач на сервере конвертации - все загруженные задачи будут выполняться последовательно.
• Тип подключения (Connection type) - влияет на способ копирования данных между серверами. Использование NFS не рекомендуется из-за проблем со стабильностью (опция NFS осталась для совместимости со старыми версиями KVS).
• Путь (Path) - полный путь к папке хранения задач. Папка, указанная в пути должна иметь права на запись (777) и в ней должен работать скрипт конвертации remote_cron.php поставленный на cron. Скрипт конвертации находится в папке /admin/tools/.
• FTP хост (FTP host) - хост для соединения по FTP.
• FTP пользователь (FTP user) - пользователь для соединения по FTP.
• FTP пароль (FTP password) - пароль для соединения по FTP.
• FTP папка (FTP folder) - папка в которую нужно перейти, если FTP ведет не в нужную папку. Оставьте поле пустым, если FTP ведет в нужную папку. В данной папке должен работать скрипт конвертации remote_cron.php поставленный на cron. Скрипт конвертации находится в папке /admin/tools/.

Перед созданием удаленного сервера конвертации вам необходимо скопировать на него скрипт remote_cron.php, который находится в папке /admin/tools/. После копирования этого скрипта, вам необходимо отредактировать его при необходимости, чтобы указать корректные пути к необходимым серверным библиотекам, а также установить для него выполнение по cron-у (каждую минуту). По умолчанию используются такие пути:

$ffmpeg_path="/usr/local/bin/ffmpeg";
$yamdi_path="/usr/local/bin/yamdi";
$qtf_path="/usr/local/bin/qt-faststart";