Jump to content

KVS 4.0.1 update

Tech Support

Recommended Posts

Update status


4.0.1 update status is FINAL. You can download update in KVS client zone for all your licenses:




Update cost


Starting with KVS 4th generation we would like to change the way we approach to versioning and update policy. Earlier KVS had branches (1.x, 2.x, 3.x) and all updates within a branch were free, but updating to a new branch costed 25% of a new license price for each individual license. Many successful years passed and KVS now has many customers with big number of licenses on their accounts, so updating them all to KVS 4 will mean huge money for them.


As a result we have re-balanced our update policy:

  • With regard to versioning we will not use 'branch' term anymore, all new versions will be of 2 types: major feature updates (e.g. 4.1, 4.2, etc.) and minor bugfixing updates (4.0.1, 4.0.2). Minor versions will be announced as usual, but we won't make them available publicly if no critical bugfixes, they will be available on request only. Changing this approach will let us introduce important bugfixes instantly without considering major version current state.
  • Access to any updates will now cost $100 yearly per customer and it doesn't matter how many licenses you have. Any new Ultimate license purchase will give +1 year of free updates since the day of purchase. Any new other license purchase will give +0.5 year of free updates since the day of purchase.
  • All clients who've purchased a new Ultimate license since 15.01.2017 or any other new license since 15.07.2017 will have free access to 4.0 update. For convenience customer zone was updated with this info.
  • All unused licenses will be using the latest version at any time, they will not be connected to any dates.

Please note that updating to 4.0 would never be free anyway, we are not adding a payment here that never existed before. The 25% policy was there since 2009. However the 3.x branch was being developed for the last 5 years and all updates within it were free, so this policy has never been applied. The new policy makes it much cheaper to apply 4.x update for customers who have many licenses on their accounts, whilst it doesn't affect much those customers who have only 1 license.


Update procedure


Any project starting from 3.0.0 can be updated to 4.0.1 with one only procedure. Depending on your current KVS version update procedure may contain additional steps for older versions.


You must use KVS update plugin in order to update your project. For update you will need:


- KVS update ZIP archive for your project and its hash code for update plugin (contact support in beta phase to get these).

- FTP connection to your project so that you can upload files.


If your project's version is 3.9.0+, the update procedure is standard and nothing special is expected:

  • Create backup using Backup plugin.
  • Upload update ZIP into KVS update plugin and specify hash code.
  • KVS update plugin will notify you if there are any custom changes in KVS system files, which will be overridden by update (player skins are not checked here, so they will be silently updated if have custom changes).
  • KVS update plugin will update database automatically.
  • You will need to copy files from the archive on top of your project using FTP or filesystem copy. Please make sure you are NOT USING sync functionality in your FTP client, which will delete many files on your server, because obviously update archive contains only part of all files. What you need is just to drag and drop files from update archive on top of your project root folder and confirm their re-writing (excluding _INSTALL folder, it doen't need to be copied).
  • KVS update plugin will verify the updated files and finalize update procedure.
  • You can use System audit plugin to verify everything looks good.

If your project's version is before 3.9.0, the update procedure will be difficult and will include cache reset for the whole site (if you have much traffic it can make your project to be unavailable for some time). Also 3.9.0 update can have issues with displaying the new player if conflicting with your design styles, please check this post listing all issues:



Specific to 4.0. After you update your project, audit plugin will show a list of KVS #10 issues, this is planned. Please create a support ticket and specify your domain name and make sure KVS support access is enabled on start page on admin panel. Due to category avatar changes we will need to update your templates to comply with new filesystem structure.


What's new in 4.0.0


You can find explanations and screenshots for the most of new features in this topic:



This topic also contains guides on how to enable some new features that require template changes and thus are not covered by automatic update.


You can see some new features in action on KVS demo website and admin panel:




1) Global enhancements in advertising module:

  • Ability to restrict individual ads to certain devices, browsers and member statuses.
  • Ability to restrict individual ads to be displayed during specific time interval (for example starting on 22:00 and ending on 02:00 every day).
  • Ability to configure advertising start / end datetime with 1 minute precision.
  • Ability to exclude specific advertising from being displayed for certain categories.
  • Advertising spots now allow configuring wrapped HTML code, so that no empty advertising block is displayed when there is nothing to display inside it.
  • Player HTML advertising can now be connected to advertising spots and thus provides easy way to use all the advertising module functionality inside player.
  • Adblock plugin should not prevent saving advertising in KVS admin panel anymore.

