Wimpy PHPnuke MP3 Player

1. Follow the standard instructions for installing Wimpy on your web site.

Click here to review the instructions.

2. Use the Customizer tool to create a customized "myWimpy.html" file.

Upload the resulting "myWimpy.html" file to the same folder that you installed Wimpy in during step 1..

3. Test Wimpy by accessing the myWimpy.html file with your web browser.

Example:

http://www.yoursite.com/mp3s/myWimpy.html

4. Download and unzip the Wimpy PHPnuke MP3 player package:

Click here to download the package

4. Upload "block-Wimpy.php" to the PHPnuke "blocks" folder on your server.

This folder is usually located within the PHPnuke installation folder. However, your particular installation may be different. if your not sure where this folder is located, contact your server administrator to determine the proper location for where PHPnuke "blocks" should be located..

5. Access the administration panel of your PHPnuke installation.

Go to the "blocks" section. In the "Add a New Block" section (toward the bottom of the page) enter "wimpy" as the title, then in the "Filename" drop-down menu select "Wimpy."

Wimpy should now be be ready to use throughout your site.

NOTE: Once Wimpy is installed on your server, you can upgrade to the non-demo version by simply over-writing the wimpy. In other words, you will only have to re-upload the wimpy package files, you will not have to re-install the Module.

Trouble shooting:

If wimpy is NOT working properly, chances are that PHPnuke can not find "myWimpy.html." You may have to edit "block-Wimpy.php" so that PHPnuke can locate myWimpy.html.

By default, the block-wimpy.php file is set up to look for your myWimpy.html file in the "mp3s" folder that resides in the "public root" of your web site. We have assumed that you followed the installation instructions (Step 1) and installed Wimpy in a folder named "mp3s" on the root of your web site.

Example:

/mp3s/myWimpy.html

Notice that there is a "/" at the beginning of the example above. When a "/" character is at the beginning of a file or URL path, it tells the server to go to the "public html root" of your web site. When a web page or file on your site uses the example above to "link" or "look for" a file, it would be the same thing as linking to, or looking for the following:

http://www.yoursite.com/mp3s/myWimpy.html

By default, block-Wimpy.html tells PHP to "look for" myWimpy.html in the mp3s folder at the "root" of your web site.

If you installed Wimpy in a different folder, OR if you have a unique PHPnuke installation, this "location" may not be correct and PHPnuke can not "find" the myWimpy.html file. So you'll have to do some detective work so that block-Wimpy.php can tell PHPnuke the proper location of myWimpy.html.

Open block-wimpy.php in a text editor edit the following line:

From:

$wimpyHTML = "/mp3s/myWimpy.html";

To:

$wimpyHTML = "http://www.yoursite.com/mp3s/myWimpy.html";

... so that the path to myWimpy.html is a full URL to your myWimpy.html page. The location of this file may vary according to your particular installation. Some PHP installations may allow a full URL, and some may not. If the full URL does not work, try using something like:

$wimpyHTML = "../mp3s/myWimpy.html";

Or:

$wimpyHTML = "../../mp3s/myWimpy.html";