First, let me thank you for registering your Jamroom! Registering Jamroom enables you to add several new features to your Jamroom that are all part of the Jamroom Bonus Pack.

Installation of the Jamroom Bonus Pack is straightforward and easy to do. Just follow the steps outlined below and you will have it set up in no time.

• First, make sure you have download the latest version of the Jamroom Bonus Pack from the Jamroom Downloads Page ¹⁾. On the download page you will always be able to see the latest version of the Bonus Pack, as well as a link to the Bonus Pack Issue Tracker file so you can read up on what has changed since the previous version.

• Next, uncompress the downloaded archive (called something like “jamroom-bonus-2.67.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-bonus-2.67”.

• 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 bonus pack are now inside your jamroom directory - i.e. “jamroom/newsearch.php”. You do not need to worry about overwriting any files already installed in your Jamroom, since all of the new files in the Jamroom Power Pack do not exist in your Jamroom install.

All of the files required by the Bonus Pack have now been installed.

The Jamroom Friendly URL Feature will enable the Artists in your Jamroom to use a “nice” URL to get to their artist site, instead of a number. For example, instead of going to http://example.com/jamroom/bands/25, your artists could type in http://example.com/band_name, which should make it much easier for your artists to remember their URL.

In order to support the Jamroom “Friendly URLs” feature, you will need to rename the “nicenames_htaccess” file that is located in your jamroom directory to “.htaccess” - this will enable the mod_rewrite feature of Apache ²⁾ and allow the nice names to work.

NOTE: If you already have a .htaccess file present in your jamroom directory, you can simply add the contents of the nicenames_htaccess to the bottom of your current .htaccess file.

The next step is to ensure the location of the “newsearch.php” script referenced in your .htaccess file points to the correct location. The line you will need to check looks like this:

RewriteRule (^[-_A-Za-z0-9 ]*$) newsearch.php?mode=retrieve&rewrite=yes&search_area=band_name&header_template=common_header.tpl&footer_template=common_footer.tpl&search_string=

With it in it’s default state, mod_rewrite will be looking in the same directory as the .htaccess file for the newsearch.php script. This works perfect if you are running Jamroom from the root of your web server. However, if you have installed Jamroom into a subdirectory of your web server (i.e. http://example.com/jamroom), then you will need to ensure the name of the directory you installed Jamroom into is added to the RewriteRule line:

RewriteRule (^[-_A-Za-z0-9 ]*$) jamroom/newsearch.php?mode=retrieve&rewrite=yes&search_area=band_name&header_template=common_header.tpl&footer_template=common_footer.tpl&search_string=

Important: The Jamroom Friendly URL feature requires that Apache’s mod_rewrite feature be enabled on your web server. If after configuring your Jamroom to use Friendly URL‘s, you receive errors on your web server, you’ll want to contact your webhosting provider and have them ensure your account is configured to have access to mod_rewrite.

Installing the Jamroom Bonus Pack Artist Themes “Sandstorm” and “Dun Forest” is very easy to do:

1. Log into your Jamroom as the Master Admin.
2. Click on the “Install Theme” link in the “themes” section of the Admin Menu.
3. Select the new Artist Theme you would like to install from the selection list of available artist themes, and press install.
4. Repeat the same process for the other uninstalled Artist Theme.
5. Next, go into the “Modify Quota” section of the Admin Menu and ensure the ne Artist Themes are only available to the Jamroom Quota(s) that you want them to be available in.

That’s it - your new Artist Themes are installed.

To install the new “Qashani” Admin Skin, simply copy the new styles CSS file and folder into your jamroom/styles directory, so it would look like this after installation:

jamroom/styles/Qashani.css
jamroom/styles/Qashani  <- directory containing style specific graphics files.

That’s all there is to installing it. Now it can be selected as a Admin Skin from the “Your Profile” section (for regular users) or the “Admin Profile” section for the Master Admin. Note too that it can now be used as the System Default Admin Skin by selecting it from the Jamroom Config → Interface Settings config section.

After installing the Jamroom Bonus Pack, you will see a new option become available in the Jamroom Config section - “Signup Settings”. You’ll want to click on this option and ensure all the Signup choices are configured as you want them to be. When you are satisfied with your configuration, press the “Update Settings” button to ensure your changes are saved to the database.

To install and use the Jamroom Lofi Creator, please see the separate Jamroom Lofi Creator Guide for detailed instructions on compiling, installing and configuring LAME for use within your Jamroom.

1) Jamroom registration user and code required
2) note: this option was developed and tested with the Apache web server - there’s no assurance this will work with other web servers