This plugin hasnt been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

FAQ

Search for ‘mp3-jplayer’ and hit the ‘Install now’ link in the results, WordPress will install it.

Activate the plugin.

Install manually:

Download the zip file and unzip it.

Open the unzipped folder and upload the entire contents (1 folder and it’s files and subfolders) to your /wp-content/plugins directory on the server.

Activate the plugin through the WordPress ‘Plugins’ menu.

Supported file formats ?

mp3, m4a, mp4, oga, ogg, wav, webm, webma.

Theme requirements ?

Themes need the standard wp_head() and wp_footer() calls in them.

Can’t locate audio message ?

Check your filename/url spelling if you’re writing them manually. Remove any accented letters from mp3 filenames (Delete the originals and re-upload if they’re from the library).

Player doesn’t show up ?

This will happen if the playlist you’ve asked for doesn’t result in anything to play, for example if you’re using ‘FEED’ and the folder path is incorrect or remote, or if you’re playing remote urls and the option ‘allow mp3s from other domains’ is unticked.

Header and footer players ?

Use widget areas if available, or you can use the do_shortcode() function in template files.

Player shows but doesn’t work ?

Most times it’s because of a hard-coded javascript that’s in your theme or another plugin. Try switching to a default WordPress theme and see if the player works. Try deactivating other plugins one-by-one and check each time to see if the player works.

Reviews

Working but have no much design and option for player control. The good thing is this player support any type of Radio stream link which is excellent. I’ll give 5 stars if possible to make a player like this https://i.imgur.com/s9ehQl5.png

I was looking for this kind of player for hours and found it by mistake while trying to install another plugin.
It should be described as: Responsive audio playlist player with shuffle mode and download option

All the other plugins I found had those futures only in pro version or where undated.

2.6

The plugin can now be translated. The .pot file is in the ‘lang’ folder of the plugin.

2.5

New feature: Auto Resume, gives near-continuous audio between pages (there will be a short pause as the next page loads). Resuming will work wherever you have used the same piece of audio across pages.

Added pagination controls to the Media Library files list on the settings page.

Updated plugin security.

2.4.2

Added new developer hook on settings page (players tab), to support the upcoming Single Player Downloads add-on.

Updated javascript GMT methods with the current standard UTC methods.

2.4.1

Compatibility update for WordPress 4.3, see this thread for more info.

Fixed the settings page php notices that could occur in some scenarios.

2.4

Added a simple colour scheme setting for the single file players that allows very easy theming.

Added new track title and captioning settings, allowing you to choose which ID3 data to display for your media library files. Choose from title, artist, album, caption, and upload date.

Added an option to flip the playlist player controls to the left. Use the modifier name ‘flip’ on the design page or in a shortcode.

Added an option to display track captions within the playlists.

2.3.3

Added an option to use ID3 tag info for the track titles. The option is on the settings page under the files tab. Notes: 1)This option is for files uploaded to your media library only. 2)When selected players will display the title and artist info from the media’s ID3 meta captured during upload. 3)This feature is supported in WP 3.6 and higher.

Added a settings page option for single file players to position the play button on the left or right hand side (equivalent to using the shortcode param ‘flip’).

Fixed library title pickup that was failing in certain scenarios.

Added some new developer hooks.

2.3.2

Fixed the pick-up of titles and images when playing attached audio using the playlist widget.

Added ordering options for attached audio. Any audio attached to a page or post will now be ordered according to your setting on the player’s ‘Settings’ page. You can order them by title or upload date, for any other setting they’ll default to WP’s menu order. ASC/DESC controls the direction.

Improved the ‘novol’ class for hiding volume controls, and added new modifier names ‘nobars’, ‘nocase’ which let you hide the bars, and the button bar background on playlist players.

Improved js robustness for increased compatibility across different themes/setups.

Added new developer methods – provide a volume scale factor (MP3_JPLAYER.factors.vol), and provide the available image data to callbacks regardless of the player or list type.

2.3.1

Added developer methods for hooking into the player’s Javascript events, these also add support for some of the up-coming extensions.

Corrected the help message admin-side that shows on the widget when it’s set to an invalid path.

2.3

Fixed an issue on index/cat/search type pages that could incorrectly assign the playlists or break players in some scenarios.

Added support for custom js (for skin extensions) on the player Design page.

Renamed the MP3-jPlayer plugin class instance to MP3JP.

2.2

Simplified error handling to try and eliminate the false triggering of messages that was occurring on some devices.

Added an option to control the frontend display of player error messages, the options are: Never / To admins only / To all. The setting is under advanced tab, default is admins only.

Fixed the bug on index/cat pages that broke players in some scenarios when using the ‘Show in full content’ and ‘Show in excerpts’ options.

Fixed the functioning of ‘Show in excerpts’ option (this option is still for manually written excerpts only).

Added support in the popout player for the stats collection modules (allows play and download via the popout to be captured).

Some css hardening on jQuery ui components.

2.1

Fixed plugin compatibility with old versions of WP pre 3.6.

Fixed the widget’s folder feed (it was picking up all audio regardless of chosen formats), and the admin-side info message that shows the track count.

Added a ‘Show images’ tick option on the widget (this controls the display of any featured images that you’ve set for the audio).

Made player’s download link immediately visible upon page load (previously users needed to start a track in order to make the first download link available).

2.0

