=== CP Media Player - Audio Player and Video Player ===
Contributors: codepeople
Donate link: https://cpmediaplayer.dwbooster.com
Tags: video player,audio player,music player,mp4,m4a,m4v,mp3,ogg,webm
Requires at least: 3.0.5
Tested up to: 7.1
Stable tag: 1.3.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

CP Media Player - Audio and Video Player supported by major browsers, such as IE, Firefox, Opera, Safari, Chrome, and mobile devices: iPhone, iPad, Android (tablets and mobiles).

== Description ==

CP Media Player - Audio and Video Player features:

♪ Publish Audio and Video players anywhere
♪ Support for audio and video files: MP4, OGG, WebM, MP3, M4A, WAV
♪ Support WebSRT subtitle files
♪ Allow playlist
♪ Allow downloading
♪ Supported most popular browsers: Edge, Firefox, Chrome, Safari, Opera, Brave, IE...
♪ Supported by mobile devices: iPhone, iPad, and Android devices


**CP Media Player - Audio and Video Player** allows playing multiple file formats: MP4, OGG, WebM, MP3, WAV, and loading WebSRT subtitle files. **CP Media Player - Audio and Video Player** is based on MediaElement.js, supporting all browsers that implement the HTML5 standard.

> To make the players responsive, essential in mobile devices, enter the player's width in percentage, Ex. 100%

**Other Features**

* Allows publishing audio and video players anywhere(posts, pages, or directly on template files).
* Support popular audio and video files: MP4, M4A, OGG, WebM, MP3, WAV,  and WebSRT subtitle files.
* Includes **several skins** with the audio and video player.
* Supports most browsers on the web: Edge, Firefox, Chrome, Safari, Opera, Brave, IE, etc. As well as mobile devices such as iPhone, iPad, and Android.

> The plugin allows you to associate directories to the players to generate playlists with the contained media files (use "/" to load all media files in the "Uploads" directory and subdirectories).

**Premium Features**

