=== WPaudio MP3 Player === Contributors: toddiceton Donate link: http://wpaudio.com/donate Tags: audio, embed, media, mp3, music, plugin, podcast Requires at least: 2.5 Tested up to: 2.8.4 Stable tag: 1.5.2 Play mp3s and podcasts in your posts with the simplest, cleanest mp3 player. Supports other players' tags and separate download URLs. == Description == ### All the other WordPress audio players were crappy or ugly so I made a better one. ![WPaudio](http://wpaudio.com/screenshot.png) Deactivate that lame Flash player and install a plugin that makes you proud to embed mp3s. WPaudio installs in seconds, looks great, and uses simple tags... all without bulky files or affecting page load times. #### Easy to install, easy to use Install directly from WordPress (just go to *Plugins* -> *Add New*) and start embedding mp3s immediately. You supply the URL -- WPaudio does the rest. It's as easy as `[wpaudio url="http://url.to/your.mp3"]`. #### Clean design with intuitive controls Everything's tucked out of the way until you click play. Jog the track by clicking the position bar. Download by clicking the title. Simple. #### Compatible with your old audio player tags Want to switch to a better player? Just deactivate your old plugin and let WPaudio give your old posts the dignity they deserve. WPaudio is compatible with Audio Player tags, with support for more on the way. #### Won't slow down your site WPaudio was written to be as lightweight and fast-loading as possible. It uses Google's content delivery network for maximum speed. ### How to use WPaudio 1. Upload your mp3/podcast by clicking the musical note next to *Upload/Insert* when editing a post. 1. Copy the mp3's URL. You can get it in the *Link URL* section by clicking *File URL*. Exit the *Add Audio* window. 1. Use the `[wpaudio]` tag to embed the mp3 in your post. Here are your options. * Let WPaudio read artist and song info from the mp3 [wpaudio url="http://url.to/your.mp3"] * Or specify the text you'd like displayed on the player (optional) [wpaudio url="http://url.to/your.mp3" text="Artist - Title"] * You can also change the download URL if you'd like to use a file host like Mediafire or YSI (optional) [wpaudio url="http://url.to/your.mp3" text="Artist - Title" dl="http://dl-host.com/song.mp3"] * To disable downloading entirely, set the *dl* parameter to "0" [wpaudio url="http://url.to/your.mp3" text="Artist - Title" dl="0"] Powered by the SoundManager 2 API http://www.schillmania.com/projects/soundmanager2/ == Installation == * Install directly from WordPress (just go to *Plugins* -> *Add New*) and activate. Or * Manually install to your WP plugins directory 1. Unzip `wpaudio-mp3-player.1.2.zip` in the `/wp-content/plugins/` directory. 2. Activate the plugin through the *Plugins* menu in WordPress. 3. If you want WPaudio to handle old Audio Player tags (`[audio:http://url.to/your.mp3]`), go to *Settings* -> *WPaudio* and select that option. == Frequently Asked Questions == = I use (some other mp3 player). Do I have to go back and change ALL my tags? = Nope. If you used Audio Player, just tell WPaudio to handle it on the *Settings* -> *WPaudio* page. If you used another plugin, email me and I'll get support for it into the next version. = Should I include the *text* parameter? = It's not necessary, but the player will load marginally faster, so I try to include it. = What if I don't want readers to download the mp3 from my server? = Allow users to download from a file host by adding the *dl* parameter to your shortcode like this. [wpaudio url="http://url.to/your.mp3" dl="http://download-host.com/mp3_download_url"] Or disable downloads by setting *dl* to "0" like this. [wpaudio url="http://url.to/your.mp3" dl="0"] = Why is the filename showing up instead of the artist and title? = WPaudio can only read the clip's info when its address begins with the same domain. A player at http://myblog.com can't play an mp3 at http://otherblog.com or even http://www.myblog.com. This is a limitation of the technology behind WPaudio, not a limitation created by the plugin itself. == Screenshots == 1. WPaudio player in action. Play by clicking the play button or the large text. The blue bar indicates current position, the gray bar indicates the data loaded so far, and the light gray bar indicates total duration. Download by clicking the name of the clip. (Optionally, you can change the download link for use with Mediafire, YSI, etc.) 2. WPaudio player before play is clicked. 3. WPaudio player in action with the download link disabled. 4. Editing the tag. == Changelog == = 1.5.2 = * Restores support for WordPress 2.5 and up = 1.5.1 = * Parse_url now uses one parameter for maximum PHP compatibility = 1.5.0 = * Clicking player text link now plays song, separate download link * Automatic URL correction if file exists locally (to satisfy Flash cross-domain policy) * Fixed out-of-focus load issue (Safari) * Scripts now external * Wrapper for use outside posts (direct from template) * Better iPhone/iPod links = 1.4.0 = * Color customization options * Passes XHTML validation (added CDATA tags) * Concealed mp3 URLs (Unicode-encoded) = 1.3.1 = * Moved to WP's internal jQuery library to avoid conflicts * Removed legacy code (fixes IE layout break issue) * Degradation more graceful: separate warnings for JS/Flash (invisible on load instead of hiding as player components load) * Button icon fixed for multiple players on one page = 1.3.0 = * More consistent behavior all around (switched from JW Player to SoundManager 2 API) * Documented option to disable download link * Fixed player position/duration/load bar width for disabled downloads = 1.2.2 = * Fixed symbols in *text* field * Enabled shortcode and audio tags in sidebar widgets * Added support for audio tag titles and artists = 1.2.1 = * Enabled shortcode in the excerpt = 1.2 = * Fixed directory settings * Improved readme = 1.1 = * Text support, smoother ID3 reading * Download link parameter = 1.0 = * Shortcode support * Google CDN-served jQuery and SWFObject