Improved plugin integration with core WordPress media handling operations, such as those accessed with the ‘Add Media’ button, featured images for audio, embeded audio, attached audio, and pasted urls.

Added support for all common file formats, the plugin now supports mp3, m4a, mp4, oga, ogg, wav, webm, webma files. Caution – Please see Audio Format Advice for help with choosing good formats for the web.

Added a player design page with many new options for controlling font faces, sizes, alignments, and image size and alignment and more within the players.

Added optional auto-counterparting feature that will work for FEEDs as well as individually playlisted local files.

Added new skins that are more mobile friendly.

Fixed autoplay behavior so that it doesn’t try to activate on handheld devices (currently most mobile devices disallow autoplay).

Added integration options allowing for selective replacement of core WP features and players.

Added feedback messages for catching broken urls easily, and when a device cannot play the supplied file(s).

Many more improvements and enhancements both admin-side and frontend.

1.8.12

Security update.

1.8.11

Fixed a routine that could throw PHP warnings on servers running old versions of PHP (lower than 5.3).

Added support for WP’s do_shortcode() function. You need to be running WordPress 3.3 or higher for it to work. This also means that from WP 3.3 the plugin’s template tags mp3j_addScripts() and mp3j_put() are no longer needed (though they are still supported for backwards compatibility).

1.8.10

Fix popout.

Add support for players in hidden elements (it’s now handled automatically).

Start admin improvements (settings is now a top level menu).

1.8.9

Fix for Android/Chrome. For info on the fix see Mark Panaghiston’s posts at the bottom of this jPlayer thread.

1.8.8

Updated jQuery.jPlayer to 2.6.0.

Improved admin-side security.

Fixed compatibility with ‘Scripts to Footer’ plugin.

Fixed a routine that could throw a php warning.

1.8.7

Fixed autoplay in the popout when using the popout shortcode [mp3-popout].

Improved widget detection for scripts to allow for core’s wp_convert_widget_settings.

1.8.5

1.8.4

1.8.3

Moved to jQuery.jPlayer 2.2.0 (fixes plugin problems with recent flash release (v11.6) in browsers like IE and Firefox (time was displaying as ‘NaN’, tracks not advancing/autoplaying)).

Fixed the auto number option for arbitrary single players (they were all numbered 1!).

Fixed quotes in captions (they were unescaped still and would break players), thanks to Chris for reporting.

Fixed a couple of routines that could throw php warnings, thanks to Rami for reporting.

Added the much requested option to try force browsers into saving mp3 downloads (instead of playing them in some kinda built-in player). Maintains right click save-ability. No mobile support just yet. Switched on for local files by default. Can also be set up for remote files (see the help). Option is under ‘Playlist player options’ on the settings page. Please feedback any issues.

Added option to turn any mp3 links in a page into players, which means you can now add players using the ‘Add media’ button on the page/post edit screens. It has as an editable shortcode on the player settings page (under template options). Option is on by default. Switch it off near top of settings page.

Added the ‘style’ parameter onto the MP3j-ui widget.

1.8.1

Some css corrections – missing image for the buttons on the ‘custom’ style, and the smaller font sizes when using the ‘mods’ option.

1.8

Fixed bug in javascript that caused problems in WordPress 3.5 (players broke after a couple of clicks).

Fixed bug when single quotes ended up in a popout title (it broke players).

Fixed bug in widget when it was set with a non-existent page id (it broke players).

Fixed bug with mp3j_put function (it could pick up the adjacent post’s tracks in some scenarios).

Fixed bug with https urls.

Fixed bug in pick parameter.

Fixed bug with ‘Allow mp3s from other domains’ option (it affected single players when it was unticked).

Fixed display of hours on long mp3s (player will display the hours only when needed).

Fixed css that was hiding playlists in Opera browser.

Fixed titles running into captions.

Fixed titles obscuring slider motion (not IE proof).

Added ‘images’ parameter on [mp3-jplayer], they can be set per track and are carried to the popout.

1.3.1

Fixed image rollover on buttons when wordpress not installed in root of site.

1.3.0

First release on WordPress.org

Updated jquery.jplayer.min.js to version 1.2.0 (including the new .swf file). The plugin should now work on the iPad.

Fixed admin side broken display of the uploads folder path that occured when a path had been specified but didn’t yet exist.

Fixed the broken link to the (new) media settings page when running in WordPress 3.

Changed the ‘Use my media library titles…’ option logic to allow any titles or captions to independently over-ride the library by default. The option is now ‘Always use my media library titles…’ which when ticked will give preference to library titles/captions over those in the custom fields.

Modified the css for compatibility with Internet Explorer 6. The player should now display almost the same in IE6 as in other browsers.

1.2.12

Added play order setting, a ‘download mp3’ link option, show/hide playlist and option, a connecting state, a new style.

The ‘Default folder’ option can now be a remote uri to a folder, if it is then it doesn’t get filtered from the playists when ‘allow remote’ is unticked.

1.2.0

Added playing of media library mp3’s in the same way as from the default folder (ie. by entering just a filename). User does not have to specify where the tracks reside (recognises library file, default folder file, and local or remote uri’s).

Added filter option to remove off-site mp3’s from the playlists.

The plugin now clears out it’s settings from the database by default upon deactivation. This can be changed from the settings page.

It’s no longer necessary to include the file extension when writing filenames.