| REQUIREMENTS
LINUX, MAC, UNIX or WINDOWS server running PHP.
Tested with PHP version 4.3... so PHP version 4.3 is recommended, however i have had success with earlier versions of PHP... version 4.1 seems to be the lowest version that Wimpy will run on.
INSTALLATION
1. Upload wimpy.php and wimpy.swf to your mp3 directory on your web server.
2. Access wimpy.php with your browser. Example: http://www.yoursite.com/mp3s/wimpy.php
3. If everything works fine, visit:
http://www.wimpyplayer.com/customize/
To create custom HTML code to include wimpy or wimpy mini into your existing HTML page.
CUSTOMIZE WIMPY BEHAVIOUR
Visit: http://www.wimpyplayer.com/customize/ to generate custom HTML to control the way Wimpy behaves.
The link above will also enable you to embed wimpy into another page on your Web site (outside of your mp3 directory).
See "popup javascript examples" at the bottom of this page if you are interested in, well, popping wimpy up into a window, like on www.wimpyplayer.com.
VERSION HISTORY
v 1.8a - jan 31, 2004
- Customization via HTML.
- Volume control fix for MAC users. (Volume settings were not carried over to the next song)
v 1.8 - jan 22, 2004
- Added help pop-ups
- Fixed volume controls. (the volume would revert when the next song loaded + mute and full volume)
- Changed playlist item "double click action" to a single click
- Moved preferences into a query string that is passed into wimpy.swf via HTML.
- Demo in SWF and PHP.
- You can now move the wimpy.swf to another location outside of your wimpy folder by editing the HTML (rather than editing the source.fla fie).
v 1.7b - dec 5, 2003
- redesigned the user interface to make it cooler--more like itunes.
v 1.7 - oct. 14, 2003
- added some additional troubleshooting variables... have been able to get wimpy working with PHP version 4.06 by setting troubleshoot2 to true.
- added a directory filter, so you can hide particular directories from wimpy... especially good for people who have ugly front page directories hanging around.
- added an option in the wimpy.fla so that you can randomly select the first song to play from the playlist--then the rest of the songs will play in order.
- moved the customization features to the PHP page for easier editing
v 1.6 - aug 19, 2003
- included a download button so that users can download the source.mp3 file. This feature can be disabled through the wimpy.fla file by double clicking the wimpy player and on the "options" layer changing the variable: displayDownloadButton = true; from true to false.
- PHP revisions to accomadate different version of PHP + troubleshooting.
v 1.5a - aug 18, 2003
- PHP revisions only.
- added troubleshooting for legacy PHP version.
- included action to display PHP info (wimp.php?action=phpinfo)
v 1.5 - aug 2, 2003
- retro fitted the PHP so that it works under earlier versions of PHP (tested on PHP version 4.0.5. -- thanks to http://www.nilsellis.com for letting me test on his server).
- Made a new skin that makes wimpy really small.
v 1.4
- removed the capacity to save id3 info to a text file... too much hassle for the end user, although obtaining the directy list and mp3 info does require more"resources"
v 1.3c
- fixed idiotic problem with 1.3.b (wimpy was reading any file other than "txt" and "mp3"). Du.
v 1.3b
- incorporated getid3.riff.php by James Heinrich <[email protected]> - to parse RIFF frames.
- fixed filename issues where the filename contained charactors incompatable with Flash.
v 1.3a
- incorporated getid3.getimagesize.php by James Heinrich <[email protected]> - to handle mp3 files that have an image embedded in them.
v 1.3
- playlist now has id3 information
- a text file containing wimpy fromated id3 information is created for each mp3 file. This increase the speed it takes to get wimpy going and minimizes the overhead required to proces mp3's numerous times.
- cleaned up the source FLA file so that it is easier to "skin"
- turned wimpy into a movie clip so that you can "copy and paste" wimpy into your existing FLA project.
v 0.5
- removed a little bit of the uglyness
- should run with or without "register_globals"=On/Off
v 0.4
- the first release of the newer version which deviates from using playlists. Millions of bugs and very ugly code, but hey it works!
POP UP JAVASCRIPT EXAMPLES
Copy and paste this script into the <head> of your HTML page:
< script language="JavaScript" type="text/JavaScript">
< !--
function MM_openBrWindow(theURL,winName,features) { //v2.0
window.open(theURL,winName,features);
}
//-->
< /script>
Example 1:
This link opens a fixed size pop-up window
Use the following in the <body> of your HTML:
<a href="#" onClick="MM_openBrWindow('wimpy.swf','popWimpy','width=450,height=185')">This link opens a fixed size pop-up window</a>
Example 2:
This link opens a "stretchable" pop-up window
Use the following in the <body> of your HTML:
<a href="#" onClick="MM_openBrWindow('wimpy.swf','popWimpyStretch','resizable=yes,width=245,height=100')"> This link opens a "stretchable" pop-up window</a>
LICENSE AGREEMENT
This software is the copyrighted material of Mike Gieson, Plaino. This document is a license agreement. By running this software on your computer you agree to the terms of this license.
Mike Gieson, Plaino takes no responsibility for any damage that this software might cause.
This software is designed to provide access to collections of files. By using it, you agree to comply with all federal and state laws applicable to such content, as well as the terms of this license. You agree not to use this software to distribute or facilitate the distribution of unauthorized copies of copyrighted works.
If you disagree with any of these terms, you are not authorized to use this software. If you do agree with these terms, enjoy.
|