Overview

The Jamroom Media File Slurper (slurp.php) is a script that will allow your users to grab a media file from a remote server by entering the URL to the media file.  The File will be placed in the Artists "uploads" directory, and can then be imported into their Control Panel.

Configuring the Jamroom Audio File Slurp script is easy:

1. Make sure you have the “Allow Imports” setting set to “yes” in the Jamroom Quota(s) that you would like to enable this feature for. When the slurp.php script “grabs” a file from the web, it will drop it in the jamroom/uploads/(band_id) directory. This means that the file, after slurping, will then become available to be “imported” as a new media item in the Jamroom Create/Modify forms.
2. At the top of the slurp.php script, you will see a setting called “max_file_size” - this allows you to set a limit on the maximum size of file that the slurp script can be used to retrieve:

#-( BEGIN USER MODIFIABLE SETTINGS )------------------------------------
 
# max_file_size - this setting allows you to set the MAXIMUM file size
# that this script will be allowed to "slurp" from another server.  This
# should be set high enough to allow a large audio file to be transferred,
# but small enough to prevent abuse.  Note that this value is in MEGABYTES
$max_file_size = 16;
 
#-( END USER MODIFIABLE SETTINGS )--------------------------------------

Note that the value is set in “megabytes”, so for example to set it to 8 megabytes, you would enter “8” for the $max_file_size setting. Don’t forget the semicolon!

To allow your users to access the slurp script, simply create a Jamroom Custom Button with the following:

• Button Label - “slurp a file” (or whatever you would like it to say in the Artist Menu.
• Button URL - enter: slurp.php?mode=menu
• Button Quota - select the quota(s) you would like this Custom Button to be available for.
• Hide Button - leave unchecked or the button will not be visible.

That’s it - save your new Custom Button and the “slurp” function will be available from the Artist Menu.

Now that you have the new “Slurp” button available from the Artist Menu, using it is easy. When you click on the new “slurp a file” button, you will be presented with a small form that allows you to define the:

1. Audio File Name - this will be the local file name that will be written in the artists jamroom/uploads directory.
2. Audio File URL - this is the URL to the audio file.

Note: At this time the URL will be required to end in a format that is allowed for your system - i.e. “mp3”. Currently the Slurp script will NOT work on a URL that points to a script, etc. For example, a url like “http://somesite.com/files/audio.mp3” would work, whereas “http://somesite.com/audio/getfile.php” would not work.

After entering correct values for both forms, press submit. The slurp script will now attempt to “grab” the remote file and copy it in to the Artist’s uploads directory. Once successful the new audio file will be made available in the drop-down list of files that can be imported from the Create and Modify Song screens.

That’s all there is to it - happy slurping!