2) Many enhancements in conversion module:

  • Video trailer creation optimized, now trailers are created much faster and with less quality loss. Also it is now possible to add crossfade effects to trailers.
  • Moving watermarks are now supported with ability to set speed, direction and any number of positions in seconds and percents for repeat.
  • Ability to switch new videos conversion into 2-phased process: the first phase will only create all required video formats, the second phase will create all high-res formats which are typically declared as conditionally-optional. Thus video will become available faster, no need to wait for all video formats to be created.
  • Added ability to optionally enable screenshot crop settings for manually uploaded screenshots. Previously crop was never used for uploaded screenshots.
  • Background tasks logging was enhanced. Now background task log can show info about all conversion phases and most importantly subtasks and their duration.
  • It is now possible to code a custom PHP script to set up individual crop, rotation or mirroring of a source file for any uploaded video. These options are not exposed for public usage, as they are too specific for most users.
  • KVS will now support uploading audio files directly into MP3 format. In order to use this functionality you should add mp3 extension into list of allowed video extensions in /admin/include/setup.php, and also upload screenshots for every such video.

3) Big set of KVS player enhancements and fixes:

  • Ability to enable auto preload, which gives hint to all devices to start optimistic video buffering before user starts playing.
  • Ability to show related videos on pause (if no pause advertising is configured).
  • Ability to show global video duration in player instead of current format duration. This may be useful for paysites if non-premium users are only able to watch short trailers - then it is better to show full video duration instead of trailer duration.
  • All player HTML advertising is now fully integrated into KVS advertising module.
  • For pre-roll and post-roll advertising the updated skins will show timeline with advertising duration.
  • For pre-roll and post-roll advertising it is now possible to enable VAST from several supported providers.
  • For pre-roll advertising you can now configure so that it is not displayed for every single video, but can skip some videos before next display.
  • In embed player settings you can now set caching interval for embed codes. Previously embed codes were automatically cached up to 24 hours.
  • Fixed wrong behavior of buffer indicator when skipping or switching to another format.
  • Fixed timeline screenshots display issue in some browsers.
  • Fixed full-screen issue in desktop safari.

4) Several important enhancements in KVS storage system:

  • Added support for syncing one storage server from another storage server if they are located in the same storage group. This task is basically required when you move content from one server to another or when you want to duplicate content between several storage servers for load balancing. Previously you could only do that manually, now KVS can do that for you.
  • We extended CDN invalidation API to support additional parameter that describes operation type (add, update or delete). Thus invalidation API will be executed also when new content is added into CDN.
  • You can now disable storage groups, so that they are not used in new content allocation.
  • IP whitelist configured in video anti-hotlink protection settings will now disable all protection levels for the given IPs, including status-based protection.

5) Set of grabber plugin enhancements:

  • Ability to configure command line path to youtube-dl library with all the supported command line options.
  • For grabbers based on youtube-dl KVS will also download video files via youtube-dl, which will allow using aria2 library for multi-threaded downloads without speed limit.
  • For grabbers based on youtube-dl it will be possible to configure proxy servers list if your server's IP gets blocked.
  • All existing grabbers will be switched to youtube-dl soon.

6) Several changes in FTP content upload plugin:

  • Ability to specify video / album description in a separate TXT file.
  • Ability to randomize order in which content will be added.
  • Added display info about duplicates, if detected.

7) Image size settings were enhanced with additional resize type option that will allow now having images with dynamic size (previously it was only possible to have fixed size images for categories, models and etc). Also for categories and members we added 2nd size, so now all images support 2 separate sizes with different resize types. Due to categories avatar migration to a new storage structure it will be needed to modify some code in templates. After update audit plugin will show KVS #10 issue. Please create a support ticket specifying all domains you've updated and make sure that support access is enabled there.


