=== gLastFM ===
Contributors: GabSoftware
Donate link: http://www.gabsoftware.com/donate/
Tags: music, lastFM, last.fm, scrobbling, recent, track, album, artist, loved, top
Requires at least: 3.0.0
Tested up to: 3.3.0
Stable tag: 1.0.4

Shows your recent, loved or top tracks from Last.fm on your sidebar

== Description ==

This plugin lets you display a nice Last.fm widget showing the recent, loved or top tracks scrobbled on Last.fm.
It is possible to display the top albums and top artists as well.
gLastFM is based on Lastfm-covers, but it has evolved and almost doesn't share any common code now.
Features:
<ul>
<li>Template system so you can display what you want, as you want.</li>
<li>Better Last.fm error handling (no longer have PHP errors in case of failure)</li>
<li>Use cached data if Last.fm data is unavailable</li>
<li>Do not use Javascript: everyone can see the widget</li>
<li>Display the items as a list</li>
<li>Clicking a cover or title will redirect you to the related Last.fm page</li>
<li>Improved theme with new pictures (see the 'licence.txt' file in the theme directory)</li>
<li>Clicking on the title of the widget will take you to the user's Last.fm page</li>
<li>Lot of code cleaning</li>
<li>Corrected some translations</li>
<li>Use of unique names for functions and global variables to avoid conflicts</li>
<li>Respect WordPress coding standards better</li>
</ul>

== Installation ==

This section describes how to install the plugin and get it working.

<ol>
<li>Extract and upload the 'glastfm' directory to your '/wp-content/plugins/' directory</li>
<li>Activate the plugin through the 'Plugins' menu in WordPress</li>
<li>Edit the plugin configuration in the WordPress "settings" category</li>
<li>Add the widget in your sidebar</li>
</ol>

== Frequently Asked Questions ==

= Why aren't some fields available in the template depending on what I want to display?' =
That's because the fields aren't available in the JSON data we retrieved from Last.fm.

= Where do you fetch all this data? =
I fetch it using the Last.fm API (http://www.lastfm.fr/api) in JSON format using your API key, the cURL library and the json_decode PHP function.

= Is it possible to include field X or ranking Y? =
Maybe. Just contact me :)

= I have tons of wonderful ideas for your plugin. What should I do? =
Just let me know, it's always good to hear other people ideas!

= OMG WHAT IS THIS CRAP, IT DOESN'T WORK!!! =
Go to this page and follow the instructions: http://www.gabsoftware.com/support/ . Oh yes, and do not use CAPS please.

= The widget does not render well on my WordPress, why, and what should I do? =
Although the widget should display fine on most sidebars, if it doesn't render well, that's probably a CSS issue.
Try to hack the widget CSS and/or use a custom template so that you can style the output yourself.

= Another question ? =
If you have a question or a problem you can contact me on my website: http://www.gabsoftware.com/contact/ or on the plugin webpage.

== Screenshots ==

1. gLastFM as it appears on the sidebar

== Changelog ==

= 1.0.4 =
* Code cleaning
* Added an option to use a custom template.
* Can now display the top albums and top artists
* Now use JSON format instead of XML (easier to work with)
* Improved widget settings
* CSS tweaks
* Added a link so that users do not forget to set an API key
* Updated this readme

= 1.0.3 =
* Bugs fixed

= 1.0.2 =
* Bugs fixed

= 1.0.1 =
* Corrected the case where the XML data is corrupted or incomplete

= 1.0.0 =
* Initial release