Installing the Jamroom Jukebox

The Jamroom Jukebox is a new add-on for Jamroom that makes it easy to "import" MP3 and WMA files directly in to your Jamroom.  The Jukebox will scan each audio file as it is imported, and create the necessary Artist profile to hold the audio file(s).  The Jamroom Jukebox is a "special" add-on to the base Jamroom system that can be used to provide import capabilities to an existing Jamroom installation, or to provide the user with all of the power and flexibility found in Jamroom for use as a locally installed "Jukebox".  The Jamroom Jukebox can optionally grab Album art as well as song lyrics from the Internet if configured to do so.

Installing the Required Files

Installing the Jamroom Jukebox is a fairly short procedure, and shouldn't take longer then a few minutes to get setup and start importing audio files.  Please make sure and follow these directions in order to ensure the Jamroom Jukebox is setup and properly enabled in your Jamroom.

• The first step in the install is to make sure and download the latest version of the Jamroom Jukebox from the Jamroom Extras download page.

• Next, uncompress the downloaded archive (it will be named something like "jamroom-jukebox-1.0b1.zip" - note that the version number may be different) into a folder on your local hard drive. You will see that a sub-folder is created that is named the same as the download - i.e. “jamroom-jukebox-1.0b1”.

• Next, upload the contents of this folder directly in to your Jamroom directory, using an FTP client like FileZilla. If uploaded correctly, you will see the scripts from the Jukebox are now inside your Jamroom directory - i.e. “jamroom/jukebox.php”. You do not need to worry about overwriting any files already installed in your Jamroom, since all of the files in the Jamroom Jukebox do not exist in your Jamroom install.

All of the files required by the Jamroom Jukebox have now been installed.
 

Using the Jamroom Jukebox

Now that you have installed the Jamroom Jukebox, the next step is to run it.

Tip: If you get the error "You do not have the GETID3 option installed and configured, which is required for the Jamroom Jukebox" at this point, then you want to be sure the Getid3 option has been installed in your Jamroom.

After logging in as the Jamroom Master Admin, click on the "Jamroom Tools" link in the admin menu, then on the "Jamroom Jukebox" link in the tools menu.  You will be presented with the Jukebox Importer control panel, which allows you to set a few options for the audio files you are going to import.  It's important to note at this point, that the Jamroom Jukebox gathers the information it needs about the artist and track information directly from the audio file - that is ASF or MP3 tags.  Before importing audio into your Jamroom using the Jukebox importer, you'll want to be sure the audio files have been tagged to your satisfaction.

The following options are available in the Jamroom Jukebox Importer screen:

• Server Path - this setting is where you would enter the path to your MP3/WMA files.  For example, if your MP3/WMA files were located in the /media/music directory, that is what you would enter as the path (or if you are on a Windows server, "C:mediamusic")
• Use Links? - this setting is important to understand, as it has a great influence on the amount of disk space the Jamroom Jukebox will use.  By default, when Jamroom successfully imports an audio file into the Jukebox, a copy of that file is created in the profile directory - checking this option will cause Jamroom to create a symbolic link instead, which means the file will not be copied, but simply "linked to" which saves a lot of disk space.
• Grab Images - If this option is checked, Jamroom will attempt to "grab" the artist and album images from Amazon.com for use in the artist profile.
• Grab Lyrics - If this option is checked, Jamroom will attempt to pull down the lyrics for the audio files from the internet.

Once you have selected the options as you would like them, you can press the "Import Files" button to begin the actual import process.  Please note that if you have selected the "Grab Images" and "Grab Lyrics" options that it can take anywhere from 5-10 seconds per audio file to import, as Jamroom is now limited by the speed of your internet connection, as well as the response time of Amazon.com and Leo's Lyrics (where Jamroom gets lyrics from).

After you have successfully imported your audio files, you'll want to rebuild your artist profiles so the new songs appear on the profile pages.

That's it!  Importing audio files should be a fairly easy procedure, as in the future you can re-run the importer whenever you need to have Jamroom update the files in the database.
 

Enabling the Jamroom Ad Manager in the Jukebox Skin

By default, the Jamroom Jukebox Skin uses the {jr_html_ad} ad rotator Template Function.  If you would prefer to use the Jamroom Ad Manager to rotate your advertisements, enabling its use it easy.  This option became available with the release of the Jamroom Jukebox version 3.2.2.

• Make sure the Jamroom Ad Manager has been successfully installed
• Log in to your Jamroom as the Master Admin
• Click on the "ad manager" link located in your Master Admin Menu
• Create a new ad (or modify an existing ad), and make sure the "Ad Type" is set to "468x60" - this is the banner size used in the Audio Player.
• Save your banner

That's it - when Jamroom sees that you have set the "type" for some of your banners to either 468x60 or 180x150, Jamroom will display Ads using the Jamroom Ad Manager.

Add a Banner Ad to the Jamroom Jukebox Skin

By default, the Jamroom Jukebox Skin has banner ads located in the popup Audio Player, but if you would like to ad Banner Ads to your Jukebox home page, here are the steps to do so:

• Log in to your Jamroom as the Master Admin.
• Click on the Jamroom Tools link in the admin menu.
• Click on the "Template Editor" option in the Tools Menu.
• In the "Search Templates" box enter "jr_overall_header", then place a check mark in the "Search File Name Only" Search Option, and click on the "Search" button.
• From the list of templates found, select the "skins/Jukebox/jr_overall_header.tpl" line and press the "Edit Template" button.
• Once the Jamroom Template Editor starts up, you will want to change this section of HTML code (located right at the bottom of the template):
  
   
  Change This:
  

  <!-- BEGIN WRAPPER --> <div class="wrapper"> <div class="spacer-30px"></div> <table width="100%" cellpadding="0" cellspacing="0">

  
  To This:
  

  <!-- BEGIN WRAPPER --> <div class="wrapper"> <div class="spacer-30px"></div> <div class="body-5">   {if is_file('advert.php')}     {jr_advert type="468x60" user_id="0" assign="ads_468"}   {/if}   {if strlen($ads_468) > 0}     {$ads_468}   {else}     {jr_html_ad skin="Jukebox" ad_dir="ads_468x60"}   {/if} </div> <div class="spacer-30px"></div> <table width="100%" cellpadding="0" cellspacing="0">

• Save the modified template by pressing the "Save Template" button.

That's it - you have now enabled Banner Ads on the Jukebox Front Page.  Note that if you have already followed the steps above in the "Enabling the Jamroom Ad Manager in the Jukebox Skin", your 468x60 ads will not rotate on your Jukebox front page.