8) KVS now supports internal paid subscriptions for members and channels using tokens. When purchasing a subscription, members will get premium access to all content from the member or channel they are subscribing to, including any content added in the future by this member or into this channel. A subscription can be time-limited or unlimited (configurable by admin). Limited paid subscriptions will be automatically renewed if a member has enough tokens on balance. Otherwise the subscription will expire and member will need to purchase it again to get access. Same as with individual content purchasing, KVS will allow you to set that part of spent tokens are earned by content authors, so that you can have members earning tokens from selling subscriptions to their profiles and channels. In member profile editing and channel editing blocks it is now possible to specify tokens price in tokens_required field.


9) For premium access packages you can now choose whether they are available on signup, upgrade or both. This option can be used for instance to provide some discounts for returning members, while having the full price for new members.


10) Premium access packages can now be purchased with tokens. We added a specific payment processor for handling this named Internal Tokens. So if your site offers free and premium zones, your free members can earn tokens for their activity and then use tokens to purchase access to premium zone.


11) In order to allow accepting payments using different methods, signup and upgrade blocks will now allow displaying access packages from all active payment processors. Thus you can use multiple payment processors at the same time and let users decide which one to use.


12) Members can now be awarded with tokens for logging into memberzone every specific time interval. This can be used to stimulate their activity on your site.


13) In video format settings you will now be able to specify download order for each format you enable download option. Previously the order of download files was not defined.


14) In video format settings you can now limit speed separately for embed code mode. This may reduce your traffic usage and at the same time no need to block embed codes usage.


15) Category and tag auto-selection plugins will now support lenient match for compound tags and categories. This new option will provide better way for languages where word endings vary in different cases. Also will give flexibility in auto-selection handling.


16) Models and content sources now support ranking based on the defined criteria (sorting). You can now display recent rank for each model or content source, and previous rank if changed. Ranking criteria can be set in content settings.


17) In mass editing you can now submit re-creation of multiple video formats at the same time (previously it was only possible to do 1 at a time). Also mass editing now supports access level field.


18) A new interface for videos / albums mass operation added: mass selection. You can use it to select list of videos / albums based on their IDs or URLs and then either filter them, or mass edit them, or delete them.


19) If you use mark video / album as deleted functionality, you can now send notification email right from there. This functionality is typically used to handle DMCA complaints, so sending email with the list of deleted URLs may be useful.


20) When editing videos or albums you can now run category, tag or model auto-selection plugins for them individually. Previously this was only available from mass editing GUI.


21) Exporting feeds can now filter by HD flag. Also you can now choose to simply export 'best' or 'worst' quality for each video instead of specifying direct format name.


22) Admin panel can now search by localized titles / descriptions / directories in all objects that support localization.


23) Website UI section now features version control system, which monitors all changes in theme templates, styles and JS files. This will allow you to rollback any specific change at any time, or restore original version if you have done something wrong. It can also be used with online text compare sites to find what has been changed in a specific version.


24) In website settings it will now be possible to configure that content with 'in process' or 'error' statuses is displayed via direct links. Previously such content would never be displayed. This feature is extremely useful for websites that offer video hosting functionality, users can upload their videos and immediately get embed codes that are not returning 404 error. Please note that you will need to update templates so that such cases display reasonable message, otherwise in most of the themes they will display no access error message.


25) In stats settings for search stats you can now configure max query length and blacklist symbols, which will prevent queries that do not match these filters to be added to your stats. This is needed to prevent some not nice queries to be later displayed on your site.


26) KVS website engine will now be able to produce minified HTML, however this option will not be available in public settings and can only be enabled via /admin/include/setup.php configuration. HTML minification produces single line HTML code without line breaks, however it will result in textareas not functioning correctly (all multi-lined content displayed in a textarea will be wrapped, e.g. video description editing will wrap multi-lined description); and also if you have some inline JS / CSS code without ending semicolon, this will break its syntax. Use at your own risk if needed.


27) In website settings for dynamic HTTP parameters you can now configure their cookie lifetime. Before that their lifetime was forced to 365 days. These are typically used to pass affiliate refs to your site.


28) In content settings it is now possible to configure access to file upload functions. Previously file upload function was available publicly (some sites may need anonymous upload), but now you can only allow it for registered members or admins only. For remote URL uploads you can also set a max filesize limit.


