LastSongs API

Basic usage

Select a node with jQuery and apply this function: .lastSongs(username, apikey [, timeoutTime, styleSrc]);

• string username: is your Lastfm username, or the user you want to show in the widget
• string apikey: is your api key from Lastfm
• number timeoutTime: (Not required) set time in milliseconds for every update of information
• string styleSrc: (Not required) if you have the style file in other path or with other name, set its path here (only absolute paths)

An example of this constructor can be: $('.lastfm').lastSongs('melchor629', '1largeapikey...');
This function returns an object. This object is used to manipulate some aspects of the widget, with API functions.

API Functions

Something you should know: All this functions return the same object, allowing chaning functions like this:

$('.lastfm').lastSongs('melchor629', '1largeapikey...').setTimeout(60).setWidth(240).colorDeFondo(100, 234, 100, 0.8).applyStyle();

.setTimeout(time)

Changes the time to update information.

• number time: Time in seconds

.setTimeoutInMillis(time)

Same as above function, buy in milliseconds

• number time: Time in milliseconds

.setWidth(width)

Changes the width of the widget. Useful for change the size smaller for blogs with widget panels smaller than 300px.

• number or string width: New width. Append ‘px’ at the end, if it’s a string.

.applyStyle()

When some changes are done to the style of the widget, you should call this function to apply the changes. This function doesn’t affect the width.

.colorDeFondo(r, g, b, a)

Changes, internally, the background color of the widget. To apply the changes use .applyStyle()

• number r: Red component of a rgb(a) color. Valid range [0, 255]
• number g: Green component of a rgb(a) color. Valid range [0, 255]
• number b: Blue component of a rgb(a) color. Valid range [0, 255]
• number a: Alpha of a rgba color. Valid range [0, 1], float numbers are valid

.colorDeLaCabecera(r, g, b)

Changes, internally, the header color text of the widget. To apply the changes use .applyStyle()

• number r: Red component of a rgb(a) color. Valid range [0, 255]
• number g: Green component of a rgb(a) color. Valid range [0, 255]
• number b: Blue component of a rgb(a) color. Valid range [0, 255]

.colorDelTitulo(r, g, b)

Changes, internally, the song title text color of the widget. To apply the changes use .applyStyle()

• number r: Red component of a rgb(a) color. Valid range [0, 255]
• number g: Green component of a rgb(a) color. Valid range [0, 255]
• number b: Blue component of a rgb(a) color. Valid range [0, 255]

.colorDelArtista(r, g, b)

Changes, internally, the song artist text color of the widget. To apply the changes use .applyStyle()

• number r: Red component of a rgb(a) color. Valid range [0, 255]
• number g: Green component of a rgb(a) color. Valid range [0, 255]
• number b: Blue component of a rgb(a) color. Valid range [0, 255]

.colorDelAlbum(r, g, b)

Changes, internally, the song album text color of the widget. To apply the changes use .applyStyle()

• number r: Red component of a rgb(a) color. Valid range [0, 255]
• number g: Green component of a rgb(a) color. Valid range [0, 255]
• number b: Blue component of a rgb(a) color. Valid range [0, 255]

.colorDeCancion(r, g, b)

Changes, internally, the background of one of the song list color of the widget. To apply the changes use .applyStyle()

• number r: Red component of a rgb(a) color. Valid range [0, 255]
• number g: Green component of a rgb(a) color. Valid range [0, 255]
• number b: Blue component of a rgb(a) color. Valid range [0, 255]