Version 4.5 is probably the last completely free major release. Some advanced features will be converted to premium add-ons in the future. More info in the support forum.
A plugin for the WordPress visual editor to make embedding videos, generating thumbnails, and encoding HTML5-compliant files a little bit easier.
- Upload the entire video-embed-thumbnail-generator folder to the /wp-content/plugins/ directory.
- Activate the plugin through the ‘Plugins’ menu in WordPress.
- Make sure you have all your MIME types configured correctly. Many servers don’t have .mp4, .m4v, .ogv configured, and even more don’t have .webm. There are a number of ways to do this. In your public_html directory you can edit your .htaccess file and add the following lines:
AddType video/ogg .ogv
AddType video/mp4 .mp4
AddType video/mp4 .m4v
AddType video/webm .webm
AddType video/mp4 .mov
will help with IE playback of .mov files but could interfere with other QuickTime players.
Or use your web host’s configuration panel (cpanel, etc) to add custom MIME types.
Just click the Add Media button to get started:
This plugin adds several fields to any video uploaded to the WordPress Media Library. Just choose a few options, make thumbnails, click “Insert into Post” and you’ll get a shortcode in the post editor that will embed a flexible, responsive HTML5 video player with Flash fallback for unsupported browsers.
[KGVID poster="http://www.kylegilman.net/wp-content/uploads/2013/05/Marriage-Ref-Frozen-Tundra-Promo_thumb131.jpg" width="730" height="410"]http://www.kylegilman.net/wp-content/uploads/2006/09/Reel-2012-05-15-720.mp4[/KGVID]
[KGVID gallery="true" gallery_include="2596,2750,2721,2719,2634,2591" gallery_orderby="rand" gallery_thumb="226"][/KGVID]
Cheech and Chong — Lets Make a Dope Deal
Marriage Ref - Frozen Tundra Promo
You have the option to use a few different video players:
- The WordPress default player using MediaElement.js, which was introduced in WordPress version 3.6
- JW Player (if their plugin is installed)
- Adobe’s Strobe Media Playback Flash player.
The Strobe Media Playback option hasn’t been updated since 2011 and is not recommended, but I’m keeping it around for longtime users of this plugin who don’t want to change. Most features of the plugin will work when using Strobe Media Playback, but new features will not be tested with it. Selecting Strobe Media Playback will default to a Flash video player if you’re using a Flash-compatible file (flv, f4v, mp4, mov, or m4v). Otherwise it will use the Video.js player as a fallback.
No matter which player you use, the video will responsively resize to fit the container it’s in. There is no need to use FitVids.js and in fact FitVids.js will break playback for some players. If you provide multiple H.264 resolutions, the Video.js player can automatically select the one closest to the size of the player and provide a button for users to select the resolution manually. Because the player uses native controls on mobile devices, the manual resolution button is only available on desktop browsers.
You can also use the plugin to create a popup video gallery. The shortcode uses options similar to the WordPress image gallery shortcode. In its simplest form use the code [KGVID gallery="true"] to create a gallery of all videos attached to the post. Thumbnail size and video popup size can be set on the plugin settings page or in the shortcode. To make a custom gallery that includes videos that aren't attached to the current post you'll need to determine the video's ID, which is shown under the Video Stats section when viewing the attachment. Switch the "insert" option from "Single Video" to "Video Gallery" and you'll get a number of additional options (all of which are optional). Add a comma-separated list of video IDs in the "Include" field to create a gallery manually. Note: the "Create Gallery" section of the Add Media window is a built-in WordPress function and is only for making image galleries.
If your video can be played natively in your browser, or if you have FFMPEG or LIBAV installed on your server, you can generate thumbnails from your video. Using either the "Generate" or "Randomize" buttons will create an array to choose from. The "Generate" button will always generate thumbnails from the same frames of your video, evenly spaced. If you don't like them, you can randomize the results with the "Randomize" button. If you want to see the first frame of the video, check the "Force 1st Frame Thumbnail" button. After creating an array of thumbnails you can save them all using the "Save all thumbnails" button.
If you know which frame you want to use for your thumbnail, click "Choose from video..." to select it from the video. This will only work for videos that can be played natively in your browser. If you want really fine control you can enter timecode in the "Thumbnail timecode" field. Use
mm:ss format. Use decimals to approximate frames. For example,
23.5 will generate a thumbnail halfway between the 23rd and 24th seconds in the video.
02:23.25 would be one quarter of the way between the 143rd and 144th seconds. You can generate as many or as few as you need (up to 99 at a time).
After you select a thumbnail it will be registered in the WordPress Media Library and added to the video's attachments. Unused thumbnails will be deleted.
In the plugin settings you can set the default maximum video width and height based on the dimensions of your particular template and those values will be filled in when you open the window. If you generate thumbnails, the video display dimensions will be adjusted automatically to match the size and aspect ratio of the video file. You can make further adjustments if you want. There are options to always fill the width of the template or to always set videos to the maximum width setting regardless of their resolution.
You can add subtitle and caption tracks by choosing properly formatted WebVTT files from the media library or entering a URL directly. Enter the two-letter language code and the label text that will be shown to users. Enabling the "default" option will turn the text track on when the page loads. The WordPress default player does not differentiate between captions and subtitles, but Video.js will show a different icon depending on the selection.
I highly recommend using Handbrake to make a file with H.264 video and AAC audio in an MP4 container before uploading. If you're encoding with Handbrake make sure that "Web Optimized" is checked. Using Apple's Compressor, the "Streaming" setting should be "Fast Start" (not Fast Start - Compressed Header).
The plugin can use FFMPEG or LIBAV to encode videos and make thumbnails if you have one of them installed on your server. You can choose to generate thumbnails and additional video formats automatically whenever a new video is uploaded to the media library, and there are buttons to generate thumbnails and additional video formats for every video already in the media library.
By default the plugin looks for FFMPEG in
/usr/local/bin but if the application is installed in a different place on your server, you can point it to the correct place in the plugin settings. Users running WordPress on Windows servers should try using Linux-style paths (with forward slashes instead of backslashes and a forward slash / instead of C:\). Multisite Super Admins must set the FFMPEG path in the Network settings page which will enable FFMPEG throughout the network.
If you have the proper libraries installed on your server, you can choose to replace your uploaded video with your preferred format, and generate as many as seven additional formats depending on your original source. 1080p, 720p, and 360p H.264, same resolution WEBM (VP9 or VP8) and OGV, and a custom format. Different browsers have different playback capabilities. Most desktop browsers can play H.264, and all modern mobile devices can play at least 360p H.264. If you create multiple H.264 resolutions, the highest resolution supported by the device will be served up automatically. The plugin will not upconvert your video, so if you upload a 720p video, it will not waste your time creating a 1080p version. There was a time when it seemed like a good idea to provide OGV or WEBM for some desktop browsers, but Firefox supports native H.264 playback in most operating systems now. I no longer recommend encoding OGV or WEBM unless you're making an open source principled stand against H.264. However, your needs may vary. VP9 WEBM is a next-generation codec not supported by many browsers, but it can make videos much smaller while still retaining quality.
The files will encode in the background and will take some time to complete, depending on your server setup and the length and size of your video. VP9 encoding will take much longer than any other format. The plugin adds a Video Encode Queue menu to the Tools menu. You will see encoding progress, the option to cancel an encoding job, and you should get an error message if something goes wrong. Users on Windows servers may get inconsistent results with the encoding queue.
Encoded H.264 files can be fixed for streaming using "movflags faststart" introduced in recent versions of FFMPEG/LIBAV, or qt-faststart or MP4Box if you have one of them installed on your server and select it in the plugin settings. Without one of these options enabled, FFMPEG/LIBAV will place moov atoms at the end of H.264 encoded files, which in some cases forces the entire file to download before playback can start.
If you want to make OGV, WEBM, or H.264 files available and can't use the FFMPEG encode button, you can upload your own files to the same directory as the original and the plugin will automatically find them. For example, if your main file is awesomevid.mp4, the plugin will look for awesomevid-1080.mp4, awesomevid-720.mp4, awesomevid-360.mp4, awesomevid.webm, awesomevid-vp9.webm, awesomevid.ogv, and awesomevid-custom.mp4 as well. If your videos don't conform to that naming structure, you can manually assign them from the media library. No matter what format your original video is, you can use it in the shortcode and the plugin will attempt to find all compatible formats related to it. For example, you might have an AVI called awesomevid.avi which is not compatible with any browser, but if you have other formats encoded already, [KGVID]http://yoursite.com/awesomevid.avi[/KGVID] will ignore the incompatible AVI file, but find those other formats and embed them.
If you want to make it easier for users to save your videos to their computers, you can choose to include a link by checking the "Generate Download Link Below Video" button.
Sometimes for various reasons you might need to embed video files that are not saved in the WordPress Media Library. Maybe your file is too large to upload through the media upload form (if it is, I suggest the excellent "Add From Server" plugin), or maybe it's hosted on another server. Either way, you can use the tab "Embed Video From URL" in the Add Media window. Just enter the Video URL manually, and all other steps are the same as the Media Library options. The plugin will look for alternate encoded files in the same directory as the original, but this takes a long time when the video is on another server so it will only check for them once.
Once you've filled in all your options, click "Insert into Post" and you'll get a shortcode in the visual editor like this
To embed videos on other sites you can use an iframe like this
<iframe src='http://www.kylegilman.net/?attachment_id=2897&kgvid_video_embed[enable]=true' frameborder='0' scrolling='no' width='640' height='360'></iframe>
If you enable oEmbed provider data in the plugin settings, the URL of a post with a video shortcode in it or the URL of the video's attachment page will be converted to an embedded video on sites that allow oEmbed discovery. For example,
http://www.kylegilman.net/2011/01/18/video-embed-thumbnail-generator-wordpress-plugin/ is the URL for this plugin on my website, but it has the oEmbed header for the video embedded in it so the URL will be converted to an embedded video on sites with oEmbed discovery enabled. WordPress limits oEmbed providers to an internal whitelist for security reasons. This plugin has an option to enable oEmbed discovery for users with the unfiltered_html capability.
If you want to further modify the way the video player works, you can add the following options inside the KGVID tag. These will override anything you've set in the plugin settings
id="xxx" video attachment ID (instead of using a URL).
videos="x" number of attached videos to display if no URL or id is given.
orderby="menu_order/title/post_date/rand/ID" criteria for sorting attached videos if no URL or ID is given.
order="ASC/DESC" sort order.
poster="http://www.example.com/image.jpg" sets the thumbnail.
endofvideooverlay="http://www.example.com/end_image.jpg" sets the image shown when the video ends.
inline="true/false" allow other content on the same line as the video
volume="0.x" pre-sets the volume for unusually loud videos. Value between 0 and 1.
mute="true/false" sets the mute button on or off.
controlbar="docked/floating/none" sets the controlbar position. Video.js only responds to the "none" option.
"false" to disable.
"false" to disable. If this is set, it will override the
title="Video Title" or
embedcode="html code" changes text displayed in the embed code overlay in order to provide a custom method for embedding a video or "false" to disable.
view_count="true/false" turns the view count on or off.
description="Description" Used for metadata only.
downloadlink="true/false" generates a link below the video to make it easier for users to save the video file to their computers.
right_click="true/false" allow or disable right-clicking on the video player.
resize="true/false" allow or disable responsive resizing.
auto_res="automatic/highest/lowest" let the plugin select the best resolution for the size of the player.
These options will add a subtitle/caption track
track_src="http://www.example.com/subtitles.vtt_.txt" URL of the WebVTT file.
track_srclang=xx the track's two-character language code (en, fr, es, etc)
track_label="Track Label" text that will be shown to the user when selecting the track.
track_default="true/false" track is enabled by default.
These options will only affect Video.js playback
skin="example-css-class" Completely change the look of the video player. Instructions here.
These options will only affect Flash playback in Strobe Media Playback video elements. They will have no effect on HTML5 or Video.js playback.
autohide="true/false" specify whether to autohide the control bar after a few seconds.
playbutton="true/false" turns the big play button overlay in the middle of the video on or off.
streamtype="live/recorded/DVR" I honestly don't know what this is for.
scalemode="letterbox/none/stretch/zoom" If the video display size isn't the same as the video file, this determines how the video will be scaled.
backgroundcolor="#rrggbb" set the background color to whatever hex code you want.
configuration="http://www.example.com/config.xml" Lets you specify all these flashvars in an XML file.
skin="http://www.example.com/skin.xml" Completely change the look of the video player. Instructions here.
These options are available for video galleries (options work the same as standard WordPress image galleries)
gallery_thumb="xxx" width in pixels to display gallery thumbnails.
gallery_exclude="15" comma separated video attachment IDs. Excludes the videos from the gallery.
gallery_include="65" comma separated video attachment IDs. Includes only these videos in the gallery. Please note that include and exclude cannot be used together.
gallery_orderby="menu_order/title/post_date/rand/ID" criteria for sorting the gallery.
gallery_order="ASC/DESC" sort order.
gallery_id="241" post ID to display a gallery made up of videos associated with a different post.
gallery_end="close/next" either close the pop-up or start playing the next video when the current video finishes playing.
"false" to disable pagination. Number of video thumbnails to show on each gallery page.
gallery_title="true/false" display the title overlay on gallery thumbnails.
[KGVID autohide="false" loop="true" autoplay="true" poster="http://www.kylegilman.net/wp-content/uploads/2011/10/Reel-11-10-10-web_thumb2.jpg" width="720" height="404"]http://www.kylegilman.net/wp-content/uploads/2006/09/Reel-2012-05-15-h264.mp4[/KGVID]
I'm not really a software developer. I'm just a film editor with some time on his hands who wanted to post video for clients and wasn't happy with the current state of any available software. But I want to really make this thing work, so please help me out by posting your feedback on Github or my WordPress support forum. I do not offer free email support.
Why doesn't my video play?
Most of the time your video doesn't play because it's not encoded in the right format. Videos have containers like mp4, mov, ogv, mkv, flv, etc and within those containers there are video and audio codecs like H.264, MPEG-4, VP8, etc. The best option for this plugin is an mp4 container with H.264 video and AAC audio. It's confusing, but there is a codec usually identified simply as "MPEG-4" of "MPEG-4 Visual" which is not the same thing as H.264 even if it's in an mp4 container. mp4s with MPEG-4 video will not play in most browsers, and if you don't use AAC audio you won't get any audio. I highly recommend using Handbrake to make a file with H.264 video and AAC audio in an MP4 container.
Use MediaInfo to get really detailed information about your media files.
If your theme loads FitVids.js, it will break playback in Firefox. If you can figure out how to prevent your theme from loading FitVids.js you will not miss it.
Why does my video have to download completely before it starts playing?
mp4/m4v/mov files have something called a moov atom that gives the video player information about the content of the video (dimensions, duration, codecs, etc). Depending on the program you used to make your video, the moov atom can be at the beginning or the end of the file. Most video players will wait until they find the moov atom before starting playback. Otherwise it doesn't know how to display the information it's downloading. If it's at the beginning of the file, playback starts very soon after the user hits the play button. If it's at the end of the file, the whole video has to download before playback starts.
There are a number of ways to fix this problem. Most video encoding programs have an option like "Web optimized," "Streaming," "Fast start," or "Progressive download." Try to find and enable that option in your program. If you can't do that, there are programs designed to move the moov atom to the head of the file. Try QTIndexSwapperfor Adobe Air (cross platform), MP4 Faststart for Windows, or QTFastStart for Mac.
FFMPEG puts the moov atom at the end of the file, so this can be a problem. The plugin will fix this problem on newly encoded H.264 videos if you have a recent version of FFMPEG and enable the "movflags faststart" option in the plugin settings or if you have qt-faststart or MP4Box installed on your server.
Why doesn't this work with YouTube?
WordPress already has a built-in system for embedding videos from YouTube, Vimeo, Dailymotion, etc. Just put the URL into your post and WordPress will automatically convert it to an embedded video using oEmbed. You don't need this plugin to do that. If you're trying to generate new thumbnails from YouTube videos, I'm not going to risk Google's wrath by providing that functionality. I'm not even sure I could figure out how to do it anyway.
If you just want to change the skin or thumbnail of a YouTube video, use JW Player.
I'm getting an error message "FFMPEG not found at /usr/local/bin/. You can embed existing videos, but video thumbnail generation and Mobile/HTML5 video encoding is not possible without FFMPEG."
First off, don't panic.
This plugin can use FFMPEG or LIBAV to make thumbnails and create alternate video formats. Unfortunately most servers don't have FFMPEG installed and most shared hosting plans don't allow you to install FFMPEG because of the system resources it requires. You're getting this error message because you don't have FFMPEG installed in the most common directory. If you know you have FFMPEG installed on your server, you'll need to find the actual path to the program and enter it in the plugin settings field
Path to applications on server
How can I encode videos in directories protected by .htaccess passwords?
Enter the username & password in the plugin settings "FFMPEG Settings" tab, or use the "Embed from URL" tab and enter the URL in this format http://username:[email protected]/uploads/2012/01/awesomevid.mp4 in the Video URL field.
4.5.5 - August 20, 2015
- Fixed a number of potential infinite loops and other recursion issues related to longstanding WordPress bug #17817.
4.5.4 - August 9, 2015
- Added option to disable native controls on mobile devices when using the Video.js player.
- Added Schema.org uploadDate and description tags which are required by Google for video listings.
- Updated Video.js to version 4.12.11
- Fixed undefined index error when editing videos with text tracks that don't have default enabled.
- Fixed and localized "Saving..." overlay when saving browser-generated thumbnails.
- Fixed bug that could generate an error when displaying the sample video on the plugin settings page.
4.5.3 - July 11, 2015
- Fixed error that could zero out view counts when editing videos.
- Fixed 'strlen' error when updating videos with subtitles.
- Attempting to enable 'default' subtitle tracks on more browsers, but implementation is inconsistent.
4.5.2 - July 10, 2015
- Fixed bug that failed to set the volume or count views when using the WordPress Default or JW Player.
- Fixed bug that failed to count views when WordPress Default player was on autoplay.
- Fixed Video.js inconsistent autoplay bug.
4.5.1 - July 9, 2015
- Fixed bug that accidentally deleted thumbnail image IDs from video meta when editing attachments.
- Prevented automatic re-writing of video URLs to a local address if a popular cloud storage address is entered in the shortcode (Amazon AWS, Rackspace, etc).
- Restored full-resolution thumbnails when width is set to a percentage.
4.5 - July 7, 2015
- This is probably the last completely free major release. Some advanced features will be converted to premium add-ons in the future. More info in the support forum.
- Consolidated most video metadata database entries into a single array. This might slow things down the first time you load the Media Library.
- Added pagination option for video galleries.
- Added oEmbed provider data and option to allow oEmbed discovery from other sites.
- Added experimental WEBM VP9 encoding format.
- Added option to make the watermark overlay image a link.
- Added video stats column to Media Library list view.
- Added options for vertical video rotation and metadata removal using FFMPEG, now that some browsers recognize rotation metadata.
- Added "default" attribute for subtitle/caption text tracks to turn tracks on when the video loads.
- Added attachment edit hook that updates video thumbnail's parent post when the video's parent post changes.
- Added error handling and reporting for in-browser thumbnails.
- Added Video.js localization. Automatically changes Video.js language to the current WordPress language.
- Updated Video.js to version 4.12.7
- Updated Spanish translation.
- Updated Facebook Open Graph video embedding tags.
- Re-enabled native video player controls on mobile devices when using Video.js player for better responsive resizing and to allow Airplay & Chromecast controls.
- Removed superfluous gallery height option.
- Stopped inserting unnecessary width and height shortcode attributes when videos are set to the default width and height.
- Stopped inserting unnecessary poster URL shortcode attribute when poster is set in the media library.
- Fixed several bugs related to hosting media library files on external servers like Amazon S3.
- Fixed bug that deleted replacement videos before encoding was finished when simultaneous encodes are enabled.
- Fixed bug that dropped videos from the video encode queue when multiple videos were added to the database simultaneously, specifically when using Add From Server.
- Fixed bug that created squashed encoded videos when they were shot vertically on a mobile device.
- Fixed bug that added bad content to Open Graph video tag when other shortcodes were found before KGVID in the post.
- Fixed bug that wrote multiple unnecessary meta entries to the database when image attachments were updated.
- Fixed bug that disabled "Choose from Library" buttons in Firefox.
- Fixed bug that incorrectly indicated thumbnail selection video files did not load in Firefox.
- Fixed bug that allowed video thumbnails to overflow their container in the Media Library modal window in Firefox.
- Fixed bug that allowed crossdomain in-browser thumbnails to load, but then fail when trying to save them in Safari.
- Fixed bug that kept end of video overlay images on screen when user hit play again.
- Fixed bug that incorrectly resized videos embedded through iframe.
- Fixed bug that did not assign a default value to the qt-faststart/MP4Box application path for new installations.
- Fixed bug that allowed selection of multiple thumbnails in Embed Video from URL window
- Fixed number formatting of video play counter.
- Fixed encode queue text indent bug.
4.4.2 - November 3, 2014
- Added Google Universal Analytics event tracking.
- Updated Spanish, French and Belgian translations.
- Updated Video.js to version 4.10.2
- Fixed bug that could prevent the media library from loading.
- Fixed bug that prevented pop-up gallery thumbnails from resizing responsively.
4.4.1 - October 28, 2014
- Fixed bug that loaded resolution selector plugin too late in the page.
- Fixed bug that displayed the video poster image while switching resolutions.
4.4 - October 28, 2014
- Added H.264 HTML5 video resolution switcher for the Video.js player. Automatically selects the appropriate resolution for the size of the displayed video and allows manual user switching on desktop computers.
- Added option to set videos to automatically fill their containers.
- Added buttons to manually set other videos in the media library as alternate formats for the current video.
- Added option to encode a custom resolution.
- Added option to replace original video with a lower-resolution H.264 video, WEBM or OGV.
- Added buttons to generate thumbnails and encode additional formats for all previously uploaded videos.
- Added plugin admin scripts to the frontend when Insert Media button is loaded. Works with bbPress now.
- Added option to encode 64 and 32 kbps audio.
- Added option to set a different application path for qt-faststart or MP4Box.
- Added option to disable stdin during FFMPEG encoding. Particularly useful for IIS users.
- Updated Video.js to version 4.9.1
- Changed download link to a forced download for videos in the media library. No right-clicking necessary.
- Changed pop-up video gallery to use inline code rather than an AJAX query.
- Changed embedded video IDs to allow the same video to be embedded multiple times on a page.
- Changed volume slider on plugin settings page to drop-down menu to fix settings save errors in Windows.
- Changed 480p video format label to 360p to accurately reflect resolution of 16:9 videos. Format has always been 480p only for 4:3 videos.
- Changed AAC encoder preference to libfdk_aac > libfaac > Native FFmpeg AAC encoder (aac) > libvo_aacenc.
- Restored display of moov atom fix process in FFMPEG test output.
- Fixed bug that made pop-up video windows 0 pixels wide in iOS 8.
- Fixed bug that couldn't find video attachements that have been redirected to a CDN.
- Fixed bug that quickly faded out the end overlay image in IE.
- Fixed bug that prevented replacing encoded videos if there were any other videos in the queue.
- Fixed bug that left the GUID as the original filename if replacing the video with an mp4 changed the extension.
- Fixed bug that incorrectly reported all encoding fps values over 99 as "10".
- Fixed bug that didn't recognize videos had completed encoding if there were audio frames left in the queue.
- Fixed bug that left title overlay on iOS videos using the WordPress Default player.
- Fixed bug that made video galleries display as inline-block when the inline video option was disabled.
4.3.5 - September 17, 2014
- Fixed responsive height for videos using WordPress Default player.
- Better fix for bug that prevented choosing thumbnails from the small video player in the new media library popup window in WordPress 4.0.
4.3.4 - September 10, 2014
- Updated Video.js to version 4.8.1
- Added default gallery end option to play the next video or close the popup window.
- Restored watermark overlay in fullscreen for Video.js and WordPress Default players.
- Restored browser thumbnail generation quality in WordPress 4.0.
- Fixed bug that prevented choosing thumbnails from the small video player in the new media library popup window in WordPress 4.0.
- Removed instances in which a video or watermark in the WordPress database would be input to FFMPEG through http instead of using the file path. Should fix some I/O errors, particularly with SSL.
- Now setting the thumbnail as the featured image for the video attachment regardless of plugin settings.
4.3.3 - July 20, 2014
- Changed .mov files back to type "video/mp4" to fix "No compatible source was found for this video" errors.
- Added "mute" shortcode attribute.
- Added default volume and mute options.
- Added option to set custom default shortcode attributes.
- Fixed WordPress default player alternate H.264 sources.
- Fixed WordPress default player volume and preload settings.
- Fixed Video.js volume slider appearance when using the custom skin.
- Disabled JW Player custom context menu when right-clicking is disabled.
4.3.2 - July 15, 2014
- Updated Video.js to version 4.6.4
- Added Spanish, French, and Bulgarian translations.
- Added ability to send advanced configuration attributes to JW Player. Any attributes added to the shortcode will be passed on without change.
- Added multisite option to restrict FFMPEG settings access to super admins only.
- Added better error reporting when FFMPEG isn't executing.
- Added subtitles/captions fields to "Embed Video from URL" tab.
- Added allowfullscreen to iframe embed codes.
- Added fitvidsignore class to Video.js videos to help defeat FitVids.js-induced playback problems.
- Added contentUrl schema.org metadata.
- Fixed some gettext calls for translation.
- Fixed bug that set alternate resolution H.264 videos to type "video/h264" instead of "video/mp4".
- Fixed bug that incorrectly added "Other user's video" to video encode queue entries.
- Fixed missing help icons on settings pages.
- Fixed bug that disabled aspect ratio locking in the "Embed Video from URL" tab.
4.3.1 - April 8, 2014
- Fixed errors when activating plugin for the first time and saving settings page in non-multisite installations.
- Updated Video.js to version 4.5.1
- Fixed pop-up gallery cross-origin bug for users with FORCE_SSL_ADMIN enabled.
- Fixed error on network settings page when pressing the "Save Changes" button and resetting network settings using "Reset Options" button.
- Added text-align:left to left-aligned galleries.
- Added gettext calls to some text for translation.
- Removed duplicate bitrate setting for WEBM encoding when using average bitrate.
4.3 - March 18, 2014
- Prepared plugin for internationalization. Translators welcome!
- Finally paying attention to multisite. Several FFMPEG settings and the encode queue are now controlled at the network level if the plugin is network activated.
- Added JW Player option if the JW Player WordPress plugin is active.
- Added video subtitle/captions support.
- Revised and simplified video gallery popup method. Switched to lighter SimpleModal plugin and no longer loading jQuery-ui libraries.
- Added "gallery_ended" shortcode attribute to set an action when a pop-up video gallery video ends.
- Added next and previous buttons to navigate between pop-up video gallery items.
- Updated Video.js to version 4.4.3
- Strobe Media Playback is now deprecated. New features added to the plugin might not work if this player is selected.
- Added option to add a watermark to videos encoded with FFMPEG/LIBAV.
- Added option to automatically generate multiple thumbnails when a video is uploaded.
- Added option to encode more than one video at the same time.
- Added option to turn on video download link by default.
- Added option to set video preload attribute.
- Added list of shortcode attribute options to the post edit help tab.
- Added "order" and "orderby" shortcode attributes to sort videos embedded without a URL or ID specified.
- Added float to inline videos to allow text to wrap around them.
- Added play button overlay to gallery thumbnails when using WordPress Default player.
- Applied video alignment setting to video galleries for center and right justifying galleries.
- Added wpdb->prepare to all database queries for increased security.
- Added nonce check when recording video play counts for increased security.
- Fixed bug that broke responsive resizing in IE 8 and for all videos with apostrophes in their titles.
- Fixed bug that disabled FFMPEG if the path to WordPress had spaces in it.
- Fixed bug that generated an error if the exec function was disabled on the server using suhosin or safe mode.
- Fixed bug that caused video encode problems when FFMPEG output contained special characters.
- Fixed bug that generated misaligned play button arrows in some themes when using the Video.js player.
- Fixed bug that sometimes generated jagged rows in galleries with mixed aspect ratios.
- Fixed bug that attempted to generate thumbnails using FFMPEG if a user had previously installed FFMPEG, disabled in-browser thumbnails, then disabled FFMPEG.
- Fixed several user capability related bugs related to users who were not assigned any roles and capabilities that were not assigned to any roles.
- Changed video title overlay z-index to 103 to avoid floating over other elements.
4.2.9 — November 15, 2013
- Fixed bug that interfered with database queries that do not have post_meta (The Events Calendar revealed the bug, but it likely had an effect on other plugins).
- Fixed bug that assigned auto-encoded videos to nobody.
- Restored process to set featured image for video attachments when thumbnails are assigned.
4.2.8 – November 11, 2013
- Updated Video.js to version 4.3.0.
- Fixed iframe embedded video auto-sizing bug.
- Improved sizing of videos using the WordPress Default player.
- Removed shortcode text from RSS feeds.
- Now checking for cross-origin when making thumbnails. If video files are hosted on a different domain FFMPEG will make thumbnails to avoid cross-origin errors when saving canvas elements.
- Fixed bug that assigned auto-generated thumbnails to nobody.
- Fixed bug that would cause divide by zero errors when generating thumbnails from .mpg videos that had already encoded an alternate format with FFMPEG.
4.2.7 – October 24, 2013
- Fixed several video sizing issues.
- Updated Video.js to version 4.2.2.
- No longer loading Video.js files when using the WordPress Default player.
- Restored [/KGVID] closing tag to inserted gallery shortcodes to avoid confusion if more than one is in the post.
- Changed Settings and Donate links on Installed Plugins admin page and fixed 404 error on network dashboards.
4.2.6 – October 19, 2013
- Fixed bug that broke playback in some cases when using the shortcode without a URL.
- Fixed bug that ignored width and height saved in the attachment meta if width and height were not set in the shortcode.
- Fixed bug that broke WordPress Default player when embedding M4V files.
- Removed line breaks from generated code to avoid adding extra line breaks in the rendered video in some situations where wpautop is run after the code is created.
4.2.5 – October 12, 2013
- Fixed bug that disabled FFMPEG when other plugin settings were changed.
4.2.4 – October 12, 2013
- Fixed bug that ignored "Enlarge lower resolution videos to max width" plugin setting after thumbnails were generated.
- Fixed bug that caused in-browser thumbnail generation to fail after switching between several attachments in Chrome.
- Fixed bug that prevented fallback to FFMPEG/LIBAV when the video format was not compatible with the browser.
- Fixed bug that lost disabled plugin settings if the "Save Changes" button was pressed.
- Fixed bug that fixed moov atom incorrectly when using qt-faststart.
- Added verification of the "Path to applications folder on server" setting to strip extra slashes and unnecessary subfolders.
- Added "Fixing moov atom for streaming" section to FFMPEG test output.
- Added legacy FFMPEG libx264 flags manually so we don't have to rely on finding vpre files.
- Now multiplying H.264 level flags by 10 for better compatibility.
- Removed unnecessary & inconsistent check for existing thumbnail files on attachment pages.
4.2.3 – October 9, 2013
- Fixed bug that caused encoding on Windows servers to hang and not show progress.
- Fixed bug that only disabled right-clicking when using the Video.js player.
- Fixed bug that prevented encoding videos from the External URL tab.
- Fixed bug that showed an empty "Replace original with H.264" checkbox if the filename changed.
- Better error reporting when encoding or auto thumbnail creation fails.
- Modified method for determining video's dimensions from FFMPEG/LIBAV output. This will cause videos with single-digit resolutions to fail.
- Adjusted video gallery CSS.
4.2.2 – October 7, 2013
- Fixed bug that was setting the global $content_width to 2048 on every page.
4.2.1 – October 6, 2013
- Featured images are now set for the post currently being edited, which does not have to be the video's parent.
- Rounded offset values when generating thumbnails with FFMPEG and LIBAV for backwards compatibility with older versions of FFMPEG.
- Added check to ensure server supports ImageMagick or GD libraries necessary to save thumbnails created in the browser.
- Added check to avoid saving thumbnails twice.
- Fixed saving disabled plugin settings.
- Changed FFMPEG encoding string to double quotes for Windows compatibility.
4.2 - October 5, 2013
- THUMBNAILS FOR EVERYBODY! Added in-browser thumbnail generation. Any video in the media library that can be played natively in the current browser can now be used to generate thumbnails without requiring special software on your server.
- Updated shortcode to support the simplest possible implementation: . Without any additional information, it will automatically find and display all videos attached to the post.
- Added "id" and "videos" attributes to shortcode to display specific video IDs or show a specific number of attached videos.
- If a video thumbnail is set, the video will now use its thumbnail as an icon in the WordPress admin area instead of the generic "video" icon.
- To avoid clutter, additional video formats encoded by the plugin are now hidden from lists of media, unless "Video" is specifically selected.
- When a master video is deleted and additional video formats are not deleted, the next highest quality format automatically becomes the master video.
- Updated Video.js to version 4.2.1, updated the included skin to work with it, and removed the unused image video-js.png.
- Added option to use the WordPress default video player introduced in WordPress version 3.6.
- Added buttons to choose thumbnails, end of video image, and watermark from the media library.
- Added option to add Open Graph tags for posting videos on Facebook. However, for the many Facebook users who browse with https, your own videos must be served via https in order to work.
- Added options to automatically generate a thumbnail and encode videos to multiple formats as soon as they are uploaded (FFMPEG/LIBAV only).
- Added option to disable responsive video resizing.
- Added options to restrict thumbnail making and video encoding to particular user roles.
- Added option to enter username and password to give FFMPEG/LIBAV access to .htaccess protected videos.
- Added option to disable right-clicking on videos.
- Added option to replace original video file with an H.264 video of the same resolution.
- Added advanced FFMPEG/LIBAV encoding options. New options include choice between Constant Rate Factor and Average Bit Rate, H.264 profiles and levels, audio bit rate, disabling nice on Linux, and the ability to encode with more than one thread.
- Added -movflags faststart option available in newer versions of FFMPEG/LIBAV, eliminating the need for qt-faststart or MP4Box.
- Added a test encoding output on the settings page for easier troubleshooting.
- Split plugin settings page in to two tabs.
- Fixed saving plugin settings when multiple settings are changed rapidly.
- No longer starting video encodes using nohup command on Linux servers.
- FFMPEG vpre flag switched from slow to fast.
- Enabled actual support for encoding with libfdk_aac, and the experimental built-in aac encoder as a last resort.
- Fixed cases where the encode queue would not advance if an unexpected error happened.
- Fixed encoding library messages so the errors are saved to the encode queue and don't disappear immediately.
- Changed endOfVideoOverlay and endOfVideoOverlaySame options to lowercase.
- Revised method for determining if a video URL refers to an attachment in the WordPress database to account for differences between urls using http and https and filenames that slip into the database with spaces intact.
4.1.5 – June 30, 2013
- Updated Video.js to version 4.1.0
- Restored code to show captions and download links in gallery pop-ups.
- Fixed conflict with fitVids.js by disabling the function whenever a video is embedded with the KGVID shortcode. fitVid.js is not compatible with the Video.js player and is not necessary to make videos responsive when you are using this plugin.
- Increased bitrate of encoded videos.
- Increased play button circle thickness and triangle size.
- Made video title overlay background slightly transparent and the title width fluid through CSS rather than JS.
4.1.4 – May 30, 2013
- Restored ability to use percentages for video width (I didn't even know you could do this before and I apologize for breaking it arbitrarily).
- Fixed Video.js play button triangle vertical alignment problem on many themes (where were all the complaints on this one?) and tweaked the :hover settings.
- Moved play button overlay behind gallery thumbnail title if they happen to overlap.
- Changed WordPress user capability required to access plugin settings menu page from 'administrator' to 'manage_options' to allow access to multisite Super Admins and anyone else who has the manage_options capability.
4.1.3 – May 25, 2013
- Updated Video.js to version 4.0.2 which is supposed to solve IE play-button loading issues.
- Added option to show image at end of video in Video.js player (similar to the feature already available in Strobe Media Playback).
- Fixed bug that ignored
gallery_id setting in gallery shortcodes and was preventing
gallery_include setting for videos that are not children of the current post.
- Brought download link into shortcode rather than old method of inserting it into the post as text below the shortcode.
- Automatically adjust pop-up gallery window height to display captions, view counts, and download links.
- Rolled back responsive video resize method. Only the width of the immediate container will be used to calculate the correct size.
- For very small videos, Video.js controls are now selectively removed as the width drops below 260 pixels to prevent them from dropping outside of the video window.
4.1.2 - May 23, 2013
- Changed check for FFMPEG to use the H.264 sample video as input to avoid any PNG-related red herrings.
-f mjpeg to thumbnail-generating command to maintain compatibility with versions of FFMPEG that can't figure it out on their own.
4.1.1 - May 21, 2013
- Removed second argument from json_encode() which caused video setup & resizing features to fail when servers were running PHP 5.2.
4.1 - May 19, 2013
- Updated Video.js to version 4.0 and created a new skin that approximates the old one. Older versions of Video.js had some security holes, so this update is highly recommended.
- Fixed bug that disabled Strobe Media Playback player and caused "TypeError: Error #1034" messages, particularly in Internet Explorer.
- Fixed bug that caused view count to be replaced by complete views when the end of the video is reached.
- Fixed bug that disabled video encode status monitoring in media modal popup when the same video was already in the post edit window.
- Fixed bug that displayed WordPress thumbnail-sized poster image if no poster URL was in shortcode.
- Tweaked video resize method to support more kinds of themes.
- Added ability to turn off watermark on individual videos by entering
watermark="false"in the shortcode.
- Added option to disable embedding on other websites.
- Added option to allow videos to be placed next to each other on the page.
- Added support for AAC library libfdk_aac.
- Adjusted embedded video and gallery CSS to account for colored backgrounds.
- Renamed "Poster image" plugin setting to "Default thumbnail"
- Removed post meta box below post editing window until I can work out a way to generate them without disabling video encode status monitoring in media modal popup when the same video is already in the post edit window.
- Replaced deprecated ereg PHP function with preg_match and used a more precise regular expression when determining the height and width of videos.
4.0.3 - May 01, 2013
- Fixed bug that caused video control text to display below videos on iPhones.
- Changed method for saving video plays to the database. Now more secure and accurate.
4.0.2 - April 25, 2013
- Plugin settings are no longer re-saved to the database on every page load. Should speed things up a little.
- Changed CSS to discourage theme styles from overriding embed code overlay styles.
4.0.1 - April 23, 2013
- Added options to display video title and embed code overlays on video player, and captions and view counts below videos.
- Added option to filter your theme's video attachment page template to display the video instead of WordPress's default behavior of just showing the title of the video. For backwards compatibility retained old method of completely replacing the video attachment template with a video player.
- Redesigned settings page to save using AJAX, and added a sample video player so changes are seen immediately.
- Added iframe method to embed your videos on other websites.
- Additional video formats encoded by the plugin are now added to the WordPress database as video attachments. To avoid a Russian nesting doll scenario these child attachments do not have the fields for creating thumbnails and encoding additional formats.
- Changed encoded H.264 extensions from .m4v to .mp4 to increase compatibility with WordPress 3.6's new video capabilities. Existing M4V files will still work.
- Checks only one time for alternate video sources when videos are embedded from other servers. This should speed up page load times considerably.
- Added ability to rotate and replace the original file for videos recorded vertically on cell phones.
- Added post meta box to posts with embedded videos that lists alternate formats found for each video.
- Added option to set a post's featured image to the most recently generated thumbnail, and a button to set all previously generated thumbnails as featured images.
- Added option to save generated thumbnails as children of either the video or the post the video is attached to, and a button to convert all thumbnails to the chosen hierarchy.
- Added option to delete associated thumbnails and additional encoded video formats when original video attachment is deleted.
- Added backwards compatibility for WordPress versions 3.2 and above.
- If Strobe Media Playback player is selected, the Video.js player is used in situations where Flash doesn't work (webm, ogg playback) instead of the ugly default browser players.
- Added watermark, view counts, volume attribute, and Google Analytics event tracking when using Strobe Media Playback player.
- Added alignment option to center or right-justify videos.
- Revised video player setup to properly resize the player if the containing DIV is smaller than the video, and resize again if the window size changes (or orientation changes on Android).
- No matter which player is selected, iOS now displays the built-in controls so AirPlay works.
- Added schema.org videoobject markup for improved SEO.
- Fixed FLV embedding with Video.js player and improved selection of embedded formats for Strobe Media Playback.
- Adjusted video gallery CSS and added a play button overlay to gallery thumbnails.
- Adjusted watermark and Video.js play button CSS so the overlays don't overwhelm small videos.
- Set Video.js controls to fade out on autoplay and on iOS, without having to mouseover the video.
- Fixed endless "loading" spinner shown at the end of videos in some browsers in Video.js player.
- Clicking "Insert into post" immediately after upload without changing any options now inserts shortcode instead of just the title of the video.
- Inserting shortcode without a thumbnail no longer attempts to save the nonexistent thumbnail. Thumbnail cleanup is handled better.
- Fixed error message "array_key_exists() expects parameter 2 to be array" when shortcode didn't have attributes.
- Escaped all shell commands for increased security.
- Fixed bug that made "Encode" button disappear if all formats were checked.
- Fixed missing argument for kgvid_clear_completed_queue() when scheduling cleanup.
4.0 - April 22, 2013
- Accidental release caused by programmer's incompetence.
3.1.1 - March 5, 2013
- Fixed missing ) in uninstall.php
3.1 - January 30, 2013
- Added video watermark overlay option. (Video.js only)
- Changed front-end CSS file name to kgvid_styles.css and made it always available, not just when galleries are on the page.
- Removed my watermark testing logo which was accidentally inserted above videos in version 3.0.3.
- Added option to choose -b:v or legacy -b flags when encoding. Recent FFMPEG versions only accept -b:v.
- Added automatic encode queue cleanup. Any completed entry older than a week will be removed.
- Added deactivation hook to remove queue and scheduled queue cleanup on deactivation.
- Added uninstall.php to remove settings from the database on uninstall.
- Disabled "Delete Permanently" link while encoding is canceling.
- Checked for escapeshellcmd. If it's disabled on the server, encoding can't start.
- Fixed insert title and download link checkboxes. They will actually insert something now.
- Changed method for determining if a video has been played or paused and played again, for counting purposes.
- Fixed check for mime type when generating H.264 video encode checkboxes to avoid showing options for QuickTime files that are higher resolution than the original video.
3.0.3 - January 29, 2013
- If video player is set larger than the containing DIV and the player size is reduced to fit, the height is now rounded to the nearest integer.
3.0.2 - January 24, 2013
- Fixed bug that permanently disabled buttons on the Embed Video from URL tab.
- Disabled "Delete Permanently" option for encoded files found on other servers.
- Reduced the jQuery UI Dialog css and put it in its own scope to avoid conflicts with existing jQuery UI Dialog themes.
- Cleaned out some leftover code.
3.0.1 - January 24, 2013
- Fixed bug that inserted empty options into gallery shortcodes.
3.0 - January 23, 2013
- Updated to provide compatibility with several media changes in WordPress 3.5. With this version, thumbnail generating & video encoding will only work in WordPress 3.5 and above.
- Added popup video gallery.
- Changed shortcode tag to [KGVID]. Retained [FMP] for backwards compatibility.
- Added Video.js player option. Older Strobe Media Playback Flash player is still included for backwards compatibility, but Video.js is highly recommended.
- Added video play counting which is recorded to the WordPress database (Video.js only).
- Added Google Analytics event tracking for video plays (Video.js only)
- Added ability to encode multiple H.264 video resolutions.
- Added video encoding queue.
- Added qt-faststart and MP4Box processing to MP4/M4V H.264 videos encoded by the plugin to allow playback of videos as they download.
- Added option to change default number of thumbnails generated by the plugin.
- Changed any https FFMPEG input to http.
- Thumbnail images are now added to the WordPress database as soon as they are selected.
- Added option to use LIBAV instead of FFMPEG for thumbnail generating and video encoding.
- Added wmode parameter to fix Chrome z-index issue. (Strobe Media Playback only)
- Improved swfobject.js script enqueuing method to prevent conflicts (Strobe Media Playback only)
- Rewrote plugin settings to work with the WordPress plugin settings API.
- Removed dropdown list for embedding alternate encoded formats of video. All formats are made available to the player and the browser chooses best compatible format.
- Removed mdetect.php and removed forced downgrading of quality when on mobile devices. Mobile browsers now automatically choose best compatible format.
2.0.6 - April 27, 2012
- Removed swfobject.js from the plugin package. Now using the one included with WordPress. WordPress 3.3.2 contains a security fix for swfobject.js and the plugin will use the fixed version if you have upgraded WordPress (which is highly recommended).
- Added setting to customize the formatting of titles inserted by the plugin.
- Added settings to display a custom image when videos end instead of the first frame of the video (Flash only).
- Fixed problem with embedded FLV files giving message "Argument Error – Invalid parameter passed to method" when loading poster images.
2.0.5 - April 20, 2012
- Fixed "Wrong datatype for second argument" error on line 339 and subsequent automatic replacement of original videos with Mobile/H.264 versions whether they exist or not.
2.0.4 - April 19, 2012
- Once again changed the process checking for FFMPEG installations. Should be universal now.
- Added setting to turn on vpre flags for users with installed versions of FFMPEG old enough that libx264 requires vpre flags to operate.
- Added setting to replace the video attachment template with a page containing only the code necessary to display the video. Makes embedding your hosted videos on other sites easier.
- Fixed progress bar for older versions of FFMPEG.
- Added Flash fallback when OGV or WEBM videos are embedded.
- Removed restriction on number of thumbnails that can be generated at once and added a cancel button while generating thumbnails.
2.0.3 - February 24, 2012
- When working with file formats that can't be embedded (WMV, AVI, etc) the option to embed the original file will be disabled if Mobile/H.264, WEBM, or OGV files are found.
- Changed encoding bitrate flag back to -b instead of -b:v to retain compatibility with older versions of FFMPEG.
- Cosmetic changes in encoding progress bar.
- No longer deleting encoded files if progress can't be properly established.
- Added "nice" to the encode commond (not on Windows) to prevent FFMPEG from overusing system resources.
2.0.2 - February 21, 2012
- Fixed check for FFMPEG to work with Windows.
2.0.1 - February 21, 2012
- Fixed check for FFMPEG again. Should be more universal.
2.0 - February 20, 2012
- Large rewrite to fix several security issues. Full server paths are no longer exposed in the Media Upload form, all AJAX calls are handled through wp_ajax, and nonces are checked.
- Added video encoding progress bar on Linux servers.
- Added button to cancel encoding.
- Added option to encode 720p or 1080p H.264 videos.
- Changed requirements for AAC encoding. Will work with libfaac or libvo-aacenc.
- Improved error reporting to help diagnose problems.
- Videos recorded on phones in portrait mode (tall and skinny) will not end up sideways if FFMPEG version .10 or later is installed.
- Thumbnail generation process uses fancy jQuery animation.
- Fixed check for FFMPEG. Should actually work in Windows now.
- Fixed unenclosed generate, embed, submit, delete strings in kg_call_ffmpeg
1.1 - January 8, 2012
- Includes Strobe Media Playback files so Flash Player is now hosted locally, which allows skinning.
- Added skin with new, more modern looking play button. Upgraders should check the plugin settings for more details.
- Fixed "Insert into Post" button in "Embed from URL" tab when editor is in HTML view mode. Used to do nothing! Now does something.
- Added option to override default Mobile/HTML5 encode formats for each video
- Added check for FFMPEG. Generate & Encode buttons are disabled if FFMPEG isn't found.
1.0.6 - November 6, 2011
- Resetting to defaults on the plugin settings page resets to actual values now, instead of undefined constants.
1.0.5 - November 6, 2011
- Fixed "Embed from URL" thumbnail creation. Generated thumbnails don't disappear anymore.
1.0.4 - November 4, 2011
- More thorough check made for existing attachments before registering poster images with the WordPress Media Library. Avoids registering duplicates or medium/small/thumb image sizes if they're used as poster image.
- Added loop, autoplay, and controls options to HTML5 video elements.
- When saving attachments, won't try to delete thumb_tmp directory if it doesn't exist.
1.0.3 - October 27, 2011
- Revised thumbnail cleanup to make sure temp files aren't deleted when generating thumbnails for more than one video at a time.
1.0.2 - October 21, 2011
- Fixed a shocking number of unenclosed stings in get_options() calls. Bad programming. Didn't affect functionality, but will stop generating errors.
- Removed clumsy check for FFMPEG running. Was preventing encoding if ANY user on the server was running FFMPEG. Be wary of overusing your system resources though.
1.0.1 - October 21, 2011
- Quick fix to add mdetect.php to the plugin package from WordPress
1.0 - October 20, 2011
- Huge re-write.
- Integrated with WordPress Media Library and added WEBM support.
- Increased control over thumbnail generation.
- Added tab to Insert Video dialog box for adding by URL (like the old version).
0.2.1 - October 9, 2011
- Check made to ensure iPhone/iPod/Android compatible encode video height is an even number when HTML5 video encodes are made.
0.2 - January 18, 2011