29) In this update we changed the way how tags are added in admin panel. Previously you could only mass add tags in plain list, but now you can mass add tags together with their synonyms; also you can use the same approach to add new synonyms to existing tags.


30) Video player in admin panel editing video page will now allow switching between all video formats, if there are multiple. Previously it would show the biggest size format, which is not always convenient.


31) A very important logical change for webmasters access level. Webmasters will no more have the same access level as premium members, they will have standard access level instead.


32) When overload protection gets triggered for a page, KVS will return 503 status with rendering overload.html contents instead of doing redirect as before.


33) Changed the way how text search behavior works when finding only 1 result (only 1 video, 1 album and etc). Earlier KVS would automatically redirect to this result page by default. After the update, redirect will not happen by default and KVS will simply display search results page with 1 video or 1 album. If you want to have redirect as before, you should use search_redirect_enabled parameter in the corresponding list_xxx block in your theme.


34) Tags list (list_tags) and tags cloud (tags_cloud) blocks now support displaying tags from any objects and not only from videos or albums. KVS also supports tags in models, content sources, posts, channels and playlists.


35) Added a new parameter show_stats to video view (video_view) and album view (album_view) blocks. You can use this parameter to force a block make an additional query and select video or album views stats for the last N days. These stats can be used to show video / album popularity graph for the given time period (the number of days KVS keeps these stats is defined in stats settings).


36) Categories list block (list_categories) can now show list of related categories, e.g. categories from the same group. In order to enable this the new parameters var_category_id / var_category_dir were added, which expect category ID or directory to be passed in URL.


37) Search queries list block (search_results) can now display search queries similar to the given category or tag (e.g. search queries that are using this category or tag). In order to enable this the new parameters var_category_id / var_category_dir / var_tag_id / var_tag_dir were added, which expect category / tag ID or directory to be passed in URL.


38) Posts lists block (list_posts) now supports filtering by custom fields.


39) It will now be possible to display future or upcoming videos / albums. In order to do that you use the new mode_futures block parameter in list_videos / list_albums block. This option is extremely useful for paysites to show the upcoming updates.


40) Bugs that have been fixed:

  • Many player logic and skin fixes (described above).
  • In some cases Epoch processor would close access before the end of period.
  • Domains, that were blacklisted for signup emails would not blacklist subdomains as well.
  • Backup plugin was optimized for satellites.
  • Critical vulnerability that we've sent patch on November 20th.
  • Random video / album redirect was cached for 1 minute and redirected to the same video / album during the whole minute.
  • When using external search plugin KVS would not return 404 error for non-existing pages in search pagination.
  • A dozen of other small usability / stability improvements.

What's new in 4.0.1


4.0.1 is a bugfixing update for 4.0.1, though we put some small new features there. Those who already updated to 4.0.0 during first beta phase or had initially 4.0.0 installed, it is recommended to update to 4.0.1 only if you feel the new features or fixes are affecting you. Since 4.0.0 is still in beta, we expect more issues to be found as more projects will be updated, and thus 4.0.2 will be available within the next 30 days. If not, we will make 4.0.1 publicly available in March.


1) Several player enhancements:

  • It will now be possible to use 3rd-party VAST providers for a subscription. At the moment subscription will be free for beta testing period.
  • Advertising would not disappear anymore after being clicked.
  • Enhanced adblock player feature. Now you can configure the amount of time in seconds that adblock user will be allowed to watch. After that player will emulate crash with showing your predefined HTML code instead.
  • Added support for inline playback on Iphones, which will also allow showing pre-roll advertising on Iphone devices.
  • Fixed mute button behavior on mobile devices. Previously it was not displayed for mobile devices.

2) In videos export and exporting feeds it will now be possible to format duration in HH:MM:SS format.


3) Comments list block (list_comments) will support additional mode to display comments to the whole user's content.


4) Channels list block (list_dvds) will support a new mode that allows listing channels available for upload to the given user based on their privacy settings.


5) Several new modes were added for mixed videos and albums list block (list_content). They will allow to display uploaded content, purchased content and content from subscriptions of a given user.


6) Bugs that have been fixed:

  • In some cases moving watermark was not applied to videos.


Link to comment
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

  • Create New...