=== Bradmax Player ===
Contributors: kostalski
Tags: video, html5, video streaming, HLS, MPEG-DASH, MS Smooth Streaming, embed video, responsive
Requires at least: 4.2
Tested up to: 4.9
Stable tag: 1.0.2
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html
Author URI: https://bradmax.com/
Author: Bradmax
Version: 1.0.2

Embed video stream easily in WordPress using Bradmax Player. Use responsive HTML5 video player for playing HLS, MPEG-DASH, MS Smooth Streaming streams.

== Description ==

[Bradmax Player](https://bradmax.com/site/en/player) is a plugin, which supports video streams playback on desktops and mobile devices. If you have access to video streaming in formats:
- HLS
- MPEG-DASH
- MS Smooth Streaming
or simple mp4, webM, ogg files, then you can watch them on your site with Bradmax Player. It is even supporting HLS or MS Smooth Streaming playback on platforms / devices, which 
usually not support them. In such cases video is "transconded" on-fly in your browser during playback.

= Requirements =

* A self-hosted website running on WordPress CRM.

= Bradmax Player Features =

* Embed video streams into a post/page or anywhere on your WordPress site (supported streaming formats HLS, MPEG-DASH, MS Smooth Streaming).
* Embed video files (MP4, WebM, Ogg) into your page.
* Embed responsive videos for a better user experience while viewing from a mobile device.
* Embed videos with poster images.
* Automatically play a video when the page is rendered.
* Embed videos uploaded to your WordPress media library using direct links in the shortcode.
* No setup required, simply install and start embedding videos.
* Lightweight and compatible with the latest version of WordPress
* Clean and sleek player with no watermark.
* Player customisation is available (change skin, colors, logo, etc.). It requires only sign-up on https://bradmax.com/site/en/signup . It's free and basic version of player is also free.

= Bradmax Player Plugin Usage =

In order to embed a video create a new post/page and use the following shortcode:

`[bradmax_video url="https://bradmax.com/static/video/tos/big_buck_bunny.m3u8" duration="596" poster="https://bradmax.com/static/images/startsplash.jpg"]`

* "url" is the location of your streaming. You need to replace the sample URL with the actual URL of the video stream.
* "duration" contain length in seconds of video, so it can be displayed on player before staring playback.
* "poster" is location of poster image, which should be displayed on player. Replace sample URL with link of your image.

= Video Shortcode Options =

The following options are supported in the shortcode.

**Autoplay**

Causes the video file to automatically play when the page loads. 
Note: This option is working only on desktop devices. On mobile devices (phones, tablets, etc.) this option is not working. 
It is platform limitation and clicking on video is required for starting playback

`[bradmax_video url="http://example.com/hls_stream.m3u8" autoplay="true"]`

**Duration**

Defines length of video stream in seconds. Can contain fraction of second. It is required for displaying duration of video before staring playback.

`[bradmax_video url="http://example.com/hls_stream.m3u8" duration="100.1"]`

**Poster**

Defines image to show as placeholder before the video plays.

`[bradmax_video url="http://example.com/hls_stream.m3u8" poster="http://example.com/wp-content/uploads/poster.jpg"]`

**Class**

Defines CSS class, which should be added into player box on page (customizing view on WordPress page).

`[bradmax_video url="http://example.com/hls_stream.m3u8" class="my-custom-player-css-class"]`

**Style**

Defines CSS style string, which should be added into player for on page (customizing view on WordPress page).

`[bradmax_video url="http://example.com/hls_stream.m3u8" style="width:400px;height:200px;border:solid 1px gray"]`


== Installation ==

1. Go to the Add New plugins screen in your WordPress Dashboard
2. Click the upload tab
3. Browse for the plugin file (bradmax-player.zip) on your computer.
4. Click "Install Now" and then hit the activate button.

Or install directly from WordPress Plugin Directory.

== Frequently Asked Questions ==

= Can this plugin be used to embed video streams in WordPress? =

Yes.

= Is HLS supported by this player =

Yes, and what more HLS streams can be displayed even on desktop devices, which natively not support HLS streams.

= Are the videos embedded by this plugin playable on iOS devices? =

Yes.

= Can I embed responsive videos using this plugin? =

Yes.


== Upgrade Notice ==
none

== Changelog ==

= 1.0.1 =

* First version of WordPress plugin.

= 1.0.2 =

* Upgrading default JavaScript player file from version 2.4.2 to 2.4.11 (bugfixes and better support for HLS).