Product type: Wordpress Plugin

Music Player for Easy Digital Downloads

Music Player for Easy Digital Downloads includes the MediaElement.js music player in the pages of the downloads with audio files associated, and in the store's pages, furthermore, the plugin allows selecting between multiple skins.

The plugin allows playing the audio files in secure mode to prevent unauthorized downloading of the files for selling.

FEATURES

Music Player for Easy Digital Downloads features:

  • Includes an audio player that supports formats: OGA, MP3, WAV, WMA
  • Includes multiple skins for the Music Player
  • Supports all most popular web browsers and mobile devices
  • Includes a widget to insert a playlist on sidebars
  • Allows playing the audio files in secure mode to prevent unauthorized downloading of the files for selling
  • Allows to define the percent of the audio file's size to be played in secure mode

Music Player for Easy Digital Downloads includes the MediaElement.js music player in the pages of the products with audio files associated, and in the store's pages, furthermore, the plugin allows selecting between multiple skins.

MediaElement.js is an music player compatible with all major browsers: Internet Explorer, Firefox, Opera, Safari, Chrome and mobile devices: iPhone, iPad, Android. The music player is developed following the html5 standard. The music player supports the following file formats: MP3, WAV, WMA and OGA.

Installation

To install Music Player for Easy Digital Downloads, follow these steps:

  1. Download zip file with the plugin's code
  2. Go to the plugins section on website
  3. If the free version of the plugin was installed previously, deactivate and delete it first (the process does not affect to the players configured previously)
  4. Press the "Add New" button at top of plugins section
  5. Press the "Upload Plugin" button, and select the zipped file downloaded in the first step
  6. Finally, install and activate the plugin

After installing the plugin, if the version installed is the commercial one. Go to the settings page of the plugin, through the menu option: "Settings > Music Player for Easy Digital Downloads", and register your copy of the plugin, entering the same email address used to purchase it, to receive the updates directly on your WordPress.

Interface

General Settings

The global settings are accessible through the menu option: "Settings/Music Player for Easy Digital Downloads".

The global settings includes the following list of attributes to process all downloads at once:

Include music player in all all downloads: checkbox to include the music player in all downloads.

Include in: radio button to decide where to display the music player, in pages with a single entry, multiple entries, or both (both cases by default).

Include players in cart: checkbox to include the music players on the cart page or not.

Player layout: list of available skins for the music player.

Preload: to decide if preload the audio files, their metadata, or don't preload nothing at all.

Play all: play all players in the page (one after the other).

Player controls: determines the controls to include in the music player.

Display the player's title: show/hide the name associated to the downloadable file.

Protect the file: checkbox to playback the songs in secure mode (only available in the pro version of the plugin).

Percent of audio used for protected playbacks: integer number from 0 to 100, that represents the percent of the size of the original audio file that will be used in the audio file for demo (only available in the pro version of the plugin).

Apply the previous settings to all download pages in the website: tick the checkbox to apply the previous settings to all downloads overwriting the downloads' settings.

General Settings

FFMPEG Integration

Allows the integration with the ffmpeg application in the server to generate the truncated version of files to be used as demos.

Pay attention to the "Watermark audio" feature. This experimental feature allows you to generate the audio files for demos with a watermark audio playing in the background.

The "Watermark audio" is only applied if the audio files for demos are generated with the FFmpeg application and were ticked the "Protect the file" checkboxes in the players' settings.

Cloud integration

The plugin allows to store the audio files for demo in Google Drive, for that it is necessary to tick the Store demo files on Google Drive checkbox, and upload the JSON Key file.

To create an OAuth 2.0 client ID in the console:

  1. Go to the Google Cloud Platform Console.
  2. From the projects list, select a project or create a new one.
  3. If the APIs & services page isn't already open, open the console left side menu and select APIs & services.
  4. On the left, click Credentials.
  5. Click + CREATE CREDENTIALS, then select OAuth client ID.
  6. Select the application type Web application.
  7. Enter Easy Digital Downloads Music Player in the Name attribute.
  8. Enter the URL below as the Authorized redirect URIs:

    https://www.yourwebsite.com/?eddmp-drive-credential=1

  9. Press the Create button.
  10. In the OAuth client created dialog, press the DOWNLOAD JSON button and store it on your computer, and press the Ok button.
  11. Finally, select the downloaded file through the Import OAuth Client JSON File.

