Kernel Video Sharing quick start / User Guide

Contents

Key features

KVS is one of the leading tube-scripts and video content managers since 2009. Here are the key reasons why KVS is better than all other competitors:

• KVS architecture is initially designed for huge traffic websites. The built-in performance monitoring provides ability to quickly react to any performance issues and optimize your website on-the-fly if required.
• KVS is not designed for a limited subset of projects in comparison to many other scripts. You can use KVS to create projects which are conceptually different from each other: cjtubes, paysites review, youtube clones, memberzones with protected content, communities, DVD stores and many other.
• KVS provides much more website customization facilities than its competitors. Besides design customization (which is possible for almost all scripts in the market) you will be able to create conceptually another website, 100% unique and not looking like other websites in the area.
• There is no script other than KVS which allows such a wide functionality for video content conversion, storage and protection.
• PHP source code is fully available. With source code you will be 100% sure of your project independence from us and can easily plug in your custom code.
• We are constantly improving KVS in different directions. We are in contact with our customers and implement most of the features they are proposing. From the first glance you can find KVS too heavy and feature-overloaded, but this is not true on practice! Everything what we are doing for KVS is demanded and useful. Therefore we hope you can use as much features as possible.

This guide describes KVS features in brief and also provides some information on how you can use them in real life scenarios.

The concept of video content

Video content storage architecture

In most cases all videos are stored on the same server where KVS is installed. This is the simplest topology but not the best one. Content server requires faster HDD / bandwidth, at the same time main server is more dependent on CPU and memory.

If you are going to set up several video projects on different servers, we recommend you storing your videos on one server (with higher bandwidth and speedy HDD) and setting up your websites on another server (with higher CPU performance and managed support).

KVS will allow you to configure storage servers easily. Here is the explanation on how video content storage architecture is working.

Every video which requires content storage (see the section later about video content types) is bound to a storage server group and stores its video files on all physical servers of this server group. In most cases a server group will consist of only one physical server where video files will be stored.

You can create server groups with several physical servers in there. This can be used to load balance the bandwidth between several physical servers. In some cases you will benefit from balancing video bandwidth in comparison to streaming videos from one physical server. Load balancing is performed based on weights and (or) countries. With KVS you can easily create a CDN, where USA visitor will stream videos from physical server located in USA and other visitors will stream videos from another server(s). Content load balancing can also be used to push visitors from non-solvent countries to a slower server.

When HDD of your content server will be utilized, you will need to add a new server(s) in order to store all new videos there. As we just said, a video is bound to a server group (not to individual physical servers), so in this case you should add a new server group and add a new physical server(s) there. After you do that all new videos will be automatically bound to the server group with more free space (unless you configure another behavior by the system option which will be described below).

In this above example the first server group stores 1520 videos and almost completely utilized (0.04% free space which is the minimum among all physical servers of this group). This group contains 2 physical servers and video is being stored on them both. In order to add 916 more videos we created another server group and added a new physical server into it.

If you want to force videos being bound to a particular server group (without free space analysis) you can use the corresponding option in system settings, which allows changing the default behavior. There is also one more option in system settings which specifies the minimum free space limit required for adding videos to a particular server group. This option is designed to warn you about HDD utilization.

Besides functionality to create own CDNs, KVS also supports some public CDNs, such as for example Swiftwill, Inc. CDN. The main difference of public CDN usage is that KVS copies files on once to a single server; all further replication is done by CDN provider.

Video multiformats support

Important! Video multiformats feature is not available in basic package of KVS. In basic package you will be able to set up only one video format.

KVS provides ability to set up a list of different video formats with different settings. Having a list of formats is required for many scenarios, such as:

• Provide ability for mobile users to watch videos with lower resolution.
• Provide ability to watch videos in different quality / size.
• Provide ability for users to download videos in different containers (MP4, MPG, MOV and etc.)
• Force non-registered users to watch only limited videos (limited in quality or duration), force users to sign up in order to see full videos in good quality.
• Limit free video files streaming speed.

Important! Video multiformats feature is supported for only those video content types, which store videos on your servers (File upload and Gallery URL - see section about video content types).

Video formats are configured in settings section. You can configure formats in 2 groups: each group is designed for different types of videos. In order to understand that, we should jump to the topic of memberzone creation with KVS. KVS provides ability to separate videos into several types: standard videos (public or private) and premium videos. In memberzone context you can set up that standard videos are available for everyone, but premium videos are fully available for premium members only (this is just an example). More detailed explanation of memberzone features you can find later in this guide. For the sake of video multiformats configuration you should understand that standard videos and premium videos can have completely different sets of video formats. For example standard videos will have only one FLV format and premium videos will have several formats: full FLV format of high quality + limited FLV format + additional formats for download.

You can set up video formats which will be automatically created for every video by convertion engine ( therefore video files of such formats will be reliably available for every video). You can also set up optional formats which will be available only if uploaded manually. This video format behavior is configured by status attribute with the following possible values:

• Disabled - files of this format will neither be created automatically nor can be uploaded manually. This status makes sense if you don't want to use one of the old formats anymore, but you also don't want to delete the existing files of this format. By using this status you will save the existing files.
• Required - files of this format will be created automatically for all videos. If you create such a format and you already have videos - files of this format will be automatically created for all videos which do not have them. After these files are created, KVS will guarantee that all videos have files of this format.
• Optional - files of this format will not be created automatically for the new videos, and they will not be created automatically for any existing videos which do not have them. This status allows you to have an optional format which can be uploaded or created for a particular video(s) when needed. Therefore files of this format may be absent for some videos.
• Removing files - files of this format are being currently removing. If you want to remove a format, it will be first moved to Removing files status and then it will finally be removed on background with all the files of this format.

Important! When we say "all videos" or "every video" we mean all videos of the particular type (standard or premium). As every video format is applicable only for one video type, adding a new required format for premium videos will only affect premium videos (if you have them).

When you define video formats for a particular video type you should create at least one Required format. So that every video will have at least one video file. If you want to create additional formats, their files will be created based on source file (if it exists) or based on one of the existing video files with the greatest file size.

Important! When you add a Required video format you should clearly understand that files of this format will be automatically created for all videos (of the particular type). This background operation may take days or even weeks (it depends on your videos count and server settings). In order to prevent you from loosing time we recommend you creating all new formats as Optional, then use videos mass edit to create files of these formats for several videos (in testing purpose). If there are no problems with creating video files for several videos - most probably you can safely change this format's status to Required and wait for all background tasks to finish for all other videos.

There is one important thing about Optional video formats. You can specify such a format to be conditionally-optional, so that video files of this format will be created automatically, but only when source video size and duration allow doing this. For example you want to store videos in 3 sizes: SD, HD and Full HD. Let's suppose that Full HD format can only be created from part of your source files. You should declare such format as conditionally-optional, so that video files are not required but created when possible.

Conditionally-optional video formats are only created when you upload a new video. If you already have videos and want to force conditionally-optional format to be created for videos where possible - you should use mass-edit feature and manually start video format creation.

Every video format may also have timeline screenshots bound to it. Timeline screenshots are screenshots which will be created based on the format video file. You will find more details about screenshots in the next sections.

Let's take a look at simple configuration example, which will be also used later in the next sections of this guide. Our imaginary website will stream standard videos in low and high quality, it will also store premium videos in HD quality using MP4 and WMV format with full length and 1-minute MP4 trailer. WMV format will be optional, because we are going to upload it manually. In this section we will not pay attention to any access rules and we will assume that all video formats are accessible for everyone.

Here are our formats:

Video format FFmpeg options

KVS uses FFmpeg, which is the most stable and supportable open source library designed for video conversion. FFmpeg options are specified separately for every video format. Here are the default options:

-vcodec libx264 -vpre lossless_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

Let's explain the most important from them:

• -vcodec libx264 option means video codec used for output video coding. The most popular and widely used codec at the current moment is h264; this code is used by default.
• -vpre lossless_medium option specifies quality / speed preset. A preset is a file with some options for video codec configuration (in our case h264) which influences on conversion quality and speed. In some ffmpeg builds this parameter is required, thus it is included by default.
• -r 25 option specifies frame rate as 25 frames per second.
• -crf 33 option configures video coding quality factor (lower value brings better quality). Using this parameter video stream will be coded with the constant quality factor and dynamic bitrate. It means that video fragments with more motion will be coded with lower quality (because for such fragments poor quality can not be visually identified). At the same time video fragments with static composition will have much more quality and greater bitrate. The main disadvantage of this method is that it doesn't allow you to expect certain file size and requires several iterations until you find the best suitable factor value. We recommend using value from 20 to 35.
• -acodec libfaac means audio codec used for output audio coding. The most popular codecs are libfaac (AAC) and libmp3lame (LAME). We recommend using AAC.
• -ar 44100 option specifies audio frequency (44100 hertz, Audio CD).
• -ab 128k option specifies constant audio bitrate (128 bits per second).
• -f flv option specifies output file container. For MP4 files you should use -f mp4.

More info about FFmpeg options you can find at its official website. More info about h264 options and presets you can find here.

Video screenshots

KVS separates screenshots into 2 big groups: overview screenshots and timeline screenshots. Overview screenshots are created based on source video files and are mainly used on website pages and for exporting videos into another projects where screenshots of different sizes are required. Timeline screenshots can be (optionally) created for video formats where they are enabled. Every video format will provide a separate set of timeline screenshots. Timeline screenshots are mainly designed for being displayed inside player on mouse move over timeline. This doesn't prevent you from using them wherever you want: display on separate pages and etc.

Similar to videos, the screenshots also support multiformats. You can create several format both for overview and for timeline screenshots. For every screenshot format you can specify its own size, ImageMagick options and watermark. In most cases you will create several screenshot formats of different size in order to use them for website design elements which require images of different sizes. If you want to change options of any screenshots format (for example you decided to use watermark) you can re-create all screenshots of this format for all videos by using the corresponding option in screenshot format context menu.

KVS will not require you to specify the fixed number of screenshots (both overview and timeline). Is it fairly legal that different videos have different number of screenshots. Within one video you will always have the same images count for different screenshot formats, because every screenshot format is just a different form of the same screenshot.

The initial overview screenshot count is configured in system settings:

• Fixed count for all videos. For instance, if you specify 5, conversion engine will create per 5 screenshots for every video. The interval between screenshots will be determined based on video duration.
• Dynamic interval-based (in seconds) count. For instance, if you specify 10, conversion engine will create a screenshot per every 10 seconds of video. According to that, videos with different duration will have different number of screenshots that are created initially.

Let's say it once again: in spite of the fact that you can specify the initial overview screenshots count as a fixed number, you will be able to remove or add screenshots manually for any video at any time. If you want to have 5 good screenshots for every video, we recommend you to set the initial count to a bigger number, for example 10. In many cases some screenshots are shot over a bad scene. In you have 10 initially, you will be able to leave 5 which are the best from your point of view.

Timeline screenshots as opposed to overview are always created with dynamic count, because they are bound to video format duration. In order to enable timeline screenshots and configure their duration you should edit video formats, for which you want to create them. When you enable timeline screenshots you should specify creation interval in seconds and name of the folder that will be used to store them. After you enable timeline screenshots for a video format, all existing videos with that format will be post-processed in order to create timeline screenshots for them.

Important! When enabling timeline screenshots you should specify folder name, but not path. We recommend to choose folder name based on video format name, e.g. for Premium MP4 HQ format you can specify premium_mp4_hq folder name for timeline screenshots.

Let's return back to our demonstration formats example and see how it can look like from timeline screenshots perspective. Suppose we want to enable timeline screenshots only for those formats, which will be streamed in our player on website:

After you enable timeline screenshots for all required video formats, you can add screenshot formats for timeline screenshots.

Every screenshot format has a special option that allows specifying how video file aspect ratio is being translated into a screenshot file. There are 2 possible scenarios:

• Preserve source video aspect ratio - in this case image taken from video will be resized to the maximum possible size and centered over the black background. It should be clear that if video aspect ratio doesn't match the required aspect ratio of screenshot format - there will be black areas on screenshot sides.
• Adjust to the required aspect ratio for screenshots of this format - in this case image taken from video will be cropped to match the required aspect ratio of screenshot format. Therefore there will be no black areas.

