0.4.1

This version was tested with Joomla 4.0.0-alpha2 and is believed appropriate for use with Joomla versions 3 and 4.

• #53 Using HTML5 player, using legacy Dewplayer as the fallback
• Make CSS classes more specific, they were clashing with Joomla 4's "cassiopeia" theme

0.4.0

• Fixed broken indexer
• Making getid3 work on PHP 7
• #37 Fixed broken import
• #38 Using "download" attribute on download anchors to prevent opening a new window (works in modern browsers)
• #62 Components again not working
• #63 Components don't have introtext
• Moved to GitHub and made releasable-ish again
• Added logo file

0.3.1

• Bugs fixed, such as missing DS constants in Joomla 3

0.3.0

• Support Joomla 3 (in addition to 2.5)
• #26 #29 Allow the mp3 plugin to work in components and modules
• Support of non-default (ISO-8859-1) encoding for id3v1 tags
• Hide when empty (configurable)
• Show sub-folders (configurable)
• Made upgradable (without uninstallation step)
• #22 Folder class not loaded

Thanks to contributions from jasonrhl and Reinhold Kainhofer, and others that posted issues.

0.2.7

• Support older PHP version

0.2.6

• Made player configurable (insert your own player HTML)
• Bug fixed for non-ASCII characters in file names

Note that 0.2.4 and 0.2.5 are essentially the same as 0.2.6, but the release and upload process failed, hence these versions were skipped. This was due to the move from GitHub to Google Code that was also done per these versions.

0.2.3

• Cover art and artist search taxonomy
• Anchor per MP3, used in search results
• Bugs fixed, such as compliance with JED

0.2.2

• Rendering options for mobile
• Basic support for using URLs from MP3 tags
• Option to limit download to registered users only
• Cleaned up configuration
• Bugs fixed, such as support of cover art on older IE versions

0.2.1

• Bugs fixed

0.2.0

• Smart Search indexing
• Volume control
• Allow individual music tags to override plugin configuration using parameter attributes such as {music maxRows="15"}...
• Filter files on regular expression
• Date/time sorting options

0.1.0

• Multi-language
• "No items to display" when appropriate
• Cells with cover art, comments and copyright

0.0.1

• Some existing bugs fixed
• Rewrites offering equal functionality to the plugin that this fork was based upon

The music items can either be rendered:

• Using div elements
• table element with rows and cells (default, see screen shot below)
• table element by default, only using div elements for selected template; a template can be chosen. Set this to the template used for mobile visitors, so that for mobile visitors the music items are rendered as div elements, and thus looks much better than as a table does on mobile devices

This is an application example of the mp3 Browser:

Download	Name		Play	Size	Duration
	A Thing Called Love Johnny Cash			2.3 MB	2:32 min
	ABC Jackson 5			2.3 MB	2:53 min
	Breakaway Tracey Ullman			2.4 MB	2:35 min
	Трек 2			4.2 MB	3:11 min

The tag used for the above mp3 Browser instance was: {music}_mp3{/music}

The tag used for the above mp3 Browser instance was: {music}_path_does_not_exist{/music}

Why was this project moved from GitHub, so soon after its inception? And why was it moved back to GitHub again later?

1st Move

On Dec. 11 GitHub announced that it would remove its "upload files" functionality. It would then no longer be possible to offer the final binaries of this project at the same place as the sources and the docs. Google Code has a full offering: source, wiki, downloads. GitHub is an excellent outlet for the things that they offer, but their offering as a whole is incomplete in terms of being a home for projects such as what is needed here.

Some historical statistics at the time of moving — 280 total:

• pkg_mp3browser-0.2.3.zip, 160KB, 216 downloads
• pkg_mp3browser-0.2.3.tar.gz, 159KB, 3 downloads
• pkg_mp3browser-0.2.3.tar.bz2, 158KB, 4 downloads
• pkg_mp3browser-0.2.2.zip, 156KB, 28 downloads
• pkg_mp3browser-0.2.2.tar.gz, 156KB, 3 downloads
• pkg_mp3browser-0.2.2.tar.bz2, 154KB, 3 downloads
• pkg_mp3browser-0.2.1.zip, 151KB, 17 downloads
• pkg_mp3browser-0.2.1.tar.gz, 150KB, 4 downloads
• pkg_mp3browser-0.2.1.tar.bz2, 149KB, 2 downloads

Update

In 2014 Google Code made the same unfortunate decision as GitHub, and discontinued its downloads functionality. The downloads were subsequently moved to here.

Some more historical statistics at the time of moving — 4997 total:

• pkg_mp3browser-0.2.7.zip, 161KB, 3124 downloads
• pkg_mp3browser-0.2.7.tar.bz2, 159KB, 124 downloads
• pkg_mp3browser-0.2.7.tar.gz, 161KB, 81 downloads
• pkg_mp3browser-0.2.6.zip, 161KB, 1464 downloads
• pkg_mp3browser-0.2.6.tar.gz, 161KB, 108 downloads
• pkg_mp3browser-0.2.6.tar.bz2, 159KB, 96 downloads

All total so far: 5277 total

2nd Move

In March 2015 Google announced that it would discontinue Google Code. The project was subsequently moved ("back") to GitHub here, and the documentation was moved to here.

The HTML code that is used to render the audio player can be overridden. Doing so allows the use of alternative players to the one that's used by default.

In the configured HTML code for the player the following placeholders may be used:

There is a chewed out example available.