=== µAudio Player ===
Contributors: jwriteclub
Donate link: http://compu.terlicio.us/
Tags: mp3, flash player, jQuery, audio
Requires at least: 2.0
Tested up to: 2.5.1
Stable tag: 0.2

µAudio is a slim and basic plugin. It does one thing: capture mp3 links and insert a small flash player on click.

== Description ==

µAudio is a slim, fast plugin to create a flash mp3 player when mp3 links are clicked. In order to reduce clutter and file transfer, the links are unmodified until they are clicked, at which point a div with the player is faded in after the link. A second click on the link fades the player back out.

In order to help keep file loads down, the basic javascript is extremely small*. In addition, every effort has been made to use the smallest player possible and generally keep the plugin as small and light as possible.

*µAudio does rely upon jQuery, however, the packed jQuery is quite lite, and many other plugins use it as well, making the total burden quite small.

== Installation ==

The most basic installation is a simple two step:

1. Upload the `microAudio` folder to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress

Older versions required a change to **k2.rollingarchives.js** if µAudio was used with k2. This is no longer an issue. If upgrading from a previous µAudio, **k2.rollingarchives.js** should be restored to its default.

== Frequently Asked Questions ==

= Do I need to do anything special in my posts? =

No, µAudio automatically converts any link to an mp3 file so that it can automatically create a player.

= Why doesn't it immediately load the player? =

It waits for the user to click on the link for several reasons:

1. It saves bandwidth not to load a bunch of (potentially needless) flash players.
1. If the link is in the middle of a paragraph, it might look odd for the player to be sitting in the text.
1. It just makes sense that the player appears when the user indicates a desire to listen by clicking on the link

== Screenshots ==

1.  An unadulterated link to an mp3 file. Nothing to see here, move along.
1.  The collapsed player. In default colors.
1.  The expanded player. In default colors.

== Notes ==

*   µAudio uses the super slim mp3 player from [1 Pixel Out](http://www.1pixelout.net/code/audio-player-wordpress-plugin/ "Crazy Cool"). This nifty little player clocks in at just 5 KB, smaller than many JavaScripts. Indeed, the total change to your pages (when no player is loaded) is a mere 560 Bytes. Even with a player loaded the entire system is under 6 KB. If bandwidth is expensive (and let's be honest, when isn't it?) µAudio is about the smallest you can get and still run.
*   Currently uses jQuery 1.2.3, the most recent version as of the release date. Any jQuery should work, but only 1.2.1+ have been independantly verified. In the event that your theme manually loads jQuery and *is not* K2 (or the k2 folder has been renamed), then you can prevent jQuery from loading by removing the following lines from `microAudio.php`:

`if (get_option('template') != "k2") {`
    `echo '<script type='text/javascript' src='$da_url/wp-content/plugins/microAudio/jquery.js.php?ver=1.2.1'></script>\n';`
`}`


== Known Issues ==

*    Please post any questions or bugs on the [Version Installation Page] (http://compu.terlicio.us/code/plugins/audio/micro-audio-installation/). Feature requests and comments of a more general nature should go on the [µAudio Home Page] (http://compu.terlicio.us/code/plugins/audio/).

*    In version 0.2, the "auto color" feature is not working, and the excess code has been removed. As of 0.3 the player should automatically color itself based upon the current WordPress CSS.

== Changelog ==

*0.2.2*
*    Fixed the problem with the **jquery.flash** extension sometimes failing to show up as javascript.

*0.2.1*
*    Fixed the problem with the way the embed was created through use of the **jquery.flash** extension.
*    Updated a stupid mistake which caused jquery to load last, leading to all sorts of problem.

*0.2*
*    Updated the JavaScript to run without needing to call **prepare_player()** even on pages with dynamic reload of links (such as k2's rolling archives.
*    Updated jQuery to 1.2.3
*    Removed the now superfluous **k2.rollingarchives.js** from the package.

*0.1.0.1*
*    Fixed error in folder case (WordPress extend converts all folder names to lower case).