Video content types

At the current time KVS supports 5 video content types which are different in video storage and processing aspects:

• File upload (supports multiformats feature). You upload source video file (and / or final video files for formats) from the local machine or from the web by using URLs. Conversion engine takes the source file, creates video files for all required formats if they are not uploaded manually and creates all required screenshots. After the conversion operation is finished all format video files are being transferred to all servers of the video's server group. So in the case of File upload all video is always stored on your servers.
• Hosted file (multiformats feature is not supported). You hotlink video file which is hosted at third party server. In this case KVS may temporarily download this file in order to define its duration and create screenshots. For such video content type there are no video files stored on your servers. Such video plays hotlinked file in player when opened at a website page.
• Embed code (multiformats feature is not supported). You specify embed code with video player and embedded video file. If you have the direct URL of the video file, which is going to be played by this embed code, you can specify it additionally. In this case KVS may temporarily download this video file in order to define its duration and create screenshots. If you don't have any direct URL, you will have to manually specify video duration and upload screenshots, otherwise you won't be able to add such embed video. But in most cases you will have ability to find the direct video URL for almost every embed code (even if the link works for a limited time, it should work). Video of Embed code content type doesn't store any video files on your servers. When a visitor opens such video at a website page, the embed code will be displayed with playing video.
• Gallery URL (supports multiformats feature). You specify video gallery URL (its a web page where a single video player is displayed or a set of video players are displayed with the video divided into several parts). Conversion engine parses gallery page, locates all videos and merges them into a single video file. Then this video file acts as a source file: format video files and overview screenshots are created from it (e.g. similar to File upload). The result format video files are being transferred to all servers of the video's server group, e.g. such video is stored on your servers.
• Pseudo video (multiformats feature is not supported). You specify redirect URL and manually upload screenshots for this video. When such a video is opened on the website, all visitors will be redirected to the specified URL.

As you can see from the above explanation, multiformats feature is supported only for content types that store video files at your servers (File upload and Gallery URL). In order to create videos of these content types you should have at least one storage server group with at least one server there.

When adding videos manually, you should first select a content type and then fill in different fields based on which content type you've chosen. When importing a list of videos, content type for every video will be detected based on the fields you provided for that video (see more info in video import section of this document).

Important! Gallery URLs are only supported during video import.

Source files

Source files are usually uploaded (specified) by you in order to detect video duration and create video formats and overview screenshots from them.

In some cases you may want video duration (which is displayed on website) to be detected from one of the video's formats instead of source files. For example you may have 1-hour source videos, but you want to stream only 3-minutes trailers with your tube site. If duration is detected from source files, your all videos will have 1-hour duration, which is not valid in your case. For these needs you should use Take video duration from option is system settings, which allows you to select one of the video formats that will be used to detect video duration from.

Source files are not saved by default. You can enable saving source files in system settings of admin panel. Source files can be used later for creating new / more format video files and another overview screenshots after the video is successfully created.

For different content types source files are:

• File upload - video file uploaded in source file field. It can be used as a source file for format video files and overview screenshots creation. Instead of uploading a source file, you can upload any format video file (even all possible format video files); in this case KVS will use format video file with the biggest file size as a source file for all operations.
• Hosted file - video file downloaded using the specified URL. It can be used later for overview screenshots creation.
• Embed code - video file downloaded using the specified URL (if it was specified). It can be used later for overview screenshots creation.
• Gallery URL - video file merged from the videos that were found at a gallery page. It can be used as a source file for format video files and overview screenshots creation.
• Pseudo video - there is no source file for pseudo video.

Important! Source files are stored on your main server (e.g. source files are not bound to video server group).

Source files storage folder should be defined as internal in Nginx config, so that it can't be accessed from the web:

location ^~ /contents/videos_sources/ {
    root /usr/home/clients/ftp0/domains/kernel-tube.com/html; # specify full path to the root of /contents/videos_sources/ folder
    internal; # disable direct access
}

Video statuses explained

Video has 5 possible statuses:

• In process - video is scheduled for conversion or is being converted at the current moment. This status is given to video right after it is added to the database.
• Error - an error occurred during video conversion process. You can see error details by looking into video log (it is available in additional actions for every video on videos list).
• Active - video is available for website users. Please note that active video will be available only when its post datetime becomes greater than current datetime.
• Disabled - video is not available for website users. This video will not appear on any website pages, but it will still be available using direct link to video view page (for bookmark users).
• Deleting - video is scheduled for deleting which is the background operation. After all video data is removed (video files, screenshots and database records), this video will be completely removed from your project.

In admin panel you can only edit videos which are active or disabled.

Adding videos: manually

In order to add a video manually you should go to Videos section of admin panel. You will be able to add videos of all content types, except Gallery URL, which is designed for mass adding.

If you don't want to specify video title (maybe you would like it to be populated by desc-writer), you should create video in Disabled status. Then desc-writer will be able to filter disabled videos only, iterate over them and provide titles / descriptions for them, moving videos into Active status. Remember that videos will be available on website only in Active status.

Directory field is used for se-friendly URLs creation. This field is auto-generated and is present for almost every object in KVS. In most cases you should leave this field empty and let KVS automatically generate it based on object title. If you have a russian-speaking project, you should ensure that transliteration flag enabled in /admin/include/setup.php:

$config['is_translit_directories']="true";

KVS provides ability to schedule video to be visible on website in the future. Datetime of video so-called visibility is configured in Post date field, which can be set to the current date or to any date in past or future. Using this feature you can plan how much videos appear on your website every day (for example 10 videos daily) and you don't need to add them every day. Instead you can add all videos initially scheduled to appear on specific date and time, which is configured by Post date field. Time also matters! If you have a video which is scheduled to appear on January 1st at 18:50, this video will appear exactly after 18:50 server time. There is an option in system settings which provides ability to configure how the time is being auto-generated for the Post date field: random, current server time or 00:00.

Important! One of the often asked questions you ask is: "Why are my videos not visible on website? They are active, they have post date set to today". In this case you probably forgot about time - videos will appear today but later, as their post time has not yet reached.

Type of the video (public, private and premium) gives opportunity to classify video according to its access level. As you remember every video type has a separate set of video formats (public and private subtypes belong to standard type). If you select video type which doesn't have any video formats created for it, you will not be able to add video until you add at least one video format. The main purpose of video types is to help you in organizing premium memberzone. Access to videos is being controlled by specifying the access level of every video format. If a user has no access to every video format file of the specific video - user will not be able to see this video in any way. Find more information about video access limitations in the corresponding section about premium memberzone. Private videos are mostly designed for community: by default only video owner friend's can access his / her private videos (you can change this behavior by providing another logic in video_view block template).

Content source field is used to bind videos to its advertising sponsor. Content sources are created in categorization section of admin panel. When you create a content source you should specify its title and your referral link. Additionally you can upload a screenshot (in default templates it will be rendered as a banner over a video player), specify text description, upload up to 10 additional files. Advertising information from content sources can be used in website templates and as different ads inside a video player (it can be configured in player settings).

Important! Many KVS users design their websites to use content source data for displaying a lot of advertising information about their sponsors: different screenshots, reviews, ratings, feedback and other. We strongly recommend you using this feature for advertising your sponsors. Besides video view page KVS will allow you to create a separate website section with sponsor reviews, ratings / comments and etc.

We should also notice that you will have complete stats about all outgoing clicks to your sponsors (even including clicks for the ads inside player). Please find more information about counting outgoing traffic in statistics section of this document.

DVD / channel field can be used to mark this video as a scene in a DVD or channel. Once you do that, you will be able to display this video at DVD / channel page on your website. This functionality is only available for ultimate package.

User field specifies which user you want this video to be posted from. KVS installation will create the default Admin user, which is also set as a default user for all videos. If you want to change the defaults, you can do that in system settings.

Depending on video content type (Video adding option radio buttons) you will have to fill in different fields, which are related to the content type you choose:

• File upload. If you choose this content type you should either upload a Source file or one of the formats, which will act as a source file. All Active required formats will be created automatically from the uploaded source file. Optionally you can upload any format files. If you do that - files of these formats will not be created by conversion engine, however FLV and MP4 files will be post-processed by conversion engine in order to make sure they can be streamed. So if you convert your files locally - you can easily upload all of them without using conversion engine (except FLV and MP4 cases above). Important! When you manually upload format files, KVS is not able to validate if they have the required format (for example if the uploaded file is indeed a MPG file). You should make sure you upload files in the correct fields.
• Hosted file. In this case you should specify video file URL, which will be displayed in video player.
• Embed code. You should specify embed code, which will be rendered at video view page. Then you use 2 ways. No 1: you can specify video file URL, which will be temporarily downloaded and used for duration and screenshots creation. No 2: instead of specifying video file URL you can manually specify the duration and upload screenshots.
• Pseudo video. You should specify redirect URL for this content type. Of cause you should also specify duration and upload screenshots in order to make this video's data complete and accurate.

There are certain differences in a way you can upload video overview screenshots when creating new videos. You can upload either one JPG image, or list of JPG images in a ZIP file (of cause its legal to leave this field empty and in this case all video screenshots will be created automatically). Based on the overview screenshots count, configured in system settings KVS will go though one of the following scenarios:

• If you've configured only 1 overview screenshot per every video and you are uploading 1 JPG image - this image will be used as the only video screenshot and no other screenshots will be created.
• If you've configured multiple overview screenshots for every video and you are uploading 1 JPG image - this image will be used as main video screenshot, all other screenshots will be created automatically.
• If you are uploading a ZIP file (no matter how many files there) - all contained files will be used as video screenshots without creating any other screenshots.

Important! Video screenshots that are uploaded manually are processed differently than screenshots created automatically from video: for manually uploaded screenshots there are no cropping and ImageMagick options used; all the other options including aspect ratio change and watermarking are used in the same way. It means that KVS expects you to manually do cropping and image enhancements for all manually uploaded screenshots.

Besides main data fields there are also 3 custom text fields which can be enabled in customization settings. You can use these fields both in admin panel and website without any limitations for your needs.

Adding videos: mass import

Mass import in comparison to manual video adding provides ability to add hundreds of videos in several clicks. In addition to that mass import gives some outstanding features:

• You can select several users who will be owners of the added videos. For each video a random user will be selected from the list.
• You can specify post date interval. For each video post date will be randomly selected from the list.
• Instead of post date interval you can specify a number of days in the future to calculate post dates for the imported videos (1 day - all videos will be posted today, 2 days - today and tomorrow and etc). This method is useful when you regularly use the same import schema, so you won't need to change dates every time.
• Gallery URLs are only supported from mass import.

Mass import supports input data in any format. You can specify which row and column separators should be used. Each row should define a single video, each column should define a single data field. Based on your input data format you should select Fields for import in the same order as your input data defines them. Initially there are only 5 possible slots under Fields for import, but when you select them all - new slots will appear.

The following table lists all supported import fields:

