Update 5/26/2011 The "xmp3mini" mp3 player has been updated to include HTML5 fallback code. If you have purchased your player before 5/26/11 you can contact us for the updated download.
Setting up the Flash/HTML5 mp3 player
To get started, open the "xmp3mini-help.html" included with your addon download .zip file.
Variables in the player-?.js files
Click below to view a description of the variables in the "player-1.js" file.
xmp3mini message with a picture (59 width)
If you have purchased the xmp3mini player you can download these items to add to your player.
This code will setup any player with the message style shown on the left. See the README.txt in the download to set this up with your player.
Message style stop buttons (for 59 width)
In the xmp3mini player download, the stop buttons have a 3D look. If you use the 59 pixel wide "message" style then the stop buttons may not look centered properly. See the README.txt in the download to use these stop buttons with your player.
Only use these buttons if you are setting up your players as 59 pixels wide.
About the .ogg file option
The xmp3mini Flash / HTML5 player defaults to using Flash to play all mp3s. This allows for the highest compatibility using only mp3 files. In the backup HTML5 code an option is included in the "player-?.js" files to set an .ogg music file to play. This option is the backup for the Firefox and Opera browsers that is used only if the user does not have Flash installed. This is added because these 2 browsers can not play mp3 files using HTML5 code due to licensing restrictions. Both Firefox and Opera fully support Flash at this time.
Using the .ogg file option
The .ogg audio file option is included for future possible web changes and is not in wide usage at this time. To fully utilize the .ogg option for Firefox and Opera:
Convert all your mp3s you are using on your website to .ogg. Keep both the .ogg and .mp3 files.
In each "player-?.js" edit the var "song_nameOGG" with the name of your .ogg music file.
Upload both the .mp3 and .ogg files.
Make sure your hosting account allows for the mime type .ogg or have it added.
You can test the .ogg files by editing the "MPMshowsflash" to "no" in your "player-?.js" files. Be sure to also test .ogg files once uploaded to your hosting space.
How to create new xmp3mini skins
In the "skins" folder in the "xmp3Player-mini" folder, create a new folder with your new skin color name. Make this all capital letters. For example make a new folder named "BROWN".
Copy the 5 .jpg images from any other color folder into your new folder. Example: Copy the images from the "RED" folder into your new "BROWN" folder.
Edit these 5 .jpg images in any graphics program. .PSD Photoshop files are included in the "extras" folder.
In the "colors" folder in your "xmp3Player-mini" folder, make a copy of the "RED.txt" and rename that "BROWN.txt". Edit the "BROWN.txt" and replace "RED" in 4 places with "BROWN". All capital letters.
Edit any one of the "player-1.js" files with your new color. Example: Replace "RED" with ""BROWN" in the "player-1.js".
Test the new color on a page you have added the player to.
