Difference between revisions of "Help:FlashMP3"
David Mathis (talk | contribs) |
David Mathis (talk | contribs) m |
||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
'''FlashMP3''' embeds a simple Flash-player for playback of mp3-files. It is based on the great [http://www.1pixelout.net/code/audio-player-wordpress-plugin/ 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. | '''FlashMP3''' embeds a simple Flash-player for playback of mp3-files. It is based on the great [http://www.1pixelout.net/code/audio-player-wordpress-plugin/ 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. | ||
Revision as of 08:34, 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.
Contents
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.
