Difference between revisions of "Help:FlashMP3"

From My Big TOE Wiki
Jump to: navigation, search
m
 
(One intermediate revision by the same user not shown)
Line 4: Line 4:
  
 
For problems and suggestions please use the discussion page of this article.
 
For problems and suggestions please use the discussion page of this article.
 
  
 
==License==
 
==License==
Line 148: Line 147:
 
Plays songs from the given artist ([http://www.last.fm/music/TOOKOO Tookoo]).
 
Plays songs from the given artist ([http://www.last.fm/music/TOOKOO Tookoo]).
  
  <nowiki><flashmp3 type="lastfm">51022335|song|firstTrackName=Dance+For+Yourself|firstArtistName=TOOKOO|albumArt=http://static.last.fm/coverart/130x130/3245162.jpg|restDuration=227</flashmp3></nowiki>
+
  <nowiki><flashmp3 type="lastfm">51022335|song|firstTrackName=Dance+For+Yourself|
 +
firstArtistName=TOOKOO|albumArt=http://static.last.fm/coverart/130x130/3245162.jpg|restDuration=227</flashmp3></nowiki>
  
 
Plays the given song and displays the track name, artist name and duration as well as the cover right after loading.
 
Plays the given song and displays the track name, artist name and duration as well as the cover right after loading.
  
 
[[Category:Help|FlashMP3]]
 
[[Category:Help|FlashMP3]]

Latest revision as of 22:24, 24 March 2012

FlashMP3 embeds a simple Flash-player for playback of mp3-files. It is based on the great Audio Player Wordpress plugin by 1pixelout. It can handle multiple local and/or remote files in one player and multiple players on each site. The appearance of the player is highly customizable.

It is also possible to use the nice last.fm player with the files hosted there. It works on a label, artist, album or song-level.

For problems and suggestions please use the discussion page of this article.

License

Copyright © 2007 Matthias Korn

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.


Syntax (default player)

Base Syntax

<flashmp3>filename.mp3|parameter=value|...</flashmp3>

filename.mp3 can be the name of a file uploaded to the Wiki or an external URL. Additional parameters are optional.

Parameter Reference

Option Effect
autostart=yes The player will automatically open and start to play the track (default value is no)
loop=yes The track will be looped indefinitely (default value is no)
bg=0xHHHHHH Background colour option (where HHHHHH is a valid hexadecimal colour value such as FFFFFF or 009933)
leftbg=0xHHHHHH Left background colour
rightbg=0xHHHHHH Right background colour
rightbghover=0xHHHHHH Right background colour (hover)
lefticon=0xHHHHHH Left icon colour
righticon=0xHHHHHH Right icon colour
righticonhover=0xHHHHHH Right icon colour (hover)
text=0xHHHHHH Text colour
slider=0xHHHHHH Slider colour
loader=0xHHHHHH Loader bar colour
track=0xHHHHHH Progress track colour
border=0xHHHHHH Progress track border colour

Multiple files

Multiple files can be played in one FlashMP3 player one after the other by separating them with comma.

Multiple players

Multiple FlashMP3 players on one site can be achieved by giving them an id.

<flashmp3 id="2">secondmp3.mp3</flashmp3>

Examples

<flashmp3>mymp3.mp3</flashmp3>

Plays an uploaded mp3-file called mymp3.mp3.

<flashmp3>http://www.somedomain.com/mp3/mymp3.mp3</flashmp3>

Plays the remote mp3-file from the URL http://www.somedomain.com/mp3/mymp3.mp3.

<flashmp3>mymp3.mp3,yourmp3.mp3|autostart=yes|loop=yes</flashmp3>

Plays the two uploaded files mymp3.mp3 and yourmp3.mp3 one after the other, autostarts playing when the site is loaded and loops the files.

Syntax (last.fm player)

Base Syntax

<flashmp3 type="lastfm">resourceID|resourceType|parameter=value|...</flashmp3>

resourceID and resourceType have to be retrieved from the source of the last.fm page of which you want to embed the player (Right Click -> View Page Source and search for resourceID and resourceType). Both resourceID and resourceType are compulsory. Additional parameters are optional.

resourceType is either artist, album, song, label, playlist or the ID-number directly (if you know it).

Parameter Reference

Option Effect resourceType
restTitle= The title shown after the player loaded (default value can be set in the PHP code below) all
albumArt= URL of the cover shown after the player loaded (default value can be set in the PHP code below) all
labelName= Name of the label label, playlist
firstTrackName= Name of the first track played (will be shown even before the play button is pressed) artist, album, song
firstArtistName= Name of the first artist played (will be shown even before the play button is pressed) artist, album, song
restDuration= Duration of the track (will be shown even before the play button is pressed) artist, album, song

Additional parameter are possible as long as the last.fm player can interpret them in the given situation (i.e. resourceType).

Examples

<flashmp3 type="lastfm">11572702|artist</flashmp3>

Plays songs from the given artist (Tookoo).

<flashmp3 type="lastfm">51022335|song|firstTrackName=Dance+For+Yourself|
firstArtistName=TOOKOO|albumArt=http://static.last.fm/coverart/130x130/3245162.jpg|restDuration=227</flashmp3>

Plays the given song and displays the track name, artist name and duration as well as the cover right after loading.