=== Flowplayer HTML5 for WordPress ===
Contributors: flowplayerorg, grapplerulrich, anssi
Donate link: http://flowplayer.org/pricing/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin
Tags: flowplayer, flowplayer5, flowplayer6, Flowplayer HTML5, responsive, mobile, embed, html5, video, player, rtmp, hls, flash, live-streaming, Flowplayer Drive, Adsense, video ads, video widget, playlist, ABR, Adaptive Bit Rate
Requires at least: 3.7
Tested up to: 4.4
Stable tag: trunk
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A beautiful, responsive, HTML5 video player plugin from the makers of Flowplayer.

== Description ==

Flowplayer HTML5 for WordPress provides a video management system for self hosted videos where you can manage all of your video from a central place. You can easily customize the videos from the numerous settings. The videos are displayed with the world-famous Flowplayer video player using a simple shortcodes. This is the official WordPress plugin from the makers of Flowplayer.

[youtube https://www.youtube.com/watch?v=G43QiDe1gDc]

= Main features =

* Easily manage all of your videos in a central place
* Insert videos in posts, pages and custom post types using the shortcode e.g. [flowplayer id="123"] , [flowplayer playlist="123"]
* Display videos in the sidebar with the "Video Widget"
* Create [playlists](https://flowplayer.org/docs/playlist.html?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin) using the existing videos
* Style the video player with the three default Flowplayer skins: [Minimalist](https://flowplayer.org/demos/#minimalist?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin), [Functional](https://flowplayer.org/demos/#functional?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin) and [Playful](https://flowplayer.org/demos/#playful?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin)
* Track your video video audience and traffic with [Google Analytics](http://flowplayer.org/docs/analytics.html?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin)
* Video adverts with [Google AdSense](http://flowplayer.org/asf/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin)
* Supports WEBM, MP4, OGG, FLV(flash), RTMP and HLS video formats.
* Use Flowplayer to play your live streams
* Show your video in any desired player size. Detects the video dimensions for configuring the correct player size
* [Supports subtitles](http://flowplayer.org/docs/subtitles.html?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin)
* Fully internationalized - [Help Translate](https://translate.wordpress.org/projects/wp-plugins/flowplayer5)
* Switch easily between Flowplayer v5 and Flowplayer v6


[Demos](https://flowplayer.org/demos/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin) | [Documentation](https://wordpress.org/plugins/flowplayer5/faq/) | [Support](http://wordpress.org/support/plugin/flowplayer5)

= Branding free with Flowplayer Commercial =

The commercial version is free of Flowplayer branding and you can use your logo. The commercial Flowplayer version can be enabled by supplying a [license key](http://flowplayer.org/pricing/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin).

= Let Flowplayer Drive host your videos =

[Flowplayer Drive](http://flowplayer.org/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin) is an all-round solution for online video sharing and publishing. It makes the task of uploading, managing, sharing, and publishing videos extremely simple without sacrificing on quality and speed, and utilizing the latest web video technologies.

* Maximum browser coverage
* Multi-resolution videos with quality switching
* Videos optimized for best results
* Maximum streaming throughout on a global video network
* Free with Flowplayer watermark

[Flowplayer Drive details](http://flowplayer.org/docs/drive.html?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin)

= Monetize your videos =

[Google AdSense for Flowplayer (ASF)](http://flowplayer.org/asf/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin) allows publishers to monetize their videos by adding advertisements. While AdSense is normally restricted to sites with more than 10 million streams per month, Flowplayer makes it available for everyone.

[Sign up for Google AdSense for Flowplayer (ASF)](http://flowplayer.org/asf/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin)


== Other Notes ==

= Translation =

[Join the Translation Team](https://translate.wordpress.org/projects/wp-plugins/flowplayer5)

= Credits =

The plugin can also be found on [GitHub](https://github.com/flowplayer/wordpress-flowplayer).

* Thank you [Tom McFarlin](http://tommcfarlin.com/) for the [WordPress Plugin Boilerplate](https://github.com/tommcfarlin/WordPress-Plugin-Boilerplate)
* The settings code was adapted from [Easy Digital Downloads](https://github.com/easydigitaldownloads/Easy-Digital-Downloads) by [Pippin Williamson](http://pippinsplugins.com/)
* The meta box settings was adapted from [Theme Foundation](http://themefoundation.com/wordpress-meta-boxes-guide/) by [Alex Mansfield](http://sackclothstudios.com/)
* Thank you [Brady Vercher](http://www.blazersix.com/) for help with the playlist
* Thank you [Pippin Williamson](https://pippinsplugins.com/) for the great tutorials


== Installation ==

= Installing from the WordPress dashboard =

1. Navigate to the 'Add New' plugins dashboard
2. Search for 'Flowplayer5 for WordPress'
3. Click 'Install Now'
4. Activate the plugin on the WordPress Plugin dashboard

= Uploading in the WordPress dashboard =

1. Navigate to the 'Add New' plugins dashboard
2. Navigate to the 'Upload' area
3. Select `flowplayer5.zip` from your computer
4. Upload
5. Activate the plugin on the WordPress Plugin dashboard

= Using FTP =

1. Download `flowplayer5.zip`
2. Extract the `flowplayer5` directory to your computer
3. Upload the `flowplayer5` directory to your `wp-content/plugins` directory
4. Activate the plugin on the WordPress Plugins dashboard

= Configuration =

You can configure Google Analytics, a Commercial Flowplayer license key and a custom watermark logo in the plugin's global options. You can purchase a commercial license at [flowplayer.org](http://flowplayer.org/pricing/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin).

== Frequently Asked Questions ==

= Where can I upload the videos? =
There are three ways you add add a video

1. You can use the WordPress media manager and upload the videos there.
2. You can use [Flowplayer Drive](http://flowplayer.org/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin) to upload a video and let Flowplayer.org host you video.
3. You can store your videos on Amazon S3 or any other cloud host and add the links manually.

= What video format do I need? =
It is recommended to add at least two [video formats](http://flowplayer.org/docs/setup.html?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin#video-formats) so that the video plays on as many browsers as possible. By default Flowplayer attempts to use HTML5 video, and if it's not supported then Flash (9.0+) and MP4 is used. MP4 is enough for complete browser support, but providing WebM and/or OGG video gives you broader support for HTML5 video which is the preferred technology.

= Why use Flowplayer when there is video support since WordPress 3.6? =

Flowplayer HTML5 for WordPress provides a video management system where you can manage all of your video from a central place. You do not need to remember all of the shortcode configuration attributes, you can simply configure the videos form within the options. We are continuously adding further features to the plugin.

= Why can I not see the video that I just uploaded to Flowplayer Drive? =

It takes some time for the video to be processed. The plugin fetches the video links from Flowplayer.org and the results are cached. The cache is refreshed every 15 minutes.

= How do I load Flowplayer assets locally when using Flowplayer Commercial? =

If you want to load the Flowplayer assets (JS, CSS and SWF) for your site then you can download the files from [your account](https://flowplayer.org/account/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin). Create a new folder `flowplayer-commercial` in `wp-content`. Place the files in this new folder. The option in the settings to use Flowplayer CDN should be disabled

= How do I add Ads to my videos? =

After [Signing up](http://flowplayer.org/asf/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin) you will get your own custom advertising plugin that you upload and paste the link in the settings.

= How do I create a playlist? =

Edit the video you want to add to a playlist and there should be a playlist box. You can choose an existing playlist or create a new one there. You can add the playlist to a post via the "Add Video" button under the post title.

= How do I set multi-resolution videos? =

With Flowplayer HTML5 for WordPress v1.10.0 we have included [multi-resolution videos support](https://flowplayer.org/docs/drive.html#quality-selector-plugin?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin).

- The easy way is to use [Flowplayer Drive](http://flowplayer.org/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin) paid version where everything is done for you.

- The second way requires creating the multiple resolution files and naming them using the [predefined naming structure](https://flowplayer.org/docs/drive.html#quality-selector-plugin?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin). In the configuration tab you need to define the default video resolution and the other resolutions.

= Can I test the commercial version? =

Yes, we have some sample keys for the specific urls

`localhost  $289122895653393`
`127.0.0.1  $130388743137804`

= Flowplayer Drive issues? =

If you are unable to connect to the Flowplayer Drive API, make sure you are connected to the internet and that you are logged in. You can login in the Settings page.

= Flowplayer issues? =

If you are having a issue please check the [Flowplayer known issues page](http://flowplayer.org/docs/known-issues.html?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin).

= What happens when I disable the plugin? =

Nothing, other then it being disabled.

= What happens when I uninstall the plugin? =

Why would you want to do that? :-) If you do need to uninstall the plugin all of the data (Flowplayer videos and settings) will be deleted so that you do not have unnecessary data left on your database. Your media files will not be deleted. If you want to backup the Flowplayer videos that you have created you can easily export them under Tools -> Export -> Videos.

= Developer Docs =

= Filters =

* [fp5_filter_set_messages](https://github.com/flowplayer/wordpress-flowplayer/blob/master/admin/class-flowplayer5-admin.php#L306)
* [fp5_post_type_args](https://github.com/flowplayer/wordpress-flowplayer/blob/master/includes/class-register-post-type.php#L123)
* [fp5_video_data_config](https://github.com/flowplayer/wordpress-flowplayer/blob/master/frontend/class-flowplayer5-output.php#L220)
* [fp5_js_config](https://github.com/flowplayer/wordpress-flowplayer/blob/master/frontend/class-flowplayer5-output.php#L254)
* [fp5_js_brand_config](https://github.com/flowplayer/wordpress-flowplayer/blob/master/frontend/class-flowplayer5-output.php#L263)
* [fp5_filter_video_src](https://github.com/flowplayer/wordpress-flowplayer/blob/master/frontend/class-flowplayer5-output.php#L296)
* [fp5_filter_has_shortcode](https://github.com/flowplayer/wordpress-flowplayer/blob/master/frontend/class-flowplayer5-frontend.php#L246)
* [fp5_option_defaults](https://github.com/flowplayer/wordpress-flowplayer/blob/master/frontend/class-register-settings.php#L50)
* [fp5_settings](https://github.com/flowplayer/wordpress-flowplayer/blob/master/frontend/class-register-settings.php#L79)
* [fp5_register_settings](https://github.com/flowplayer/wordpress-flowplayer/blob/master/frontend/class-register-settings.php#L356)

= Actions =

* [fp5_video_top](https://github.com/flowplayer/wordpress-flowplayer/blob/master/frontend/views/display-single-video.php#L23)
* [fp5_video_bottom](https://github.com/flowplayer/wordpress-flowplayer/blob/master/frontend/views/display-single-video.php#L30)
* [fp5_video_config](https://github.com/flowplayer/wordpress-flowplayer/blob/master/frontend/views/display-single-video.php#L43)

= Examples =

Here are a few code examples of things that have been asked.
`/**
 * Allow flowplayer files should be loaded on the home page.
 */
function fp5_has_shortcode( $has_shortcode ) {
	if ( is_front_page() ) {
		$has_shortcode = is_front_page();
	}
	return $has_shortcode;
}
add_filter( 'fp5_filter_has_shortcode', 'fp5_has_shortcode' );`

`/**
 * Change post type arg to support hierarchical format.
 */
function fp5_post_type_arg_hierarchical( $args ) {
	$args['supports']     = array( 'title', 'page-attributes' );
	$args['hierarchical'] = true;
	return $args;
}
add_filter( 'fp5_post_type_args', 'fp5_post_type_arg_hierarchical' );`

`/**
 * Display links for single video posts and activate archive page.
 */
function fp5_post_type_arg_video_post( $args ) {
	$args['public']            = true;
	$args['show_in_nav_menus'] = true;
	$args['has_archive']       = true;
	return $args;
}
add_filter( 'fp5_post_type_args', 'fp5_post_type_arg_video_post' );`


`/**
 * Disable "Help Tooltip" - Add additional configuration options.
 */
function fp5_video_config() {

	$config = 'tooltip: false,';

	echo $config;
}
add_action( 'fp5_video_config', 'fp5_video_config' );`


`/**
 * Define post meta defaults
 */
function fp5_post_meta_defaults( $defaults ) {
	$defaults['fp5-no-embed'] = array( 'true' );
	return $defaults;
}
add_filter( 'fp5_post_meta_defaults', 'fp5_post_meta_defaults' );`


== Screenshots ==

1. Posting a video
2. Flowplayer Drive
3. Video Widget
4. Plugin Settings
5. Video Frontend

== Changelog ==

We have a lot of plans for this plugin. You can see some of the up and coming features in the [roadmap](https://github.com/flowplayer/wordpress-flowplayer/issues?labels=enhancement&page=1&state=open)

= 1.13.0 - 16 December 2015 =
* Updated Flowplayer to v6.0.4
* Updated the quality selector scripts
* Updated HLS script
* Included the extra features for playlists that came in Flowplayer v6. e.g. Quality selector for videos in playlists and RTMP URL per Video
* Updated dashboard widget library code to support PHP 7
* Increased WordPress minimum requirement to 3.7
* Improved database queries performance

= 1.12.1 - 15 November 2015 =
* Fixed bug with feature checker for loading extra JS
* Fixed bug with removing settings when commercial key used
* Improve coding style

= 1.12.0 - 07 November 2015 =
* Fixed bug for the check to show brand name on own site
* Added support for the HLS Flowplayer plugin
* Hide the CDN option when the commercial key is added
* Automatically add the video title from Flowplayer Drive
* Add support for lightbox

= 1.11.2 - 06 September 2015 =
* Fix two small bugs
* Added Italien translation. Props Maurizio Sansone

= 1.11.1 - 28 August 2015 =
* Add video id to filters as an attribute
* Fix issue with HLS URL returning blank from Flowplayer Drive
* Remove http from URLs returned from Flowplayer Drive
* Add default video quality to list of qualities
* Fix issue of overescaping data config output

= 1.11.0 - 8 August 2015 =
* update to Flowplayer 6 and add support for new features in Flowplayer 6
* add support for description_url for ads
* allow single options to be overriden in the shortcode e.g. `[flowplayer id="123" show_title="true"]
* fix bug: playlists with only a mp4 file would not play
* improved the settings code
* depricate filter `fp5_filter_flowplayer_data` to be removed in v2.0

= 1.10.7 - 5 April 2015 =
* fix bug: foreach warning on 404 page
* prepare for taxonomy term splitting in WP 4.2
* Reduce cache size by chaching processed video array

= 1.10.6 - 7 March 2015 =
* fix bug: checking video id with nested shortcodes
* fix bug: Invalid argument supplied for foreach()

= 1.10.5 - 1 March 2015 =
* fix bug: playing videos on different pages
* fix bug: fix issue with videos from Flowplayer Drive
* add filter to define new video defaults

= 1.10.4 - 21 February 2015 =
* fix bug: play videos when in a blog loop
* fix bug: fix issue with loading all of the videos from Flowplayer Drive

= 1.10.3 - 3 February 2015 =
* fix bug: fix code Flowplayer Drive API
* fix bug: fix issue with Playlist JS

= 1.10.2 - 23 December 2014 =
* move background inline css to stylesheet
* support nested shortcodes when fetching shortcode args
* add css fix for Twenty Fifteen
* additional classes for playlists
* fix bug: allow more then 10 videos in a playlist
* fix bug: allow multiple playlists on a single page
* fix saving video order for playlists

= 1.10.1 - 7 December 2014 =
* add live streaming option
* update to [Flowplayer 5.5.2](https://flowplayer.org/news/releases/html5/v5.5.1.html)
* improve security and coding styles

= 1.10.0 - 9 November 2014 =
* add complete multi-resolution support
* add an option to define Flowplayer assets directory e.g. CDN
* fix bug: embed options
* prefix two classes

= 1.9.4 - 9 October 2014 =
* fix bug: change class from `.flowplayer` to `.flowplayer-video`
* fix bug: letting 0 be a valid number for ads time
* fix bug: removed trailing comma in JS and moved action `fp5_video_config` to the start of the JS

= 1.9.3 - 2 October 2014 =
* fix bug: adding asf js and css files
* fix bug: fetching the correct resolution video from Flowplayer Drive

= 1.9.2 - 21 September 2014 =
* fix bug: remove spurious comma
* fix bug: rtmp and flash videos
* add video unique class
* add German translation
* prepare for multi-resolution support for Flowplayer Drive

= 1.9.1 - 5 September 2014 =
* fix bug: shortcode loading at the top content - the shortcode was printed and not returned

= 1.9.0 - 4 September 2014 =
* add [Playlist](https://flowplayer.org/docs/playlist.html?utm_source=wordpress.org&utm_medium=readme&utm_campaign=Flowplayer%20Plugin) support
* update to [Flowplayer HTML5 5.5.0](https://flowplayer.org/news/releases/html5/v5.5.0.html)
* fix CSS issue with Yoast Video SEO
* update upload button text in the settings
* add hidden field with duration for Yoast Video SEO
* stop video width and height calculation when custom width or height are defined

= 1.8.1 - 17 April 2014 =
* replace php short tags with full tags
* fix icon for WordPress 3.9

= 1.8.0 - 9 March 2014 =
* introducing Flowplayer Drive to replace Flowplayer Designer
* add support for Google AdSense for Flowplayer

= 1.7.0 - 16 February 2014 =
* add full support for flash video file, rtmp and hls
* cache Flowplayer designer video results
* allow all data to be deleted from all sites when uninstalling on a multisite
* update pot file
* update to colorbox v1.4.37

= 1.6.0 - 25 January 2014 =
* add support for all of the [modifier classes](http://flowplayer.org/docs/skinning.html#modifier-classes)
* improve structure of video options by splitting options with tabs
* add support for "At a Glance" dashboard widget

= 1.5.0 - 26 December 2013 =
* update to [Flowplayer HTML5 5.4.6](http://flowplayer.org/news/#html5546)
* minify all back-end scripts and styles
* reformatted video format meta and add a new filter
* started adding flash video file and rtmp support

= 1.4.0 - 10 December 2013 =
* added a video widget
* added support for WordPress 3.8
* added responsive design to the admin area
* code improvements

= 1.3.0 - 24 November 2013 =
* added a few extra filters
* updated [FAQ](http://wordpress.org/plugins/flowplayer5/faq/) with more code documentation
* code improvements

= 1.2.0 - 10 November 2013 =
* added functionality to fetch videos from Flowplayer Designer directly in the admin area
* added a few filters and actions
* reorganisations of files and folders
* update to Flowplayer HTML5 5.4.4
* enable subtitle after being disabled in version 1.0.0

= 1.1.0 - 20 September 2013 =
* added an extra column to show the shortcode in the overview
* added a button in the posts pages so add shortcodes easily
* fixed typos and updated pot file

= 1.0.0 - 18 August 2013 =
* complete rewrite of plugin - now you can manage all of your videos in one place
* updated the Flowplayer HTML5 code to version 5.4.3
* added preload option
* added CDN option
* added a few more Flowplayer options
* added embed options
* disable subtitles temporarily till Flowplayer version 5.4.4 is released

= 0.5.0 - 3 March 2013 =
* updated the Flowplayer HTML5 code to version 5.3.2
* fixed splash image sizing

= 0.4.0 - 16 January 2013 =
* fixed the new "show logo on origin site" checkbox that was introduced in version 0.3
* now possible to add several players with different skins in one post/page
* fixed: the "Send to Editor" button became non-functional if the media library window was closed without choosing media

= 0.3.0 - 16 January 2013 =
* now in the posting UI the height of the player is calculated based on video's aspect ratio
* added option to show the logo also in the origin site, and not just only in virally embedded players

= 0.2.0 - 16 January 2013 =
* fixed to work when this plugin is symlinked in the wp-content/plugins directory
* fixed link to plugins configuration page
* fixed player scaling, does not use a fixed player size any more
* added an option to make the player size fixed

= 0.1.0 - 4 January 2013 =
* Initial release

== Upgrade Notice ==

= 1.12.0 =
* added lightbox support, added hlsjs plugin and fixed bugs

= 1.11.0 =
* update to Flowplayer 6 and fix a few bugs

= 1.10.7 =
* fix bugs and add support for WP 4.2

= 1.10.6 =
* fix bugs with playing videos

= 1.10.5 =
* fix bugs with Flowplayer Drive and playing videos

= 1.10.4 =
* fix bugs with Flowplayer Drive and playing videos on the blog page

= 1.10.3 =
* fix bugs with Flowplayer Drive and Playlist

= 1.10.2 =
* fix numerous bugs with playlists

= 1.10.1 =
* update to Flowplayer 5.5.2, add live streaming support & code improvements

= 1.10.0 =
* add complete multi-resolution support and fixed bug

= 1.9.4 =
* bug fixes: IMPORTANT!: changed class from `.flowplayer` to `.flowplayer-video`

= 1.9.3 =
* bug fixes

= 1.9.2 =
* bug fixes and small improvements

= 1.9.1 =
* bug fix

= 1.9.0 =
* adding playlist support & Flowplayer HTML5 5.5.0

= 1.8.0 =
* introducing Flowplayer Drive and Google AdSense support

= 1.7.0 =
* add full support for flash video file, rtmp and hls

= 1.6.0 =
* add more customisation options

= 1.5.0 =
* update to Flowplayer HTML5 5.4.6

= 1.4.0 =
* new video widget

= 1.3.0 =
* code improvements

= 1.2.0 =
* add videos from Flowplayer Designer directly in the admin area

= 1.1.0 =
* add small new features

= 1.0.0 =
* big plugin rewrite

= 0.5.0 =
* bugs fixed

= 0.4.0 =
* fixes a critical issue with the media library

= 0.2.0 =
* Bugs fixed. Player size is no longer fixed: Works better on different screen sizes.

= 0.1.0 =
* This is the first stable release.