Music Player for Easy Digital Downloads

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
• Includes a block to insert the playlists on pages using Gutenberg
• Includes a widget to insert the playlists on pages using Elementor
• Includes a widget for inserting the playlists on pages with Page Builder by SiteOrigin
• Includes a control for inserting the playlists on pages with BeaverBuilder
• Includes an element for inserting the playlists on pages with Visual Composer
• Includes a module for inserting the playlists on pages with DIVI

Note: for the other editors, insert directly the playlists’ shortcodes.

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.

MediaElement.js is an music player compatible with all major browsers: Internet Explorer, MS Edge, 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.

The basic version of the plugin, available for free from the WordPress Directory, has the features needed to include a music player in the pages of the downloads and the store.

Premium Features

• Allows playing the audio files in secure mode to prevent unauthorized downloading of the audio files.
• Allows to define the percent of the audio file’s size to be played in secure mode.
• Allows to store the generated audio files in Google Drive (when the truncate feature is enabled).

Interface

Global Settings of Music Players

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

• 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).
• Loop: plays the audio player on the product page in a loop.
• Player controls: determines the controls to include in the music player.
• Visualizer: For “all controls” mode, display the visualizer component over the 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 downloads pages in the website: tick the checkbox to apply the previous settings to all downloads overwriting the downloads’ settings.

Google Analytics Integration

• Tracking id: Enter the tracking id in the property settings of Google Analytics account.

Setting up the Music Players through the downloads’ pages

The Music Players are configured from the downloads pages.

Settings Interface

• Include music player: checkbox to include the music player in the download’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).
• Loop: plays the audio player on the product page in a loop.
• Player controls: determines the controls to include in the music player.
• Visualizer: For “all controls” mode, display the visualizer component over the 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 download’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 website.

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.
• 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 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="*"]
  

• player_style: select the layout of music players (the playlist displays only the play/pause control):

  [eddmp-playlist downloads_ids="*" player_style="mejs-classic"]
  

• 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_download="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"]
  

• 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.

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

Hooks (actions and filters)

• 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_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 when the FFmpeg application is used to generate them.

Other recommended plugins

• Music Player for WooCommerce
• Music Store – WordPress eCommerce
• CP Media Player – Audio Player and Video Player

Multilingual Support (WPML)

The plugin ships with a wpml-config.xml file in the plugin root that registers the three custom fields used by the “Select my own demo files” feature with WPML:

• _eddmp_demos_list
• _eddmp_own_demos
• _eddmp_direct_own_demos

All three are registered with action=”copy-once”, which means:

• When a new translation is created, the demo files and their activation flags are copied from the source language to the new translation at creation time.
• Once the translation exists, subsequent updates to the source language do NOT overwrite the translation. Editors can customise per-language demos (for example, to use a sample with a different voiceover or accent) without losing their changes on the next source save.

This is the conservative default that does not change behaviour for sites that do not explicitly opt in. If your site should propagate demo file changes from the source language to all translations on every update, go to WPML -> Settings -> Custom Field Translation and change the action for each of the three fields above from “Copy once” to “Copy”.

After updating the plugin (or after first activation on a site that has WPML installed), go to WPML -> Support -> Troubleshooting and click Clear cache in WPML so the new configuration is picked up.