To get API Key:

  1. Go to the Google Cloud Platform Console.
  2. From the projects list, select a project or create a new one.
  3. If the APIs & services page isn't already open, open the console left side menu and select APIs & services.
  4. On the left, click Credentials.
  5. Click + CREATE CREDENTIALS, then select API Key.
  6. Copy the API Key.
  7. Finally, paste it in the API Key attribute.

Troubleshoot Area

Furthermore includes a troubleshoot to deal with the most common issues.

Analytics Area

Allows the integration with Google Analytics for registering new events when the songs are played. The event information would include: the URL to the audio file as the event label and the downloads's id as its value.

Note: If the preload option is configured as Metadata or Auto in the players settings, the event would be registered when the audio file is loaded by the player and not exactly when they are playing.

In the download's Settings.

The interface of player's settings in the pages of downloads is very similar to the global settings, but affecting only to a specific downloads.

Setting up the Music Players

The Music Players are configured from the products pages.

Include music player: checkbox to include the music player in the product's page, or not.

Include in: radio button to decide where to display the music player, in pages with a single entry, multiple entries, or both (both cases by default).

Player layout: list of available skins for the music player.

Preload: to decide if preload the audio files, their metadata, or don't preload nothing at all.

Play all: play all players in the page (one after the other).

Player controls: determines the controls to include in the music player.

Display the player's title: show/hide the name associated to the downloadable file.

Protect the file: checkbox to playback the songs in secure mode (only available in the pro version of the plugin).

Percent of audio used for protected playbacks: integer number from 0 to 100, that represents the percent of the size of the original audio file that will be used in the audio file for demo (only available in the pro version of the plugin).

Select my own demo files: checkbox to use different audio files for demo, than the audio files for selling (only available in the pro version of the plugin).

Demo files: section similar to the audio files for selling, but in this case it allows to select different audio files for demo, and their names (only available in the pro version of the plugin).

How the Pro version of the Music Player for Easy Digital Downloads protect the audio files?

If the "Protect the file" checkbox was ticked in the product's page, and was entered an integer number through the attribute: "Percent of audio used for protected playbacks", the plugin will create a truncated copy of the audio files for selling (or the audio files for demo) into the "/wp-content/plugins/eddmp" directory, to be used as demo. The sizes of the audio files for demo are a percentage of the sizes of the original files (the integer number entered in the player's settings). So, the users cannot access to the original audio files, from the public pages of downloads.

Music Player for Easy Digital Downloads - Playlist Widget

The widget allows to include a playlist on sidebars, with the downloadable files associated to all downloads with the music player enabled, or for only some of the downloads.

The widget settings:

Title: the title of the widget on sidebar.

Downloads IDs: enter the ids of downloads to include in the playlist, separated by comma, or the * symbol to include all downloads.

Player layout: select the layout of music players (the widget uses only the play/pause control)

Preload: to decide if preload the audio files, their metadata, or don't preload nothing at all. This attribute has a global scope, and will modify the default settings.

Play all: play all players in the page (one after the other). This attribute has a global scope, and will modify the default settings.

Display file name: if the checkbox is ticked, the playlist will include the name of the downloadable file, or the download's name if it is unchecked.

Highlight the current download: if the checkbox is ticked, and the user is in the page of a download, and it is included in the playlist, the corresponding item would be highlighted in the playlist.

Continue playing after navigate: if the checkbox is ticked, and there is a song playing when navigates, the player will continue playing after loading the webpage, in the same position.

Note: In mobiles devices and some browsers where the direct action of user is required for playing audios and videos, the plugin cannot start playing dynamically.

Music Player for Easy Digital Downloads - [eddmp-playlist] shortcode

The [eddmp-playlist] shortcode allows to include a playlist on the pages' contents, with all downloads, or for some of them.

The shortcode can be inserted into the classical WordPress editor.

...but it includes to a block for the Gutenberg editor

a widget for the Elementor editor

a widget to use with the Page Builder by SiteOrigin

a control for inserting the playlists on pages with BeaverBuilder

and an extension for inserting the playlists on pages with Visual Composer

The shortcode attributes are:

downloads_ids: define the ids of downloads to include in the playlist, separated by comma, or the * symbol to include all downloads:
[eddmp-playlist downloads_ids="*"]

