====== 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: https://github.com/chimeric/dokuwiki-plugin-lastfm/zipball/master
bugtracker : https://github.com/chimeric/dokuwiki-plugin-lastfm/issues
sourcerepo : https://github.com/chimeric/dokuwiki-plugin-lastfm/
----


===== Description =====

With this plugin you can display statistics from the [[https://www.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''.

  * [[https://github.com/chimeric/dokuwiki-plugin-lastfm/archive/master.zip|.zip]] 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 [[https://github.com/chimeric/dokuwiki-plugin-lastfm/commits/|here]].

{{rss>https://github.com/chimeric/dokuwiki-plugin-lastfm/commits/master.atom date}}

===== Bugs / Feature Requests =====

Please report bugs and feature requests at the [[https://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//