commandtab / fmtuner

=== fmTuner ===
Contributors: command_tab
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=533819
Tags: music,last.fm,sidebar,mp3
Requires at least: 2.5
Tested up to: 2.7
Stable tag: 1.0.4

fmTuner displays recent, top, or loved Last.fm tracks in a customizable format.

== Description ==

fmTuner pulls track information from your Last.fm account, including recent tracks, loved tracks, and top tracks.  Using

the built-in options and simple tags, you can fully customize how tracks appear on your site.

Features:

*   Choose between recent, loved, and top tracks
*   Adjust how many tracks are shown
*   Adjust how often tracks get pulled from Last.fm
*   Customizable appearance using basic tags

Requirements:

*  A Last.fm account to which you "scrobble" (publish) music details
*  WordPress 2.5 or greater
*  PHP 5 or greater

== Installation ==

Installation of fmTuner is straightforward, however it does require PHP 5 or greater.

1. Upload `fmtuner.php` to your `/wp-content/plugins/` directory, within a directory like `fmtuner`.
1. Ensure `/wp-content/plugins/fmtuner/` is writable by your webserver (`chmod 755 fmtuner`).
1. Activate the plugin through the 'Plugins' page in the WordPress admin.
1. Set your fmTuner preferences in the "Settings" menu in WordPress.
1. Place `<?php if(function_exists('fmtuner')) { fmtuner(); } ?>` in your desired template.

== Frequently Asked Questions ==

= How does fmTuner work? =

fmTuner pulls your latest tracks from Last.fm according to the settings page in the WordPress administration area.  
Tracks get pulled from Last.fm when a visitor comes to your site, and are then cached for future visits.  If the cache 
has expired (i.e. passed the Update Frequency you've chosen), it gets pulled again, and your page is updated.

= How many tracks can I display? =

Tracks can be limited in the settings page for fmTuner, however Last.fm only provides up to 10 Recent Tracks.  Loved and 
Top Tracks offer many more.  Between 1 and 10 is recommended.

== fmTuner Tags ==

These fmTuner tags can be sprinkled among HTML (in the fmTuner Settings page) to customize your album display format. 
Tags can be used more than once, or completely left out, depending on your preferences.

* `[::album::]` Album name (Only available for Recent tracks.)
* `[::artist::]` Artist name
* `[::image::]` Album artwork address (Usually ~120 pixels in size, but may not be square. If used, only tracks with 
artwork will be shown.)
* `[::number::]` Track number within the fmTuner set (e.g. for a numbered list)
* `[::title::]` Track title
* `[::url::]` Last.fm track address

== Removal ==

Should you need to remove fmTuner:

1. Deactivate the plugin through the 'Plugins' menu in WordPress.
1. Delete the `fmtuner` directory from your `/wp-content/plugins/` directory.

== Screenshots ==

1. fmTuner settings interface in WordPress 2.6.
1. One of many possible display options. You are free to configure fmTuner how you prefer!