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.
Installing the required files
First, make sure you have download the latest version of the Jamroom Bonus Pack from the Jamroom Downloads Page 1)
. 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, 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.
Enabling the Jamroom Friendly URL's
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 2) 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 Bonus Artist Themes
Installing the Jamroom Bonus Pack Artist Themes “Sandstorm” and “Dun Forest” is very easy to do:
Log into your Jamroom as the Master Admin.
Click on the “Install Theme” link in the “themes” section of the Admin Menu.
Select the new Artist Theme you would like to install from the selection list of available artist themes, and press install.
Repeat the same process for the other uninstalled Artist Theme.
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.
Installing the new "Qashani" Admin Skin
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 <- 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.
Configuring the Jamroom Signup System
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.
Installing and Configuring the Jamroom Lofi Creator
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