====== LastFM Plugin ======

---- plugin ----
description: With this plugin you can display statistics from the last.fm service for a given user
author     : Michael Klier
email      : chi@chimeric.de
type       : syntax
lastupdate : 2009-05-21
compatible : > 2009-02-14, 2008-05-05
depends    : 
conflicts  : 
similar    : 
tags       : embed, music, listing
downloadurl: http://cloud.github.com/downloads/chimeric/dokuwiki-plugin-lastfm/plugin-lastfm.tgz
bugtracker : http://github.com/chimeric/dokuwiki-plugin-lastfm/issues
sourcerepo : http://github.com/chimeric/dokuwiki-plugin-lastfm/
donationurl: https://www.paypal.com/xclick/business=chi%40chimeric.de&item_name=DokuWiki%2BPlugin%2BDonation&no_shipping=1&no_note=1&tax=0&currency_code=EUR&lc=US
----

^ Download | [[http://cloud.github.com/downloads/chimeric/dokuwiki-plugin-lastfm/plugin-lastfm.tgz|plugin-lastfm.tgz]] |
^ Github URL | [[http://github.com/chimeric/dokuwiki-plugin-lastfm]] |

===== Donate =====
Support the ongoing development of DokuWiki Plugins and Templates and [[https://www.paypal.com/xclick/business=chi%40chimeric.de&item_name=DokuWiki%2BPlugin%2BDonation&no_shipping=1&no_note=1&tax=0&currency_code=EUR&lc=US|buy me a coffee]] ;-) (Suggested: 3€ for a regular or 5€ for big latte with caramel).

===== Description =====
With this plugin you can display statistics from the [[http://last.fm|last.fm]] service for a given user. You can see/test the plugin in action [[http://demo.chimeric.de/plugin:lastfm|here]].

===== Installation =====
Download the archive and unpack it into ''<dokuwiki>/lib/plugins''.

  * [[http://cloud.github.com/downloads/chimeric/dokuwiki-plugin-lastfm/plugin-lastfm.tgz|.tgz]] Plugin Manager

The plugin can also be installed via git.

<code>
% cd <dokuwiki>/lib/plugins
% git clone git://github.com/chimeric/dokuwiki-plugin-lastfm.git lastfm
</code>

===== Configuration =====
LastFM stores the date of the recent played tracks in UTC format. You can define an UTC offset via the configuration manager.

===== Syntax =====
  {{lastfm>username?[opt 1] [opt 2] [opt n] L=n}}

**The following options are available:**
^ topartists | Your top artists |
^ topalbums | Your top albums |
^ toptracks | Your top tracks |
^ tags | A list of your tags |
^ friends | Your friends at last.fm |
^ neighbours | Your neighbours at last.fm |
^ recenttracks | Recently played tracks. Note, if you haven't played any none will be shown ;-). |
^ artistchart | Your weekly artist charts |
^ albumchart | Your weekly album charts |
^ trackchart | Your weekly track charts |
^ profile | Shows your profiles' avatar and links to your last.fm page |
^ L=n | Limits the number of displayed records to ''n'' (default is 10) |
^ C=n | Number of columns used to display the friends/neighbours lists (default is 5) |
^ IMGONLY | Shows only images (usable with albumchart) |

===== Demo =====
You can try the plugin [[http://www.chimeric.de/_demo/plugin:lastfm|here]].

===== Changelog =====
A complete changelog is available [[http://github.com/chimeric/dokuwiki-plugin-lastfm/commits/|here]].

{{rss>http://github.com/feeds/chimeric/commits/dokuwiki-plugin-lastfm/master 110 1d}}

===== Bugs / Feature Requests =====
Please report bugs and feature requests at the [[http://github.com/chimeric/dokuwiki-plugin-lastfm/issues|bug tracker]].

===== Discussion =====