[Premium features](https://cpmediaplayer.dwbooster.com/download) are available in the pro version to extend the capabilities of the plugin:

* Allows [protecting the audio files](https://cpmediaplayer.dwbooster.com/documentation#protecting-audio-files). If FFmpeg is installed on the server, the plugin allows you to protect the audio files by embedding a watermark audio layer and generating truncated copies of files for demos.
* Allows [selling files](https://cpmediaplayer.dwbooster.com/documentation#paypal-integration) from the player. It uses PayPal as the payment gateway. Payments are SCA ready (Strong Customer Authentication), compatible with the new Payment services (PSD 2) - Directive (EU)
* Includes sales reports.

The plugin includes the integration with the following editors:

* Gutenberg Editor.
* Classic WordPress Editor.
* Elementor.

For other editors, insert the player's shortcodes into general-purpose blocks orm modules, like text or HTML.

[youtube https://youtu.be/YJSkEdkDJM8]

**Demo of Premium Version of Plugin**

[https://demos.dwbooster.com/audio-and-video/wp-login.php](https://demos.dwbooster.com/audio-and-video/wp-login.php "Click to access the Administration Area demo")

[https://demos.dwbooster.com/audio-and-video/](https://demos.dwbooster.com/audio-and-video/ "Click to access the Public Page")

Additional details about the "CP Media Player - Audio and Video Player" plugin by visiting its website:

[https://cpmediaplayer.dwbooster.com](https://cpmediaplayer.dwbooster.com "Audio and Video Player")

== Installation ==

**To install CP Media Player - Audio and Video Player, follow the steps below:**

1. Download the .zip file with the plugins' code to your computer.
2. Go to the Plugins section on your WordPress.
3. Press the "Add New" button at the top of the Plugins section.
4. Press the "Upload Plugin" button and selects the zipped file downloaded in the first step.
5. Finally, install and activate the plugin.


== Using the Music and Video Player ==

**Generating the players directly on the pages and posts**

**Audio players**

[youtube https://youtu.be/YJSkEdkDJM8]

**Video Player**

[youtube https://youtu.be/QG5gGBnVqB0]

It is possible to generate the player by coding entering the player and items shortcodes into the page's content:

	[cpm-player skin="ball-skin" width="100%" playlist="true" type="audio"]
	[cpm-item file="http://www.wp.local/wp-content/uploads/2018/11/1.mp3"]Audio 1[/cpm-item]
	[cpm-item file="http://www.wp.local/wp-content/uploads/2018/11/2.mp3"]Audio 2[/cpm-item]
	[cpm-item file="http://www.wp.local/wp-content/uploads/2018/11/3.mp3"]Audio 3[/cpm-item]
	[/cpm-player]

To generate the player loading the audio files from the "/wp-content/uploads/2020" directory:

	[cpm-player skin="ball-skin" width="100%" playlist="true" type="audio" dir="2020" /]

The player can load the audio files indicating the directory only. It allows you to add new files to the directory or delete the existing ones, and the player will update the playlist dynamically.

[youtube https://youtu.be/O-IAv4Ij-_0]

The complete list of attributes supported by the shortcodes is available on the [documentation page of the plugin](http://cpmediaplayer.dwbooster.com/documentation#cpm-player-attributes "The attributes supported by the shortcodes").

**Generating the audio and video players from the players gallery**

> To make the players responsive, essential in mobile devices, enter the player's width in percentage, Ex. 100%

Configure the players from the gallery allows you to insert the same player on multiple websites' pages or posts.

[youtube https://youtu.be/WS449LCClA8]

The detailed description of the players' settings is available in the following link: [Creating the players through the players' gallery](http://cpmediaplayer.dwbooster.com/documentation#creating-players-through-players-gallery "Creating the players through the players' gallery")

The [premium version of **CP Media Player - Audio and Video Player**](https://cpmediaplayer.dwbooster.com/download) allows you to sell files from the players. [Configuring the integration with PayPal](http://cpmediaplayer.dwbooster.com/documentation#paypal-integration "Configuring the integration with PayPal").

**Other recommended plugins**

* [Music Player for WooCommerce](https://wordpress.org/plugins/music-player-for-woocommerce/ "Music Player for WooCommerce")
* [Music Player for Easy Digital Downloads](https://wordpress.org/plugins/music-player-for-easy-digital-downloads/ "Music Player for Easy Digital Downloads")

== Frequently Asked Questions ==

= Q: How I know about the new skins for CP Media Player - Audio Player and Video Player? =

A: The skins list in the settings page of the plugin is updated dynamically.

= Q: Why can I enter several audio files per item? =

A: The browsers support different formats of audio and video. So, you can enter an audio file supported by every browser. Or you can enter all disposable files format per item to allow the browsers to play the audio format they support.

= Q: How to enter multiple subtitle files, one per language? =

A: Press the "Add another one" button in the item settings, and enter the data related to the new subtitles, the file, and language.

= Q: Can I sell all the album files? =

A: You can play some of the audio files through the media player, but selling the complete album by selecting a zip file for selling with every album file.

= Q: What audio formats does my browser support? =

A: The audio formats supported by browsers are available on the following link:
[http://www.w3schools.com/html/html5_audio.asp](http://www.w3schools.com/html/html5_audio.asp)

= Q: What video formats does my browser support? =

A: The video formats supported by browsers are available on the following link:
[http://www.w3schools.com/html/html5_video.asp](http://www.w3schools.com/html/html5_video.asp)

== Screenshots ==

1. Audio Player and Video Player
2. Create Player
3. Inserting the Player using the Gutenberg editor
4. Inserting the Player using the Elementor page builder
5. Inserting the Player using the classic WordPress editor
6. Inserting a New Audio or Video Player

== Changelog ==

= 1.3.1 =

* Enhances plugin security by restricting the type attribute to two valid options and sanitizing all shortcode attributes. (Thanks to dutafi and the Patchstack team.)

= 1.3.0 =

* Improves the Elementor integration.

= 1.2.9 =

* Improves the integration with WordPress 7.0.

= 1.2.8 =
= 1.2.7 =

* Updates the module that filters media resources during dynamic playlist generation to prevent audio and video files from being merged when the player is configured for audio-only or video-only playback.

= 1.2.6 =

* Improves the plugin interface.

= 1.2.5 =

* Resolves a compatibility issue with WordPress version previous to 5.5.

= 1.2.4 =

* Fixes a conflict with Elementor's cache which is currently in Beta.

= 1.2.3 =

* Allows playing only one player at once on mobiles devices.

= 1.2.2 =

* Modifies the Gutenberg block.
* WP6.6 compatibility.

= 1.2.1 =

* Fixes an issue with files URLs containing %20 characters.
* Removes deprecated JS code.

= 1.2.0 =

* Improves the plugin security. Thanks to the security researcher Steven Julian, and Patchstack team.
* Fixes an issue in the download files link.