purchased: load the downloads purchased by the registered user:
[eddmp-playlist purchased="1"]

player_style: select the layout of music players (the playlist displays only the play/pause control):
[eddmp-playlist products_ids="*" player_style="mejs-classic"]

file_name: if the value is 1 the playlist will include the name of the downloadable file, or the product's name if it is 0:
[eddmp-playlist products_ids="*" file_name="1"]

highlight_current_download: if the playlist is included in a download's page, the corresponding item would be highlighted in the playlist:
[eddmp-playlist downloads_ids="*" highlight_current_product="1"]

continue_playing: if there is a song playing when navigates, the player will continue playing after loading the webpage in the same position:
[eddmp-playlist downloads_ids="*" continue_playing="1"]

controls: allows to define the controls to be used with the players on playlist. The possible values are: track or all, to include only a play/pause button or all player's controls respectively:
[eddmp-playlist downloads_ids="*" controls="track"]

loop: plays all playlist items in an endless loop. The accepted values are: 1 or 0: [eddmp-playlist downloads_ids="*" loop="1"]

cover: allows to include the featured images in the playlist. The possible values are: 0 or 1, 0 is the value by default
[eddmp-playlist downloads_ids="*" cover="1"]

hide_message: hides the message about partial playback of demo audios
[eddmp-playlist hide_message="1"]

class: assigns a class name to the players' container to customize them easier
[eddmp-playlist downloads_ids="*" class="class-name"]

Note: In mobiles devices where the direct action of user is required for playing audios and videos, the plugin cannot start playing dynamically.

Hooks (actions and filters)

eddmp_main_player and eddmp_all_players: these actions allow the themes' developers to insert the players in the preferred places of the downloads' pages and the stores' items.

eddmp_before_player_shop_page: action called before the players containers in the shop pages.

eddmp_after_player_shop_page: action called after the players containers in the shop pages.

eddmp_before_players_download_page: action called before the players containers in the downloads pages.

eddmp_after_players_download_page: action called after the players containers in the downloads pages.

eddmp_save_setting: action called when the general settings are saved.

eddmp_general_settings: action called in the general settings to generate new attributes.

eddmp_delete_file: action called when a file is deleted. Receives as parameters the download's id and the file's url.

eddmp_delete_post: action called when a download is deleted. Receives as parameter the download's id.

eddmp_play_file: action called before generate the demo files. It receives two parameters, the download's id and the URL to the audio file.

eddmp_truncated_file: action called after generate the demo files. Receives three parameters: the download's id, the URL to the source audio file and the path to the generated file.

eddmp_audio_tag: filter called when the audio tag is generated. The callback function receives three parameters: the audio tag, the download's id, and the file's id.

eddmp_file_name: filter called when the file's name is included with the player. The callback function receives three parameters: the file's name, the download's id, and the file's id.

eddmp_widget_audio_tag: filter called when the audio tag is generated as a widget on sidebars. The callback function receives three parameters: the audio tag, the download's id, and the file's id.

eddmp_widget_file_name: filter called when the file's name is included with the player as a widget on sidebars. The callback function receives three parameters: the file's name, the download's id, and the file's id.

eddmp_purchased_download: filter called to know if the download was purchased or not. The callback function receives two parameters: false and the download's id.

eddmp_ffmpeg_time: filter called to determine the duration of truncated copies of the audio files for demos, in seconds, when the FFmpeg application is used to create them. By default, when the FFmpeg application is used to generate the audio files for demos, the durations of the new audio files are determined as a percentage of the original files' durations.

DOWNLOAD


Basic Version
Free
  • Includes a music player in the downloads pages with audio files associated
  • Includes multiple skins for the music player
  • Doesn't include technical support (60 days of support service can be purchased for EUR 25)
download Music Player for Easy Digital Downloads
Direct download link.
No registration required.
Professional Version
EUR 
€29
.99
  • Protects the audio files from unauthorized users
  • Allows to define the size of the audio files for demo
  • Allows to associate audio files to the products to be used for demo, independent of the audio files for selling
  • Allows the integration with Google Drive to store the demo files
  • Includes 60 days of technical support



After payment you will be redirected to a direct-download page and the download link will be emailed to the payment address.

The cost of the pro version is a one-time payment required to download it. The one-time payment gives you right to use the plugin in your websites for an unlimited time, access to future updates and access to 60 days of free technical support.