Important! If you upload files for video formats separately by using Video file "XXX" fields, you should note that import will consider only fields which match the current video type (standard or premium. Video type can be specified in Type field. For standard videos (public or private types) the import engine will only consider Video file "XXX" fields related to standard video formats. In similar way it will act for premium videos. If Type field is not specified all videos are considered as public (standard).

The simplest way to define import data is to populate it in Excel table (each row is a video, each column is an import field). After you specify all the required columns and rows, you should select them and copy-paste to the textarea on video import page. You should use new line character (\r\n in Windows and \n in Unix) for Line separator and tab character (\t) for Field separator. Then you should select all fields for import in the correct order and specify any additional options.

KVS allows you to save import schemas for reuse in future. In order to do that you should specify the new schema name in create new schema field and check the default flag if this schema should be always selected by default. After you start the import process, all selected fields and options will be persisted in this schema. Later you can reuse this schema to avoid filling the same options. Any chnages in import fields and options will be persisted each time you start the import process.

If any of the saved schemas is marked with default flag, this schema will be automatically selected when you enter video import page.

Important! When you select the saved schema do not forget to change post date interval, which will contain dates from the previous import (if you use post date randomization this option). Specify relative number of days instead of exact dates in order to avoid changing dates for each import.

As many sponsors provide ability export their data in different formats, we recommend you to create different import schemas for different sponsors. It will be more easy to reuse them rather than using one schema and modifying import options each time you import data from another sponsor.

After you specify import data and options KVS will validate them. This is a background operation, which may take long time (data URLs and galleries validation usually takes long time). But you will be able to see its progress. After the validation is completed, you will see validation results with all found errors, warnings and information messages. If the result is not OK for you, you can return back and fix import data / options.

Import data validation can result in messages of the following types:

• Error - import data row contains critical error and will not be processed. You can go back to fix this error, or you can continue import having in mind that this row will be ignored.
• Warning - import data row may have a potential error. For example: "video with such title already exists", "category ... does not exist in the database and will be created from scratch" and so on. Warnings will not prevent row from being imported.
• Info - some information about import data row.

After you confirm the results of import validation - the final import process will be started.

Adding videos: import via feeds

Importing feeds should be used for video adding automation. In comparison to manual import, a feed works fully fully automated once created and activated. You can use feeds for the following tasks:

• Initial database creation using public feeds provided by your sponsors.
• Public feeds updates monitoring, e.g. adding new videos that appear after you initially imported all videos from a feed.
• Integration with 3rd party grabbers, which parse other websites to grab content from there. In this case grabbers should return data in understandable for KVS format.
• Integration within your own tube network, when adding content to the main website triggers adding this content to all websites, which monitor main website feeds.

KVS supports feeds of the following formats:

• XML-based format for KVS internal usage.
• SmartScripts format (XML-based as well).
• RSS format (adds videos as galleries).
• Almost any CSV format. If you use this format you should also specify columns list and columns order, as well as choose which column should act like a unique key to filter out videos, which have already been added by this feed.

When creating an importing feed you should specify feed URL with all options, specify feed execution interval and optionally specify the maximum number of videos that can be added during one execution. If you want this feed to be executed only once, you should enable the corresponding checkbox; such feed will be disabled after the first execution.

In addition to basic options, importing feeds provide ability to configure videos adding methodology in various aspects, which are supported by KVS. You can configure that all videos from feed have the same content provider. You can also configure if screenshots should be created by KVS or if screenshots provided by the feed should be used. Moreover you can configure videos post date distribution (when videos will appear on website). Finally you can configure which content type (content type affects how videos are stored and displayed) should be used for imported videos. Let's look into these aspects in more details.

Videos adding mode specifies content type handling for every video from this feed. The following options are supported:

• Add as embed codes - all videos from this feed will be added to your database as embed codes. In order this mode to work, the feed should provide embed code for every video. Most feeds do not support that, but embed code may be provided by different grabbers.
• Add as pseudo videos - all videos from this feed will be added to your database as pseudo videos. In order this mode to work, the feed should provide video page links.
• Hotlink videos (parts are hotlinked as separate videos) - all videos from this feed will be added to your database by hotlinking the video file, given in feed. If feed returns a video, divided into several parts, its separate video files will be added as separate videos. In addition to this option you should specify title postfix, which will be added to each video's title, so that videos created from multiple files of the same video do not have the same title (e.g. if you specify "Part %N%" here, a video with 3 files and "Video Title" title in feed will be added into your database as 3 separate videos with "Video Title Part 1", "Video Title Part 2" and "Video Title Part 3" titles).
• Download videos (parts are downloaded as separate videos) - all videos from this feed will be added to your database by saving video files on your servers. If feed returns a video, divided into several parts, its separate video files will be added as separate videos. Like for the previous option you have to specify title postfix. In addition to that you should select if the downloaded video files should be added as source files or as files of the particular format. The rule is similar to manual adding: if video files are added as source files, the conversion engine will automatically create all the required video formats; if you select one of the formats, the downloaded video file will be stored as a format file, files of the other required video formats will be created if needed.
• Download videos (parts are merged in one video) - all videos from this feed will be added to your database by saving video files on your servers. If feed returns a video, divided into several parts, its separate video files will be merged into one source file.
• Add as video galleries - all web-pages from this feed will be handled as video galleries (if a page contains several video files, they will be merged into one source file). This option is only available for RSS feeds.

Video post dates allows you to configure when videos from this feed will become visible on website. As you know, videos will appear on website only in active status and only after their post datetime comes. Video post dates setting configures only date part (the time part is populated according to system setting Post time part: random, current server time or 00:00). The following options are supported:

• Use server date - the post date of every video imported from the feed will be set to current date.
• Use post date from feed - the post date of every video imported from the feed will be set to whatever date comes in feed. In order this option to work, feed must provide post date for every video.
• Distribute uniformly - provides ability to uniformly distribute all imported videos in the specified interval of days in future. If you select this option, you should specify the number of days in future to calculate the interval and maximum number of videos that can be imported to one single day (not by one single feed, but globally by all feeds). According to that, when the limit is over for one day, feeds will add videos to the next day and so on until all videos are added or no more free days are available in the interval. This option makes big sense for feeds, which periodically update your database with new videos.
• Distribute randomly - provides ability to randomly distribute all imported videos in the given dates interval (either past or future). If you select this option, you should specify dates interval and maximum number of videos that can be imported to one single day. Using this option makes no sense for periodic feeds, but makes sense for feeds you may use to populate your initial database.

Let's consider a simple example of configuring post dates for feeds. Suppose we have 10 feeds which are executed once a day and contain 5-10 new videos daily. But we don't need so much videos every day, we need only 30 daily. Also we want feeds to populate videos for next 10 days only.

As feeds are executed daily, they will provide 50-100 videos every day. Initially we need to quickly populate the next 10 days interval and then reduce to 30 new videos daily. In order to do that, for every feed we should select Distribute uniformly option in Video post dates field. For days interval we should select 10 days and daily limit we will set into 30 videos. Please note that this should be repeated for every feed. After this is done, during next 4-8 days all feeds will add all their videos in order to pre-populate future 10 days interval, so that there are 300 videos in future.

After that your feeds will come to the point, when they will be able to add only 30 new videos for the last day of 10 days interval. There will be a problem here: not all feeds will be able to add videos, as there is a total limitation of 30 videos. In this case you should specify the maximum number of videos that can be added by a single feed during its execution (Videos limit field). If you specify 3 for each of 10 feeds, you will guarantee that each feed adds only 3 videos at a time and all your 10 feeds will add 30 videos daily.

Important! A feed will not add videos which have already been added by this feed. But if different feeds contain the same video, this video will be added by each feed and thus it will be duplicated in your database.

Массовое редактирование видео

Массовое редактирование видео позволяет проводить широкий спектр одинаковых операций над большим количеством видео. Список операций таков:

• Изменить статус, пользователя, контент провайдера и DVD / канал для всех выбранных видео.
• Сделать публичное видео личным и наоборот.
• Изменить дату постинга для всех выбранных видео на случайную дату в указанном диапазоне. Эта функциональность позволяет вам, например, взять сотню самых старых видео на вашем сайте и перекинуть их на появление в ближайшем будущем. Вместе с датами постинга видео изменятся и даты написания всех комментариев, событий и др. связанных объектов.
• Изменить рейтинг для всех выбранных видео на случайное число в указанном диапазоне.
• Добавить или удалить указанные тэги, категории, модели у всех выбранных видео.
• Обнулить значение указанного флага у всех выбранных видео.
• Удалить исходные файлы у всех выбранных видео.
• Создать (пересоздать) видеофайлы указанного формата (только для тех типов контента, которые поддерживают мультиформатность).
• Удалить видеофайлы указанного формата (только для тех типов контента, которые поддерживают мультиформатность).
• Смигрировать все видеофайлы выбранных видео с одной группы серверов на другую. При этом удаление видеофайлов на старой группе серверов произойдет не ранее чем через сутки (отложенная задача). Это требуется для того, чтобы на всех страницах сайта успели обновиться ссылки на видеофайлы, т.к. после физического удаления видеофайлов на старой группе серверов все старые ссылки перестанут работать.
• Сбросить статистику ротатора у всех выбранных видео.

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

Важно! Массовое редактирование будет проводиться только по видео в Активном или Неактивном статусе.

Работа со скриншотами видео

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

Ручная работа со скриншотами включает в себя следующие операции:

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

Важно! Ручная работа со скриншотами - это работа напрямую с исходниками, а не с форматами. Например, если вы заменяете второй скриншот - то на самом деле заменяется исходник второго скриншота, а затем на его основе создаются файлы всех форматов для второго скриншота, т.е. любые действия будут происходить симметрично ко всем форматам.

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

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

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

Экспорт данных о видео

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

Экспорт видео через фиды

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

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

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

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

• Возможность выбрать формат фида (KVS или CSV). При выборе CSV формата пользователь может указать список полей в нужном формате и символ разделителя полей.
• Возможность выбрать подходящий пользователю формат скриншотов из имеющегося у вас набора форматов обзорных скриншотов.
• Возможность выбрать подходящие пользователю форматы стандартных / премиум видео, если доступных для хотлинкования форматов несколько (например, flv и mp4).
• Возможность получить выборку по отдельной категории, отдельному тэгу, отдельному спонсору и отдельной модели.
• Возможность указать сортировку видео в выборке.
• Возможность указать лимит и начало выборки.
• Возможность сделать выборку за последние N дней.
• Возможность указать партнерский идентификатор и получить данные с партнерскими ссылками.
• Возможность указать скин и ширину плеера при получении embed кодов.

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

• Ссылка на сайт - при выборе этого типа контента фид будет предоставлять видео в виде ссылок на ваш сайт. Ваши партнеры не получат возможности получать из фида embed коды и прямые ссылки на видео для хотлинкования. Они смогут добавлять видео из фида как псевдо-видео к себе на ресурсы, при этом имея возможность использовать реф-ссылки (если фид поддерживает).
• Хотлинк - при выборе этого типа контента фид будет предоставлять не только ссылки на ваш сайт, но и ссылки на ваши видеофайлы с возможностью их хотлинкования. Для того, чтобы это работало для видео, которое хранится на ваших серверах, вам необходимо выключить защиту от хотлинка для форматов видео, которые вы хотите разрешить хотлинковать (смотрите главу ниже о защите от хотлинка). Например, у вас есть 3 формата для стандартных видео: High Quality MP4, Low Quality MP4 и Low Quality FLV. High Quality MP4 предназначен для просмотра только на вашем сайте, а Low Quality MP4 и Low Quality FLV вы хотите разрешить хотлинковать вашим партнерам. Если вы выключите защиту от хотлинка для Low Quality форматов - фид предоставит ссылки для хотлинкования. Поскольку доступных для хотлинкования форматов два - ваши партнеры смогут выбрать удобный для их сайта формат. По умолчанию фид будет давать ссылки на первый из доступных форматов. Если же видео у вас добавлено как хотлинк сторонних видеофайлов - то для таких видео фид будет отдавать ссылки как они есть.
• Embed код - при выборе этого типа контента фид будет предоставлять не только ссылки на ваш сайт, но и embed код на ваши видео (при этом для видеофайлов, хранящихся у вас, никаких возможностей для хотлинка не будет). Использование embed кодов для продвижения своего ресурса является очень сильной опцией KVS. Более подробную информацию о нюансах использования embed кода для своих видео вы найдете в соответствующей главе. Для видео, которые добавлены как хотлинк сторонних видеофайлов, embed код будет создаваться со ссылкой хотлинка. Для видео, которые добавлены как сторонний embed код, этот embed код будет отдаваться фидом как есть.

Защита видеофайлов от хотлинка и несанкционированного доступа

Защита видеофайлов от хотлинка базируется на двух уровнях защиты, оба из которых являются обязательными для полноценной защиты:

• Первым (нижним) уровнем защиты является защита видеофайлов от прямого скачивания. В KVS эта защита построена на использовании технологии Nginx X-Accel-Redirect. Суть работы X-Accel-Redirect заключается в том, что видеофайлы доступны только при редиректе на них через отдельный скрипт (так называемый скрипт раздачи). Таким образом, прямые ссылки на видеофайлы недоступны, даже если они и известны.
• Вторым (верхним) уровнем защиты является защита скрипта раздачи.

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

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

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

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

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

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

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

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

Фотоальбомы

Фотоальбомы в KVS являются частью функциональности сообщества, но с течением времени они все больше перерастают в отдельный тип контента в дополнение к видео. Фотоальбомы доступны только в полном пакете KVS.

Статусы фотоальбомов

Фотоальбомы имеют набор статусов, аналогичный видео:

• В процессе - фотоальбом стоит в очереди на обработку или обрабатывается в данный момент. В этот статусе фотоальбом появляется сразу после того, как добавляется в базу данных.
• Ошибка - во время обработки фотоальбома произошла ошибка. Детали ошибки вы можете посмотреть в логе обработки этого фотоальбома (на списке в дополнительных действиях для конкретного фотоальбома).
• Активный - фотоальбом доступен на сайте. Дата появления фотоальбома в отличие от видео - это дата его добавления в базу (в то время как видео поддерживает отложенное появление).
• Неактивный - фотоальбом не доступен на сайте, он не повляется ни в одном из списков. Прямая ссылка на страницу просмотра фотоальбома при этом работает.
• Удаление - фотоальбом стоит в очереди на удаление. Удаление фотоальбома происходит на фоне. После того, как все данные фотоальбома будут удалены (это фотографии и записи в базе), фотоальбом навсегда удалится из базы данных.

Вы можете редактировать фотоальбомы, которые находятся только в активном или неактивном статусе.

Мультиформатность фотоальбомов

По аналогии со скриншотами видео для фотоальбомов существует понятие мультиформатности. Как и скриншоты видео, фотоальбомы поддерживают 2 группы форматов:

• Группа основных изображений - в эту группу должны добавляться форматы, файлы которых будут создаваться для всех фотографий альбомов. Таким образом, в этой группе вы можете создать несколько форматов с разными размерами, например, для того, чтобы отобразить уменьшенную тумбу по каждой фотографии и саму фотографию при клике на тумбу.
• Группа просмотра - в эту группу должны добавляться форматы, файлы которых будут создаваться только для одной главной фотографии: предназначением этих файлов является отображение их на списке фотоальбомов. Вы можете создать несколько форматов для главной фотографии - например, по-разному отобразить ее в разных местах.

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

• Сохранять аспект ратио исходного изображения (фикс. размер) - эта опция аналогична похожей опции для форматов скриншотов, когда при несовпадении аспект ратио исходного размера и размера формата на обработанное изображение добавятся черный полосы. При этом, независимо от размеров исходных фотографий, все изображения такого формата будут иметь строго указанный размер.
• Подгонять под требуемый аспект ратио для изображений формата (фикс. размер) - эта опция также аналогична похожей опции для форматов скриншотов. При несовпадении аспект ратио части исходного изображения обрежутся до нужных пропорций и черных полос не будет. Таким образом, все изображения такого формата будут иметь строго указанный размер.
• Сохранять аспект ратио исходного изображения (динамич. размер) - эта опция позволяет вам указать максимально допустимые размеры изображений для данного формата. При создании файлов такого формата движок будет анализировать пропорции исходной фотографии и уменьшать их до нужной ширины или высоты при этом сохраняя аспект ратио исходной фотографии. Эта опция позволяет получить файлы формата с сохранением исходный пропорций, но без черных полос по краям.

Во-вторых, форматы для фотоальбомов позволяют настраивать уровень доступа к ним. Так, вы можете настроить, чтобы большие фотографии были доступны только зарегистрированным или премиум пользователям, а маленькие (тумбы) - всем. Или вообще сделать чтобы всем были доступны только главные фотографии альбомов (форматы из группы просмотра), а основные изображения всех размеров - только привилегированным пользователям.

Защита фотографий

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

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

Приведем примеры прямых и защищенных ссылок, чтобы вы видели разницу:

# прямая ссылка ведет на сам файл
http://domain.com/contents/albums/main/700x525/0/37/225.jpg

# защищенная ссылка перехватывается .htaccess и обрабатывается скриптом раздачи
http://domain.com/get_image/398b4bd3ff0df7e881db01797b456872/main/700x525/0/37/225.jpg/

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

# защита исходников фотографий
location ^~ /contents/albums/sources/ {
    root /usr/home/clients/ftp0/domains/kernel-tube.com/html; # указание полного пути к корневой папке для /contents/albums/sources/
    internal; # запрет доступа к папке по прямым ссылкам
}

# защита фотографий формата основных ихображений с размером 700x525
location ^~ /contents/albums/main/700x525/ {
    root /usr/home/clients/ftp0/domains/kernel-tube.com/html; # указание полного пути к корневой папке для /contents/albums/main/700x525/
    internal; # запрет доступа к папке по прямым ссылкам
}

В примере выше настроена защита для формата группы основных ихображений с размером 700x525 (он устанавливается в KVS по умолчанию), файлы которого хранятся в папке /contents/albums/main/700x525/. Если вы захотите ограничить доступ для форматов других размеров, то вам необходимо добавить аналогичные правила для каждого формата, заменив 700x525 на размер формата.

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

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

Исходники фотографий

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

Добавление фотоальбомов и работа с ними

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

Фотографии альбомов в KVS являются самостоятельными сущностями, поэтому вы можете указывать разные описания для разных фотографий, ставить отдельный рейтинг по каждой фотографии, добавлять комментарии к отдельным фотографиям. Можно даже отобразить глобальный список фотографий из всех альбомов (блок list_albums_images).

Импорт, экспорт и массовое редактирование фотоальбомов работают одинаково с аналогичными функциями для видео.

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

Обработка фоновых задач

Фоновые задачи и их типы

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

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

В KVS используются задачи многих типов. Некоторые задачи (в основном это обработка видеофайлов) выполняются в том числе и на серверах конвертации. Для большинства типов задач сервера конвертации не требуются, и задачи полностью выполняются на главном сервере. Существует несколько типов задач, которые могут выполняться длительное время (до нескольких суток), тем самым полностью подвешивая выполнение всех остальных фоновых процессов. Это происходит при создании новых форматов скриншотов и фотоальбомов, когда одна задача проходит по всем видео / фотоальбомам и создает (пересоздает) файлы изображений. Несложно представить, что при большом количестве видео / фотоальбомов такая задача может выполняться длительное время. Для вашего удобства KVS показывает процент выполнения таких задач прямо на списке задач в панели администрирования.

Любая задача при успешном завершении удаляется из списка задач. В случае же ошибки, задача остается висеть со статусом ошибки. Если это задача по конкретному видео / фотоальбому, то детали ошибки будут доступны в логе видео / фотоальбома: его можно посмотреть прямо из контекстного меню задачи. Если задача общего плана (нарезка нового формата скриншотов, например), то посмотреть информацию об ошибке можно наведя курсор мыши на название задачи в таблице.

Любую задачу, завершенную с ошибкой, можно перезапустить. Делать это нужно после исправления причины, которая привела к ошибке (например, устранен сбой FTP соединения, исправлена ошибка в опциях ffmpeg формата и т.д.), в противном случае задача снова выдаст ошибку.

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

Режим паузы

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

Опция перевода движка конвертации в режим паузы находится в системных настройках и называется Включить режим паузы для фоновых задач. Как только вы включите эту опцию, движок начнет переводиться в состояние паузы. Это произойдет не сразу - сначала движок должен закончить все уже начатые задачи, только потом он сможет перейти в состояние паузы, т.е. никакие новые задачи из очереди запускаться не будут. В шапке панели администрирования и на странице старта при этом появятся подсказки о том, что задачи находятся в состоянии паузы. Начиная с этого момента, вы можете вносить любые изменения в форматы видео, скриншотов и фотоальбомов. После того, как все изменения внесены - вы должны выключить режим паузы, чтобы задачи из очереди начали обрабатываться.

Сервера конвертации

Важно! Сервера конвертации недоступны владельцам базового и второго пакетов KVS. В этих пакетах в качестве сервера конвертации автоматически будет использоваться текущий сервер.

KVS позволяет задать любое количество серверов конвертации, которые будут использоваться параллельно для выполнения наиболее ресурсоемких задач (обработка видео и создание скриншотов). Управлять серверами конвертации можно в разделе настроек панели администрирования.

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

• $ffmpeg_path - путь к библиотеке FFmpeg, обязательный. Библиотека FFmpeg используется для основных задач конвертации видео.
• $yamdi_path - путь к библиотеке Yamdi, обязательный. Библиотека Yamdi предназначена для добавления метаинформация в файлы FLV формата, чтобы плеер мог осуществлять перемотку по ним.
• $qtf_path - путь к библиотеке qt-faststart, необязательный. Библиотека qt-faststart предназначена для пост-обработки файлов MP4 формата, чтобы плеер мог осуществлять перемотку по ним. Если вы не используете MP4 файлы, вы можете не устанавливать библиотеку qt-faststart. В этом случае вам необходимо установить пустую строку в переменную $qtf_path, чтобы скрипт не генерировал ошибку.
• $imagemagick_path - путь к библиотеке imagemagick, необязательный. Укажите путь к библиотеке convert, если вы хотите, чтобы создание форматов скриншотов происходило на данном сервере конвертации. Если путь к библиотеке imagemagick convert не указан, то создание форматов скриншотов будет происходить на главном сервере.
• $ap_path - путь к библиотеке AtomicParsley, необязательный. Библиотека AtomicParsley предназначена для пост-обработки файлов MP4 формата, чтобы разрешить проблему проигрывания MP4 файлов на некоторых мобильных устройствах.

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

Категоризация контента

Базовая категоризация: категории и тэги

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

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

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

В шаблонах сайта по умолчанию используются 2 дополнительных поля категорий. Одно называется HTML title и предназначено для вывода в тэг <title> на странице списка видео по какой-либо категории. Второе называется HTML description и имеет аналогичное предназначение. Таким образом, в данных полях для каждой категории вы можете указать значения, которые вы хотите выводить в метаданные страницы списка видео по каждой категории. При пустых значениях в метаданных страницы будут выводиться название и описание категории (из базовых полей).

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

Контент провайдеры, модели и DVD / каналы

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

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

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

Важно! Мы настоятельно рекомендуем использовать контент провайдеров для привязки рекламы к видео и фотоальбомам.

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

DVD / Каналы не являются элементами категоризации, однако имеют сходное предназначение. DVD / каналы позволяют сгруппировать несколько видео вместе, представив их как части одного большого фильма (серии сериала и т.д.). Для того, чтобы это сделать необходимо сначала создать DVD / канал в панели администрирования, затем либо при добавлении видео, либо массовым редактированием выбрать для конкретных видео нужный DVD / канал. Таким образом несколько видео будет привязано к одному DVD / каналу. DVD / Каналы доступны только в полном пакете функциональности KVS.

Мемберзона

Общая функциональность мемберзоны

Мемберзона доступна во всех пакетах софта, кроме базового. KVS поддерживает большое количество всевозможных настроек и ограничений, которые вы можете использовать для построения сайта, приносящего максимум прибыли. Основой таких настроек является поддержка нескольких типов (статусов) пользователей:

• Незарегистрированные - посетители сайта, которые не зарегистрированы или не осуществили вход в мемберзону, т.е. гости.
• Стандартные пользователи (Активные) - пользователи, которые зарегистрировались бесплатно и вошли в мемберзону под своими данными входа.
• Премиум пользователи - пользователи, которые зарегистрировались платно и вошли в мемберзону под своими данными входа. Такие пользователи составляют основу платного доступа.
• Вебмастера - системные пользователи, которых вы можете создавать (назначать) из панели администрирования. В настоящее время концепция пользователей-вебмастеров еще находится в разработке и будет дополняться функционалом в дальнейшем.

Таким образом, мемберзона KVS позволяет использовать бесплатную регистрацию наряду с платной регистрацией Премиум пользователей.

Настройка платного доступа

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

Вы можете совмещать использование процессоров по кредитным картам и SMS сообщениям. Также вы можете разрешить либо запретить возможность бесплатной регистрации. KVS позволяет пользователям в любой момент проапгрейдить свой Стандартный доступ на Премиум.

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

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

• Использовать ли возможность оплаты кредитной картой.
• Использовать ли возможность оплаты посредством SMS сообщений.
• Предоставлять ли возможность бесплатной регистрации.
• Какая опция оплаты должна быть выбрана по умолчанию.

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

• При выборе опции бесплатного доступа (если он разрешен в параметрах блока signup) пользователь должен заполнить форму и (если настроено в параметрах блока signup) подтвердить регистрацию по email. После завершения процесса регистрации пользователь будет иметь Активный статус, т.е. Стандартный тип доступа.
• При выборе опции оплаты по кредитке (если разрешено в параметрах блока signup и активирован процессор биллинга по кредитным картам) пользователь должен заполнить форму, после этого он будет перенаправлен на сайт процессора оплаты, где должен будет произвести оплату. После подтверждения оплаты процессор биллинга на фоне передаст данные о транзакции на сторону KVS, где информация о пользователе добавится в БД и пользователь получит Премиум доступ.
• При выборе опции оплаты посредством SMS сообщения (если разрешено в параметрах блока signup и активирован процессор SMS биллинга) пользователь должен отправить SMS сообщение с указанным текстом на телефонный номер, который он выбирает исходя из страны проживания и своего оператора сотовой связи (эта информация задается при создании пакетов доступа SMS процессора на стороне KVS и отображается на странице регистрации). После принятия SMS сообщения процессор биллинга на фоне передаст данные о транзакции на сторону KVS и пришлет пользователю в ответном SMS сообщении код доступа. Пользователь должен ввести этот код в соответствующее поле формы регистрации, и, если код верный, пользователь будет зарегистрирован и получит получит Премиум доступ.

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

Организация доступа к видео для пользователей

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

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

С точки зрения длительности платного доступа также существует несколько концепций:

• Безлимитная длительность доступа.
• Доступ, ограниченный по длительности (например, в течение месяца).

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

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

Для этого в каждом из форматов видео выберем нужное значение в поле Уровень доступа. Включим возможность скачивания для 2-х полных премиум форматов. В списке форматов видео переключимся на режим отображения Доступ и защита и посмотрим, что у нас получилось:

Мы видим, что незарегистрированным пользователям доступны только файлы 2 форматов видео: MP4 LQ и Premium Trailer MP4.

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

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

Рассмотрим настройку слотов плеера для стандартных видео:

Мы использовали 3 слота и выбрали в них 2 существующих формата видео и статический редирект в последнем слоте. Рядом с каждым слотом выводится подсказка, что произойдет с пользователем определенного уровня доступа при выборе каждого из слотов. Например, при выборе слота High quality видеофайл по слоту будет показан зарегистрированным пользователям (активным и премиум), в то время как незарегистрированные пользователи будут перенаправлены по настроенному URL-у. Этот URL задается в настройках плеера в поле URL редиректа. Для нашего примера воспользуемся ссылкой на страницу регистрации и апгрейда доступа (signup.php). Таким образом, вот что произойдет для каждого типа пользователя при попытках переключаться на слоты в плеере:

Обратим внимание на 2 нюанса, которые видны на скриншоте выше:

• Первое. Порядок отображения слотов для незарегистрированных пользователей не такой, как указано в настройках плеера. Это обусловлено тем, что у незарегистрированных пользователей нет доступа к первому слоту (формат MP4 HQ), поэтому самым первым и выбранным по умолчанию слотом становится слот с форматом MP4 LQ, к которому у незарегистрированных пользователей есть доступ. Для остальных же типов пользователей порядок не нарушается, поскольку как у активных, так и у премиум пользователей есть доступ к слоту с форматом MP4 HQ.
• Второе. Для премиум пользователей отображение слота HD quality не имеет смысла, поскольку этот слот содержит статический редирект на страницу регистрации и апгрейда доступа, но для премиум пользователей уже невозможно осуществить регистрацию или апгрейд доступа.

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

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

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

Для премиум пользователей мы оставили только 2 слота в стандартных видео. К форматам видео в обоих слотах у премиум пользователей есть доступ, это значит что для них не будет никаких редиректов (что также видно по подсказкам). В слотах премиум видео мы указали только один слот с полным MP4 форматом. В таких случаях при отображении в плеере у премиум пользователей вообще не будет видно никаких слотов, поэтому название слота можно не указывать.

Для остальных пользователей (активных и незарегистрированных) мы оставили настройку слотов стандартных видео такой же, как она и была. В слотах премиум видео мы выбрали 2 формата видео, из которых только к одному есть доступ у данных пользователей (к трейлеру). Таким образом, при выборе слота Full video HD в плеере на сайте - пользователи перейдут на страницу регистрации и апгрейда доступа.

Финализируя, составим небольшой список нюансов отображения слотов в плеере:

• Уровень доступа к форматам видео настраивается в самих форматах видео. Отображение слотов с форматами видео настраивается в настройках плеера.
• В первом слоте должен быть выбрать один из форматов видео (статический редирект нельзя).
• Если у пользователя с определенным уровнем доступа нет доступа ни к одному из форматов видео, выбранных в слотах, то пользователь не сможет посмотреть видео. В шаблонах сайта по умолчанию в этом случае вместо плеера выводится соответствующий текст, который вы можете отредактировать по вашему усмотрению.
• Если в настройках плеера указан только один первый слот, то плеер на сайте не будет отображать выпадающий список и название слота можно оставить пустым.
• В качестве видеофайла, отображаемого плеером при инициализации, будет выбран видеофайл из первого попавшегося слота, к которому у пользователя есть доступ. Такой слот станет первым в списке, остальные будут отображаться в порядке их указания в настройках.
• Если у пользователя нет доступа к видеофайлу, выбранному в каком-либо слоте плеера, то при выборе этого слота пользователь будет перенаправлен по ссылке, указанной в настройках плеера.
• Для того, чтобы по видео можно было получить embed код для использования на сторонних сайта, необходимо установить как минимум первый слот в настройках embed плеера. Для embed плеера можно выбрать только те форматы видео, которые доступны всем типам пользователей.

Защита мемберзоны от мультидоступа

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

При каждом входе пользователя логгируется такая информация как IP адрес, страна (если у вас установлен GEOIP) и браузер. Имея набор таких данных за какой-то интервал времени можно с большой долей вероятности рассматривать некоторые аккаунты как "проходные".

KVS позволяет указать условия, при которых аккаунт считается "проходным", а также настроить политику блокирования таких аккаунтов:

• Мгновенная блокировка навсегда. Если вы выбрали эту политику, то при сработывании одного из условий блокировки аккаунт пользователя блокируется, при попытке входа показывается сообщение о блокировке. Снять такую блокировку можно только обратившись в службу поддержки, т.е. блокировка снимается вручную администратором в панели администрирования.
• Временная блокировка. При срабатывании одного из условий блокировки аккаунт пользователя временно блокируется и пользователю на email посылается сообщение о том, что его аккаунт был заблокирован, и пользователь должен воспользоваться специальной ссылкой для разблокировки. В дополнение к этой политике временных блокировок вы можете также указать максимальное количество временных блокировок, после преодоления которого для аккаунта происходит блокировка навсегда (которая опять же может быть снята администратором при необходимости).

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

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

• Количество уникальных IP адресов за единицу времени. Не является надежным критерием, поскольку во многих случаях IP адреса регулярно меняются у одного и того же человека.
• Количество уникальных масок IP адресов за единицу времени. Под маской подразумеваются первые 3 цифры IP адреса, например 192.168.12.xxx.
• Количество уникальных стран за единицу времени (имеет смысл только если у вас установлен GEOIP).
• Количество уникальных браузеров за единицу времени.

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

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

Сообщество

Общая функциональность сообщества

Сообщество позволяет дополнить мемберзону и сделать сайт более известным и посещаемым. Развитие сообщества это непростая задача и требуется далеко не всем, поэтому мы сделали несколько пакетов софта с различными функциями сообщества. Таким образом, полная функциональность сообщества доступна только в полной комплектации KVS.

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

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

Пользователи и профили

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

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

Изменение данных профайла пользователя осуществляется блоком member_profile_edit, который работает в режиме трех форм: форма редактирования профиля (основные данные, аватар), форма редактирования email (необходимость подтверждения изменения email настраивается параметром блока) и форма редактирования пароля входа в личную зону.

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

Загрузка видео пользователями

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

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

Блок загрузки видео (video_edit) позволяет вам настроить также несколько аспектов проверки загружаемого видео:

• Является ли описание видео обязательным полем или нет (по умолчанию - обязательное).
• Является ли указание тэгов обязательным или нет (по умолчанию - обязательное).
• Является ли указание категорий видео обязательным или нет (по умолчанию - обязательное).
• Указать минимальную длительность видео в секундах (по умолчанию настроено 5 секунд).
• Указать максимальную длительность видео в секундах.

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

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

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

Блок загрузки видео поддерживает возможность блокировать редактирование видео целиком или только его главных скриншотов. За это отвечают несколько параметров в настройках блока. Если вы хотите заблокировать только определенные видео для редактирования (а заодно и удаления, правда удаление видео с сайта контролируется другим блоком - списком видео), вы можете пометить данные видео как заблокированные в панели администрирования. После этого данные видео невозможно будет удалить либо отредактировать с сайта.

Создание фотоальбомов пользователями

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

• Является ли описание фотоальбома обязательным полем или нет (по умолчанию - обязательное).
• Является ли указание тэгов обязательным или нет (по умолчанию - обязательное).
• Является ли указание категории фотоальбома обязательным или нет (по умолчанию - обязательное).
• Указать минимальные размеры загружаемых фотографий (по умолчанию 800x600).
• Разрешить ли создавать фотоальбомы без регистрации, т.е. анонимным посетителям (по умолчанию - нет).

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

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

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

Другие аспекты

Кроме заполнения профилей, загрузки видео и создания фотоальбомов (это описано далее) KVS также предоставляет основные возможности организовать полноценное общение внутри сообщества.

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

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

В-третьих, это возможность оставлять свои комментарии на так называемой стене пользователя, т.е. по сути комментарии к профилю пользователя.

Ротатор

KVS поддерживает двухуровневый модуль ротации видео:

• Первым уровнем ротации видео является ротация непосредственно самих видео с целью определения наиболее кликабельных из них. Результатом такой ротации станет ранжирование всех видео по значению CTR (чем выше CTR, тем большая вероятность клика по данному видео).
• Вторым уровнем ротации видео является ротация скриншотов внутри каждого видео с целью определения наиболее кликабельных их них. Результатом такой ротации станет выбор главного скриншота по значению CTR, а также опционально удаление некоторого кол-ва худших с точки зрения ротатора скриншотов.

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

Ротация видео

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

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

Здесь важно понимать, что включение ротации видео (первого уровня) абсолютно ничего не меняет на сайте. Ротация первого уровня занимается исключительно сбором статистики и рассчетом CTR каждого видео, значение которого вы можете в последующем использовать в качестве сортировки видео на каких-либо списках. Так, например, вы можете сделать отдельную страницу для принятия трафика и поместить на нее 50 лучших по CTR видео. Для этого вам всего лишь нужно будет вставить блок list_videos и включить в нем сортировку по CTR.

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

• В KVS видео на сайте отображается многими списками с разными сортировками и фильтрами. Исходя из этого у ротатора нет возможности свободного выбора, какие видео должны быть выведены на списке, т.к. вывод осуществляется строго по сортировке. Поскольку разные списки видео имеют разную посещаемость (пример: на список видео с категорией cat1 заходят в 10 раз чаще, чем на список видео с категорией cat2), это вызывает дисбалансы показов, что приводит к неравномерному сбору статистики.
• Кэширование в KVS играет огромную роль в работе сайте. Этот факт также влияет на дисбалансы показов видео, поскольку из-за кэша одно видео может показываться на одном и том же месте сайта до суток (в реальности максимальная длительность показа зависит от времени кэширования страницы / блока, которое настраивается вами).

Ротация скриншотов видео

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

Ротация скриншотов в отличие от ротации видео первого уровня - это процесс, который имеет начало и конец для каждого видео. После завершения ротации скриншотов у какого-либо видео, KVS сделает следующие шаги:

• Если в настройках ротации скриншотов у вас включено удаление части худших по CTR скриншотов - эти скриншоты будут удалены.
• Будет выбран новый главный скриншот с лучшим CTR.
• Ротация скриншотов для этого видео закончится.

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

Для наиболее оптимального выбора критерия завершенности KVS отображает небольшую гистограмму завершенности ротации скриншотов, где показывает распределение видео по дискретным интервалам завершенности. Если скорость ротации вас не устраивает (например, через сутки после включения ротации только 10% видео попали в диапазон завершенности 0%-20%), вы можете снизить значения критерия и посмотреть как изменится график. Через несколько аналогичных итераций вы сможете подобрать себе оптимальные значения критерия.

Со временем скриншоты у большинства видео сротируются и такое видео выйдет из ротации. В гистограмме завершенности такое видео будет находиться в интервале 100%.

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

Во время включенной ротации скриншотов каждое видео будет менять свой главный скриншот на сайте случайным образом для того, чтобы обеспечить равномерное покрытие показов. Соответственно, если у видео 10 скриншотов, то все они будут показываться случайным образом на всех страницах сайта, где показывается данное видео (кроме любимых видео пользователя и загруженных видео пользователя). Это может быть нежелательным для некоторых страниц сайта, на которых стоило бы в любой момент времени показать только лучшие скриншоты на текущий момент для поднятия продуктивности (страница Index, например, либо другая страница, на которую вы принимаете трафик). Для того, чтобы добиться такого эффекта, вам необходимо включить параметр блока show_best_screenshots в конкретных блоках list_videos, где вы хотите всегда показывать только лучшие по CTR скриншоты (т.е. ротация скриншотов в этих блоках идти не будет).

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

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

Продвинутые вопросы

Создание сайтов сателлитов

KVS поддерживает несколько подходов к созданию сайтов сателлитов.

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

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

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

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

Использование embed кода на свои видео

KVS предоставляет огромные возможности для управления embed кодами на свои видео. Продвижение сайта через embed коды имеет ряд преимуществ перед таким методом как, например, предоставление hosted видео:

• Вашим партнерам не требуется платить за канал, как и при использовании hosted видео.
• При использовании hosted видео у вас нет гарантии, что будет показана ваша реклама. При использовании embed кодов KVS ваша реклама не может быть перекрыта или убрана.
• Рекламные возможности embed плеера KVS не зависят от самого embed кода. Embed код содержит только ссылку на видеофайл и некоторые параметры презентации, такие как preview изображение, скин, размеры. Настройка рекламы задается глобально в настройках embed плеера в панели администрирования KVS и может быть изменена в любой момент - при этом изменения мгновенно отразятся на всех местах, где стоят ваши embed коды!
• При желании вы можете позволить партнерам передавать свой партнерский реф-идентификатор через embed код и получать % от ваших доходов. Для этого удобно использовать фиды экспорта, которые выдают ваши видео в виде embed кодов - партнер может передать свой идентификатор и получить embed коды с уже проставленным везде идентификатором.
• Embed коды, в отличие от hosted видео, могут распространяться самостоятельно пользователями.
• KVS предоставляет статистику по показам ваших embed кодов.

Оговоримся также, что KVS имеет возможности предоставлять и hosted видео, если вы видите смысл в его использовании (по аналогии с embed кодами через фиды экспорта).

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

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

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

Реклама для embed плеера задается в настройках embed плеера.

Динамические HTTP параметры и прием вебмастерского трафика

Движок сайта KVS рассчитан на большую нагрузку трафиком, поэтому он использует двухуровневое кэширование для оптимизации работы и снятия нагрузки с базы данных. Кэширование, однако, накладывает некоторые ограничения на шаблоны сайта, одним из которых является невозможность отображать (или использовать как-либо иначе) HTTP параметров, которые приходят в ссылках на страницы вашего сайта.

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

http://domain.com/path/to/page/?refid=123456

В шаблоне страницы, где нужно подставить переданный идентификатор, вы можете просто вывести его через Smarty:

<a href="https://secure.payment-processor.com/?reseller_code={{$smarty.request.refid}}">Get premium access!</a>

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

Для нивелирования данного недостатка кэширования KVS позволяет настроить до 3-х динамических HTTP параметров, которые будут подставляться в нужные места на страницах независимо от кэширования страниц. Настройка данных параметров осуществляется в разделе системных настроек KVS. Вы можете указать как название самих параметров, так и значения по умолчанию для них, которые будут использоваться если значения параметра не было передано движку в какой-либо из ссылок на сайт.

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

http://domain.com/path/to/page/?refid=123456

При обработке такого запроса движок KVS увидит, что было передано значение для динамического HTTP параметра refid, и сохранит это значение в сессию пользователя и его cookies (на 360 дней), тем самым это значение будет сохраняться при последующих запросах и визитах данного пользователя до тех пор, пока данный пользователь не придет по ссылке с новым значением данного параметра или пока не удалится cookies.

Для использования значения данного динамического HTTP параметра на сайте либо в других местах (см. таблицу ниже) вам необходимо использовать токен %refid%, который в нашем примере везде заменится на 123456. Ниже приведен список мест, где можно использовать токены динамических HTTP параметров:

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

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

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

Получить embed коды с проставленным реф-идентификатором ваши партнеры могут 2-мя путями:

• Зайти на ваш сайт со своим реф-идентификатором и вручную копировать embed коды из плеера по всем видео.
• Если вы создали фид экспорта, который отдает embed коды на ваши видео - партнеры могут воспользоваться им для массового получения всех embed кодов (и последующего обновления их). Для этого вам необходимо указать HTTP параметр, который используется у вас на сайте и в котором фиду будет передаваться реф-идентификатор.

Управление работниками / администраторами

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

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

При использовании ограниченных администраторов в KVS вы можете контролировать их работу, используя данные Лога активности и Лога аудита, которые находятся в разделе настроек панели администрирования. Лог активности позволяет получить информацию обо всех входах в панель администрирования и о длительности сессий. Лог аудита собирает детальную статистику по операциям с видео и фотоальбомами (кто и когда создавал, изменял или удалял). Используя данные аудита вы можете проверить, сколько видео и / или фотоальбомов было создано / обработано вашими работниками за день, нелделю, месяц и т.д.

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

Статистика сайта

KVS предоставляет полноценную статистику по всем аспектам сайта, мемберзоны и сообщества.

Статистика по трафику

Подсчет статистики по трафику базируется на связке Javascript + Cookie для разделения трафика на основной и nocookie. В качестве nocookie могут определяться роботы поисковых систем, хитботы и, в некоторых случаях, настоящие пользователи при наличии у них ограничений на выполнение Javascript или хранение cookie.

Статистика запросов и выходов рассчитывается по крону раз в 5 минут и хранится с дискретностью в одни сутки.

Основными показателями статистики запросов к сайту являются:

• Уники - количество уникальных посетителей сайта за указанный период. Уникальным посетителем признается пользователь, у которого нет установленной cookie в течение последних 24 часов.
• Всего - количество всех запросов к сайту, которые создали уникальные посетители за указанный период.
• Просмотров видео - количество запросов к странице просмотра видео (а точнее к блоку просмотра видео на ней; если блок просмотра видео будет использоваться на других страницах, то статистика заходов на них будет прибавляться к этому числу) за указанный период.
• Загрузок embed - количество загрузок вашего embed кода на сторонних сайтах.
• Без cookie - количество nocookie трафика. Данное число содержит всех, кто не прошел проверку на наличие cookie.
• Выходы на КП - количество выходов на контент провайдеров видео. Учитывается везде, где вместо прямых ссылок на сайты контент провайдеров вы используете специально предназначенный внутренний скрипт редиректа, который подсчитывает статистику. Учитываются также клики на любую рекламу внутри плеера (прерол, построл, пауза и т.д.), которая привязана к URL-у контент провайдера. Также дополнительно показывается процентное соотношение выходов к количеству уникальных посетителей сайта.
• Выходы на рекламу - количество выходов на рекламу. Учитывается только для рекламных блоков, которые вставляются на страницы сайта через настройки рекламы в панели администрирования, если в настройках рекламы отдельно задан URL выхода. Также дополнительно показывается процентное соотношение выходов к количеству уникальных посетителей сайта.

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

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

ссылка на php скрипт: http://your_domain.com/redirect_cs.php?dir=%директория_контент_провадера%
или
ссылка через mod_rewrite: http://your_domain.com/cs/%директория_контент_провадера%/

Статистика по поиску на сайте

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

Важно! Для целей оптимизации отображения статистики поисковых запросов в панели администрирования выводятся только такие запросы, которые были введены 2 и более раз.

Статистика по использованию ваших embed кодов

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

Рефереры или источники трафика

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

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

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

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

Кроме непосредственно анализа статистики, вы можете использовать рефереров для вывода на сайте топа ваших трейдеров по различным критериям. Топ трейдеров выводится блоком top_referers. Данный блок позволяет вам не только непосредственно вывести список рефереров с нужной сортировкой (более 10 различных вариаций), но и также поддерживает несколько вспомогательных опций:

• Каждого реферера можно привязать к определенной категории (в настройках реферера). Используя блок top_referers на странице информации о категории, вы можете выводить список рефереров исключительно из данной категории. Используя блок top_referers на странице просмотра видео вы можете выводить список рефереров исключительно по категориям открытого видео.
• Вы можете настроить блок top_referers таким образом, чтобы он работал в стиле "списка видео", тогда для каждого реферера будет выбираться подходящее по категории видео. Это можно использовать для вывода списков по типу "Лучшие видео на сайтах наших друзей" и т.д.

Статистика мемберзоны и сообщества

При использовании мемберзоны и сообщества вам будет доступна следующая статистика:

• Транзакции - полная статистика по всем транзакциям мемберзоны на сайте.
• Активность пользователей - статистика активности по всем пользователям сайта. Содержит большое количество данных, поэтому в качестве названий столбцов используются аббревиатуры. Для получения описания столбца задержите мышь над его аббревиатурой.
• Входы пользователей - статистика входов пользователей в мемберзону сайта. Данная статистика доступна в 2 видах: плоский лог всех входов и группировка по пользователям с отображением суммарной информации по каждому пользователю.
• Анализ IP-ков транзакций - позволяет проанализировать IP-ки транзакций на предмет массовых транзакций с одного IP.

Построение сайта и управление им

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

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

Работа с движком сайта является темой отдельного руководства. Если вы не хотите вникать в детали работы с движком, вы можете обратиться к третьим лицам (дизайнерам, верстальщикам), которые имеют опыт работы с кастомизацией KVS и смогут помочь вам. В данном руководстве мы лишь рассмотрим поверхностные сведения о движке сайта KVS.

Общие концепции

Сайт строится на основе набора страниц, которые заданы в движке KVS. Для каждой страницы создается свой PHP файл в корне проекта, который просто переадресовывает запрос на движок KVS, и шаблон в папке /template, который задает контент страницы (отображаемую информацию). Контент страницы может быть абсолютно любым - например, статический HTML текст, вывод информации из базы данных, XML код.

Таким образом, вы в любой момент времени можете создавать любые страницы сайта с нужным вам контентом на них. Делать это нужно в разделе UI сайта (Website UI) панели администрирования. Создание новых страниц сайта - это единственная операция, которая требует установки менее строгих прав доступа на папку корня домена (777). После того, как страница создана, вам необходимо вернуть назад более строгие права на папку корня домена в целях безопасности.

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

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

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

Если вы хотите сделать страницу, которая отображает какие-то данные KVS (например, список видео, или профиль пользователя, или все вместе), вам необходимо добавить на страницу те или иные блоки сайта, которые умеют выводить нужные вам данные. В разделе UI сайта (Website UI) вы можете посмотреть полный список всех блоков и определиться какие блоки вам нужны на данной странице. Добавление блока на страницу KVS осуществляется при помощи специальной директивы в шаблоне страницы, которая при обработке запроса заменится на результат выполнения блока. Результат выполнения блока - это всегда HTML код, который генерируется блоком.

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

Разные блоки сайта генерируют разный HTML код в результате своего выполнения (например, блок list_videos генерирует HTML код списка видео, а блок member_profile_view генерирует HTML код профиля пользователя). При подключении блока на какой-либо странице вы имеете 2 опции управления этим блоком на этой странице:

• Параметры конфигурации блока - позволяют вам настроить поведение данного блока на данной странице. Параметры отвечают за то, какие данные будут отображаться блоком, либо какие проверки будут происходить при отправки формы блока пользователем, т.е. они отвечают за логику блока. Например, блок list_videos на странице Index может выводить 50 последних видео, а на странице In Traffic блок list_videos может выводить 100 лучших видео с лучшими по CTR скриншотами. В обоих случаях используется один и тот же тип блока - list_videos - но благодаря разным параметрам конфигурации блок ведет себя по разному на разных страницах. Аналогичным образом по-разному могут вести себя блоки одного типа, находящиеся на одной и той же странице KVS.
• Шаблон блока - позволяет настроить каким образом отображаются данные блока, т.е. транслируют данные блока в HTML код, который вставится на странице KVS. Например, блок list_videos на странице Index может выводить видео по 5 элементов в строке, а на странице In Traffic блок list_videos может выводить видео по 10 на одной строке. Это полностью зависит от шаблона блока.

Добавляя блоки на страницы сайта вы неформально разбиваете страницы на логические участки: здесь будет шапка, там будет 2 списка видео один под другим, в этом углу выпадающий список со всеми моделями отсортированный по популярности и т.д. Каждый логический участок генерируется либо каким-то блоком, либо просто статическим HTML кодом (например, шапка и футер сайта). Страница должна собирать все кусочки вместе, составляя целостную картинку для конечного пользователя, который набрал адрес вашей страницы в браузере.

Отладка страниц сайта

Для того, чтобы заметно упростить разработку и кастомизацию сайта, KVS предоставляет "отладчик" страниц, который может помочь вам быстро и без детального штудирования документации внести как небольшие коррективы в уже заданные шаблоны, так и полностью создавать новые страницы под ваши нужды. Отладчик может быть запущен для любой страницы сайта и что самое главное - отладчик показывает детали и данные именно той страницы, которую вы видите на экране в настоящий момент.

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

Для того, чтобы открыть отладчик страницы сайта, на которой вы в данный момент находитесь, вам необходимо к адресу страницы добавить HTTP параметр debug=true, после чего KVS выведет всю отладочную информацию по данной странице:

http://domain.com/videos/path_to_video/?debug=true

Отладчик отображает следующие отладочные данные:

• На какой странице KVS вы находитесь в данный момент.
• Список всех компонентов страниц (общих шаблонов со статическим HTML кодом), которые используются в шаблоне данной страницы, с возможностью открыть редактирование любого компонента.
• Список всех HTTP параметров, которые передаются на данную страницу.
• Список всех блоков, которые используются на данной странице, с возможностью открыть редактирование любого из них. По каждому блоку отображаются его включенные параметры конфигурации, значения всех переменных $storage данного блока (переменные, которые могут использовать в шаблоне страницы KVS), значения всех локальных переменных данного блока (переменные, которые могут использоваться в шаблоне данного блока).

Как видно из скриншота выше, отладчик отображает реальные значения всех существующих переменных блока на данной конкретной странице. Имя переменной отображается в том виде, в котором эта переменная должна быть вставлена в шаблон (страницы или блока), например для названия видео:

{{$storage.video_view_video_view.title}}

Для итерации по переменной-массиву следует использовать конструкцию {{foreach}}:

{{foreach name=data item=item from=$storage.video_view_video_view.tags}}
    {{* Обращение к элементу массива идет через переменную item *}}
    {{$item.tag_id}}
    {{$item.tag}}
{{/foreach}}

Производительность и нагрузка

Общая информация

Используя KVS, вы можете быть уверены в том, что он сможет держать большое количество трафика на сайте. По нашим наблюдениям KVS со стандартной конфигурацией сайта без проблем работает при суточном трафике в 1.000.000 запросов на сервере средней конфигурации. На некоторых проектах пиковая нагрузка достигает более 3.500.000 запросов в сутки, что позволяет нам говорить о большом запасе производительности в целом.

Основным показателем нагрузки является LA (load average). Это значение показывается в шапке панели администрирования. При нормальной работе сервера LA не должен превышать 3-5 (исключая моменты, когда на этом же сервере конвертится видео, т.к. в эти моменты LA может подниматься выше).

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

• Нагрузка на MySQL. Эта проблема обычно возникает из-за некорректной стратегии кэширования для отдельных страниц и (или) блоков. Чтобы с этим разобраться, достаточно посмотреть на статистику производительности (находится на списке страниц в разделе UI сайта). На основании статистики производительности можно сделать выводы об улучшении стратегии кэширования. Если кэширование выбрано оптимально, но нагрузка на MySQL все равно остается, здесь вам лучше всего связаться со службой поддержки для более глубокого анализа. Если можно оптимизировать блок, который вызывает у вас нагрузку на MySQL - мы это сделаем. Если в общем случае сделать это невозможно, то имеет смысл рассмотреть вариант кастомной поправки, когда из блока будет удален лишний для вас функционал, либо блок будет переписан с учетом специфики использования у вас на сайте, что снизит нагрузку на MySQL этим блоком.
• Нагрузка на винчестер(ы). Эта проблема сложно диагностируемая, но она является основной в случае отсутствия нагрузки на MySQL. Если контент хранится на основном сервере, то очевидное решение - это перенести контент на сторонний сервер (либо сдублировать и включить балансировку отдачи видео).
• Нагрузка конвертацией. Если на вашем основном сервере постоянно происходит конвертация видео - это также будет давать дополнительное увеличение LA по всем фронтам. Чтобы избавиться от такой нагрузки, вы можете вынести конвертацию на сторонний сервер.

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

• Сайт жутко тормозит. Оказалось, что медленная скорость работы была вызвана плохой работой винчестеров.
• Сильная нагрузка на apache. Оказалось, что отдача видео через Nginx была настроена некорректно, в результате чего видео отдавалось через apache.
• Большую часть времени сайт работает с минимальной нагрузкой, несколько раз в сутки происходит сильный скачок нагрузки на apache. Оказалось, что есть проблема на уровне библиотек операционной системы, в результате которой дочерние процессы apache зависали и "съедали" много ресурсов процессора.

Защита от перегрузки

Движок KVS имеет встроенную защиту от перегрузки. У вас может возникнуть резонный вопрос: если в самом движке все хорошо, тогда для чего нужна такая защита? Ответ на этот вопрос прост: для того, чтобы в экстренной ситуации дать возможность вашему серверу "остаться в живых".

По нашим наблюдениям за высоконагруженными проектами при достижении LA значения порядка 250 наступает состояние "клинической смерти" сервера, из которого вывести сервер очень проблематично (в большинстве случаев только ребутом). Чтобы этого избежать, KVS всеми силами старается не допустить поднятия LA до столь высокого уровня, постепенно отключая различные аспекты движка с ростом LA.

Экстренные ситуации роста LA могут возникать по различным причинам, в частности по таким:

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

В ответ на постепенный рост LA, KVS принимает следующие действия:

• При значении LA > 10 останавливается выполнение главного cron-а. Тем самым останавливается обновление всей статистики, обработка фоновых процессов конвертации и другие задачи, выполняемые по расписанию.
• При значении LA > 30 движок отдает только те страницы, которые имеют действующую версию кэша в MemCache. Это значит, что полностью снимается нагрузка с MySQL, которую вызывает отображение страниц сайта. При запросе страниц, у которых в данный момент времени нет версии в кэше, движок делает редирект на файл /overload.html, который находится в корне сайта (если этот файл существует). Вы можете отредактировать контент этого файла по своему усмотрению.
• При значении LA > 50 движок делает редирект на файл /overload.html для всех запросов.

Пороговые значения LA, приведенные выше, могут быть изменены в файле конфигурации /admin/include/setup.php.

Статистика производительности

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

Статистика характеризуется 3 показателями:

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

Плагины

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

Здесь мы сделаем небольшой обзор по всем плагинам KVS:

• Автогенерация категорий. Используется для автогенерации категорий при добавлении новых видео и фотоальбомов на основе полей названия и описания. Категории будут генерироваться только если у видео (фотоальбома) не задано категорий при создании.
• Автогенерация тэгов. Используется для автогенерации тэгов при добавлении новых видео и фотоальбомов на основе полей названия и описания.
• Синонимайзер. Вы можете воспользоваться этим плагином для создания уникальных названий и описаний объектов контента, таких как видео и фотоальбомы. Вам необходимо задать список известных слов и их синонимов. На основе этого списка плагин будет заменять найденные в названии и / или описании объекта слова на случайные синонимы. Словоформы с большим / маленьким регистром будут определяться автоматически, поэтому вам лишь необходимо задать словарь автозамены в маленьком регистре.
• Аудит системы. Плагин аудита осуществляет полную проверку многих жизненноважных аспектов KVS: от проверки необходимых привилегий на различные файлы и папки до полной проверки доступности всего контента. Если вы запустили аудит со всеми опциями и не получили ни одной ошибки - скорее всего ваш проект работает без каких-либо проблем (это, однако, не дает 100% гарантий). Если у вас много видео и / или фотоальбомов, то будьте готовы к тому, что полное сканирование контента может занять несколько часов. Вам не обязательно ждать конца проверки, т.к. проверка происходит на фоне. Вы можете закрыть страницу и вернуться через некоторое время. Результат проверки будет доступен в списке недавних проверок.
• Видео по картинке. Используйте этот плагин для создания видео указанной длительности и качества по загруженной картинке. Плагин создаст MP4 видеофайл, который в течение указанного времени будет показывать загруженную картинку. Такое видео можно использовать, например, в настройках защиты от хотлинка: оно будет отдаваться всем пользователям, для которых сработала защита.
• Внешний поиск. Этот плагин позволит вам использовать внешний API для организации поиска. Вы можете настроить условия, при которых результаты внешнего поиска полностью заменят результаты внутреннего поиска или дополнят его. Используйте этот плагин для поднятия доходов с вашего сайта путем продажи кликов с результатов поиска за относительно большую цену. Свяжитесь со службой поддержки для получения деталей по настройке плагина.
• Генерация аватаров. Плагин генерации аватаров создает аватары категорий на основе видео в этих категориях. Для каждой категории выбирается только одно видео, главный скриншот которого (точнее его исходник) будет использоваться как аватар данной категории. В настройках плагина вы можете выбрать сортировку, которая будет использоваться для поиска главного видео категории. Вы также должны указать строку опций ImageMagick, которая будет использоваться для ресайза исходников скриншотов видео до нужного размера аватаров.
• Исправление базы данных. Этот плагин можно использовать в случаях, когда в таблицах вашей базы данных возникли ошибки, и вам необходимо их исправить.
• Новости KVS. Раз в сутки опрашивает сайт Kernel Video Sharing на наличие новостей и новых версий.
• Очистка кэша шаблонов. Плагин очистки кэша шаблонов подчищает файловый кэш вручную или по расписанию. Этот плагин может также использоваться для получения информации о размере файлового кэша и количества файлов в нем. Файловый кэш используется в KVS повсеместно, но он не может самоочищаться. Со временем работы сайта файловый кэш будет разрастаться и разрастаться. Мы рекомендуем изредка чистить его в ручном режиме. Если же мемберзона вашего сайта используется большим количеством пользователей, то мы рекомендуем настроить очистку кэша по расписанию. Обратите внимание, что при ручном запуске реальный запуск произойдет в течение 5 минут после отправки формы.
• Просмотр весовых матриц ротатора. Вы можете использовать этот плагин для анализа распределения кликов по вашим страницам. Если ротатор поддерживается каким-либо блоком списка (пока это только list_videos), этот блок будет собирать статистику по всем кликам, сделанным на нем. На основе статистики создаются матрицы распределения кликов, которые используются ротатором для определения веса любого конкретного клика. Эта информация может быть полезна вам в качестве определения наиболее кликабельных мест на сайте и т.д.
• Резервное копирование. Используя этот плагин вы можете сделать резервные копии базы данных, системных файлов KVS, а также шаблонов и дизайна сайта.
• Сброс статистики ротатора. Вы можете использовать этот плагин для сброса всех данных ротатора, кроме весовых матриц распределения кликов. Вам необходимо выбрать опции, которые вы хотите сбросить. Фоновая операция может занять некоторое время.

С чего начать...

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

• В системных настройках укажите размеры всех изображений, с которыми будет иметь дело KVS (размеры аватаров и т.д.). Это важно сделать с самого начала, поскольку в последующем изменить размер будет сложно (не происходит автоматическое изменение размера этих изображений).
• Определитесь с необходимостью сохранения исходников видео. Исходники видео могут вам понадобиться, если через некоторое время вы захотите добавить новые форматы видео. Если вы точно знаете, что это вам не нужно - выключите соответствующую опцию в системных настройках (по умолчанию она включена). Если вы не уверены и у вас хватает места на жестком диске - то почему бы и не сохранять исходники на первое время. В любом случае: если опция выключена - то новые форматы будут создаваться на основе уже существующих (правда с некоторой потерей качества), если опция включена и у вас заканчивается свободное место на жестком диске - удалить исходники для некоторых (или сразу всех) видео вы сможете при помощи массового редактирования видео. Таким образом, данная опция является важной при первоначальной настройке, но не критической.
• Определитесь с первоначальным количеством скриншотов и настройте соответствующую опцию в системных настройках. Количество скриншотов у видео не играет большой роли в софте и в дизайне сайта по умолчанию используется только для их прокрутки при наведении мышкой. Если вам необходимо, чтобы у каждого видео было минимум, например, 5 хороших скриншотов, то вам лучше всего поставить начальное количество 8-10. Затем для каждого добавленного видео вы сможете удалить плохие ракурсы, оставив только 5 лучших скриншотов. Если вы не планируете вручную просматривать скриншоты каждого видео - то вам нет необходимости первоначально создавать больше 5 скриншотов, поэтому смело ставьте количество 5.
• Определитесь какие форматы видео вам нужны и настройте их в разделе форматов видео в настройках. Вам не обязательно задавать сразу все форматы, если вы не уверены, понадобятся они вам или нет. В будущем вы сможете всегда добавить новые форматы, и они автоматически создадутся на базе исходников, а при отсутствии исходников - на базе уже существующих форматов. Помните, что форматы видео имеют смысл только для тех типов видео контента, которые хранят свои файлы на вашем сервере. Если вы планируете запускать сайт на хотлинках, embed кодах и/или псевдо-видео - форматы видео вам не нужны.
• Определитесь, нужна ли вам поддержка таймлайновых скриншотов. Если да - то настройте создание таймлайновых скриншотов для нужных форматов видео (обычно это форматы, которые отображаются в плеере). Вам необязательно включать таймлайновые скриншоты сразу: они будут созданы для всех нужных видео как только вы их включите.
• Определитесь, какие форматы скриншотов вам нужны и настройте их в разделе форматов скриншотов в настройках. Новые форматы скриншотов могут быть добавлены в любое время, и будут созданы автоматически. Если вы хотите показывать на сайте скриншоты другого размера, чем настроено в шаблонах по умолчанию - вам будет необходимо исправить CSS-стили и заменить размер в шаблонах. Чтобы быстро заменить существующий размер в шаблонах (например, 240x180) на новый, вы можете воспользоваться функцией поиска по шаблонам в разделе UI сайта панели администрирования. В поле поиска по содержимому вам необходимо ввести "240x180" без ковычек, и вы получите список всех шаблонов, где была найдена такая строка. Далее пройдясь по каждому найденному шаблону замените указанную строку на аналогичную со своим размером.
• Задайте категории, контент провайдеров и моделей, которые будут использоваться для категоризации. Если вы планируете добавлять все видео массово (через массовый импорт, через грабберы или через импорт фидов) - нет необходимости предварительно заполнять категоризацию. KVS создаст все категории, модели и контент провайдеры автоматически исходя из полученных данных. Вам же только нужно будет заполнить детали созданных объектов (загрузить аватары к категориям, добавить описания, указать реф-ссылку на контент провайдера и т.д.). Для удобства на каждом списке в панели администрирования есть возможность отфильтровать объекты по какому-то пустому полю (например, по описанию). Таким образом, в любой момент вы сможете проверить, есть ли какие-то объекты, которые были созданы автоматически и не заполнены деталями.
• Пройдитесь по списку плагинов и решите, какие из плагинов нужно включить. Некоторые плагины (например, автогенерация тэгов) срабатывают только при обработке новых видео и фотоальбомов - это значит что в будущем вы их не сможете использовать для уже созданных объектов.
• Загрузите несколько видео и проверьте, что они были обработаны движком конвертации корректно. Проверьте все созданные форматы видео и скриншотов.
• Проверьте, что у вас включена и работает защита видео контента от хотлинкования. Как проверить - описано выше в главе о защите видео контента. Помните, что защита видео контента не имеет смысла, если видеофайлы не хранятся на вашем сервере.
• Настройте нужные вам опции плеера и embed плеера. Если вы хотите показывать в плеере рекламу, привязанную к спонсорам видео - используйте дополнительные поля контент провайдеров для загрузки рекламных файлов и привязывайте рекламу в плеере к данным полям (настройте адекватные названия полей в разделе кастомизации в настройках, чтобы не путаться между доп. полями). Таким образом, вы сможете получить статистику по всем кликам на рекламу (выходы на контент провайдеров).
• Для настройки платного доступа свяжитесь со службой поддержки.

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

Что делать если...?

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

• На странице старта появилось предупреждение о том, что некоторые фоновые задачи были завершены с ошибками. Перейдите по ссылке из предупреждения на список фоновых задач. В дополнительных действиях задачи, которая была завершена с ошибкой, выберите опцию отображения лога видео. В конце лога вы найдете запись об ошибке. Если ошибка вызвана ffmpeg или imagemagick - сообщите эту информацию администратору. Если исходя из лога вы не можете понять из-за чего возникла ошибка - создайте тикет и скопируйте лог файл полностью.
• Видео находятся в статусе Ошибка. Вам необходимо открыть лог видео, используя соответствующее дополнительное действие данного видео на списке. В конце лога вы найдете запись об ошибке. Если ошибка вызвана ffmpeg или imagemagick - сообщите эту информацию администратору. Если исходя из лога вы не можете понять из-за чего возникла ошибка - создайте тикет и скопируйте лог файл полностью.
• На странице старта появилось предупреждение о том, что последний запуск Cron-а был более 15 минут назад. Вам необходимо немедленно связаться с администратором, т.к. остановка Cron-а это серьезная проблема. У вас остановится обсчет всей статистики, биллингов, плагинов, защиты от перегрузки и других фоновых процессов.
• На странице старта появилось предупреждение о том, что Cron запускается из некорректной папки. Обратитесь к администраторам сервера с просьбой проверить команду запуска Cron-а. Команда должна сначала заходить в папку со скриптом крона (cd /path/to/admin/include), а затем находясь в этой папке вызывать скрипт cron.php.
• На странице старта появилось предупреждение о том, что обнаружены сбои в таблицах базы данных. Перейдите по ссылке из предупреждения на плагин исправления базы данных. По информации плагина вы получите статус всех таблиц базы данных, некоторые из них будут иметь ошибки. Воспользуйтесь плагином для исправления ошибок.
• На странице старта появилось предупреждение о том, что возникли ошибки при проверке серверов хранения. Перейдите по ссылке из предупреждения на список серверов хранения. Там вы можете увидеть детали ошибки. Ошибок может быть несколько:
  (a) Не работает запись в папку хранения. Скорее всего поменялись права файловой системы на папку хранения, указанную в сервере. KVS не сможет использовать данный сервер хранения и будет выдавать ошибки при попытках загрузить видео или других операциях, связанных с серверами хранения.
  (b) Управляющий скрипт не отвечает. Эта ошибка может возникнуть только у удаленных серверов хранения и вызвана тем, что скрипт remote_control.php, который копируется в корень удаленного сервера не доступен или не выполняется корректно. В результате этого видео не будет отдаваться с данного сервера. Вам необходимо убедиться, что при вызове управляющего скрипта вы получаете от него ответ connected.
  (c) Контент не синхронизирован. Эта ошибка возникает в результате постоянной фоновой проверки всех видеофайлов на сервере хранения. Причиной может быть случайное удаление некоторых видеофайлов. Для получения подробной информации об отсутствующих видеофайлах зайдите на плагин аудита и запустите полную проверку контента.
  (d) Время не синхронизировано. Эта ошибка возникает в случае, когда время на удаленном сервере хранения не совпадает с временем главного сервера. Вам необходимо попросить администраторов синхронизировать время между всеми серверами.
  (e) Сервер либо недоступен, либо некорректно настроен. Эта ошибка возникает в результате постоянной фоновой проверки отдачи видео с сервера. KVS выбирает 5 случайных видео, которые хранятся на этом сервере и запрашивает их отдачу. Если во время отдачи хотя бы одного файла возникает проблема - появляется эта ошибка. Для начала вам необходимо в плагине аудита запустить проверку серверов. Если ошибка постоянна - она появится и там. Также вы можете проверить отдачу видео с сервера прямо на списке серверов. Если ошибок нет - это скорее всего говорит о временной проблеме, которая скоро исчезнет сама собой.
• На странице старта появилось предупреждение о том, что возникли ошибки при проверке серверов конвертации. Перейдите по ссылке из предупреждения на список серверов конвертации. Там вы можете увидеть детали ошибки. Ошибок может быть несколько:
  (a) Не работает запись в папку конвертации. Скорее всего поменялись права файловой системы на папку конвертации, указанную в сервере. KVS не сможет использовать данный сервер конвертации и будет выдавать ошибки при попытках загрузить видео или других операциях, связанных с серверами конвертации.
  (b) Скрипт конвертации не работает. Эта ошибка означает, что скрипт remote_cron.php не запускается. KVS будет загружать задачи на данный сервер, но они не будут выполняться до тех пор, пока проблема не будет устранена.
  (c) Последний запуск скрипта конвертации был более 15 минут назад. По каким-то причинам остановился cron на сервере конвертации. KVS будет загружать задачи на данный сервер, но они не будут выполняться до тех пор, пока проблема не будет устранена.
  (d) Пути к некоторым библиотекам не настроены корректно на этом сервере. Эта ошибка сигнализирует о том, что в скрипте remote_cron.php, который находится на сервере конвертации, стоит некорректная ссылка на одну из серверных библиотек, либо эта библиотека перестала работать. Попросите администраторов поправить пути, либо переустановить проблемные библиотеки.
• На странице старта появилось предупреждение о том, что сработала защита от перегрузки. Срабатывание защиты от перегрузки может быть вызвано различными сторонними факторами, поэтому если оно происходит редко - это вполне допустимо. Если зашита срабатывает регулярно, вы можете создать тикет и мы посмотрим, из-за чего может происходить перегрузка сервера. Для того, чтобы снять предупреждение со странице старта, вам необходимо перейти по ссылке на статистику защиты от перегрузки.
• Видео не появляется на сайте. Для того, чтобы видео появилось на сайте оно должно быть в активном статусе и его дата постинга должна быть меньше текущей серверной даты. Проверьте, возможно по дате постинга видео должно появиться чуть позднее. Также, если вы в данный момент не залогинены в панель администрирования или смотрите сайт из другого браузера - вы вероятно видите закэшированную версию сайта. Через некоторое время (как настроено) кэш обновится и видео появится.