====== 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/
----

^ 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]] |



===== 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 <del>[[http://demo.chimeric.de/plugin:lastfm|here]]</del>.

===== 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 <del>[[http://www.chimeric.de/_demo/plugin:lastfm|here]]</del>. FIXME

===== 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 =====
OK: version 2009-05-21 works nicely with ricewind for this: <code>{{lastfm>user?profile topartists topalbums toptracks recenttracks L=50}}</code>,  --- [[user>Erkan Yilmaz|Erkan Yilmaz]] //2011/08/10 03:19//