Installation of the Jamroom Power Pack is easily accomplished and should only take a few minutes - details on each script are available below.

1. First, make sure that you have Jamroom installed and working correctly, before attempting to install the Jamroom Power Pack. It is highly recommended that you be running the very latest version of Jamroom so the Jamroom Power Pack will be fully supported.
2. Next, make sure you are using the latest version of the Jamroom Power Pack, available from the Jamroom Downloads page. Note that bugs are fixed and new features are added in every release, so it’s worth it to download the most up to date version available. A registration user name and password ¹⁾ is required to download.
3. Make sure you are running the correct version of the Jamroom Power Pack for your Jamroom - i.e. Jamroom Power Pack 2.60 will run on Jamroom 2.60 - not Jamroom 2.51.
4. After downloading the Jamroom Power Pack, uncompress it to your local hard drive using a program like 7-zip. This will preserve the directory structure of the downloaded file so it is all ready for uploading to your Jamroom server.
5. Next, using your FTP client (FileZilla is highly recommended), upload the directories and files that were created in step 3 to your Jamroom directory on your Jamroom server. Make sure the PHP files (i.e. photo.php) are located in your jamroom directory after upload - i.e:

jamroom/photo.php
jamroom/comment.php
..etc..

1. Log in to your Jamroom as the Master Admin account, and click on the “Modify Quota” or “Create Quota” setting. What you need to do is enable the Artist Photo Galleries on one of your existing quotas (or create a new quota), by changing the “Allow Photo Gallery” option to yes. Save your changes.
2. Next, switch over to the Artist Menu, and using a test artist account (or an account you can use for testing purposes), click on the “Modify Artist” link and ensure that artist account is using the same quota that you modified in step 1. Save the artist account. If everything is configured properly, you will now see a new option in the Artist Menu that says “Add Photo”.
3. Next, click on the “Add Photo” link, and Jamroom will ensure that your database backend is configured correctly for the Artist Photo Galleries.
4. Next, go back to the Admin Menu and double check each of your Jamroom Quotas and ensure it is configured as you want it for the Jamroom Photo Galleries (note that the default setting is “off”).

1. On the Admin menu you should see a link that says “Install Theme” (as long as everything was uploaded correctly as shown above in the “Installing the Jamroom Power Pack” section).
2. Click on the “Install Theme” button, and select the “Umber Alert” option from the selection list. Press the “Install Theme” button and your new theme is installed. Repeat for the “BlackHole” Artist Theme.
3. Next, while logged in as the Master Admin, you’ll want to verify your Jamroom Quotas are configured correctly for the new theme, by making sure it is available in the “Allowed Themes” section of the quotas you wish to have access to it.

1. As long as everything was uploaded correctly (as outlined above), the DarkRed Admin Skin will be immediately available - there’s no installation needed.

1. Make sure the “comment.php” script is uploaded in your Jamroom directory - i.e. jamroom/comment.php. This script is the heart of the Jamroom Guestbook and Comments, which allow you to add these features to your Jamroom site. Note that this script is very similar to the Artist Contact script, in that it is completely template driven and can be modified to look any way you want.
2. The template files for the Jamroom Guestbook/Comments script are located in jamroom/templates/comment. Check out the set of templates that are used by the Umber Alert theme for ideas on how you can customize this script.
3. Next, modify your Jamroom Quotas and look for 2 new settings that relate to the Jamroom Guestbook/Comments script:
   • Allow Comments - setting this to “yes” will enable Artist/Song comments or Guestbook features for artists that belong to this quota.
   • Allow Comment Editing - setting this to “yes” will allow artists that are part of this quota to edit the Artist and Song comments and Guestbook entries that visitors leave on their Artist Site. If this is set to “no”, then only the Master Admin can edit visitor comments and guestbook entries.
4. If you do choose to allow comment editing, you will need to create a Custom Button that links to the comment.php script, and make it available to the quota:
   • Button Label - set this to “edit comments” or whatever text string you would like to use to define the action.
   • Button URL - set this to: comment.php?mode=edit_comments
   • Button Quota - choose the Jamroom Quota this button should be made available to.
   • Save your new Custom Button.

• NOTE: This script was developed on the Apache web server - to ensure it will work correctly make sure you are using the Apache web server (or a web server that allows .htpasswd files as well as access to the htpasswd program).
• First, modify the “protect.php” script and ensure the “$htpasswd_program” variable near the top is set correctly with the path to the htpasswd program:

# htpasswd_program - this variable tells the script the location of the
# htpasswd Apache script for adding users to the .htpasswd file
$htpasswd_program = '/usr/local/apache/bin/htpasswd';

Make sure and save the file.

• Next, log in as the Master Admin in to your Jamroom, and click on the “Create Button” option from the Admin Menu.
• From the Create Button interface, input the following values:
  • Button Label - This can be set to whatever you want to call it, something like “Artist Page Lock”.
  • Button URL - Enter “protect.php?mode=menu” for the Button URL.
  • Button Quota - Make sure this is set to “Master Admin Only”
• That’s it - you will now see a new button in the “Extra” section on the Admin Menu that corresponds to the button you just created. Clicking on this button will allow you to select the artist page you would like to password protect. After selecting the Artist Page to protect, you will be prompted for a user name and password - that will be the user name and password that is used to access the site. Note that more than 1 user name and password can be configured.

• NOTE: Installing the download lock will password protect all downloads in your Jamroom! - do not configure this script unless you would like to make song downloads in your Jamroom password protected. If you do want to password protect your downloads, follow these install instructions (note that leaving the downlock.php script in the jamroom directory is OK)
• First, log in as the Master Admin in to your Jamroom, and click on the “Create Button” option from the Admin Menu.
• From the Create Button interface, input the following values:
  • Button Label - This can be set to whatever you want to call it, something like “Download Protect”.
  • Button URL - Enter “downlock.php?mode=menu” for the Button URL.
  • Button Quota - Make sure this is set to “Master Admin Only”
• Next, you will need to add the following lines to the jamroom/.htaccess file (if you do not have a jamroom/.htaccess file you can create one):

<Files download.php>
AuthType Basic
AuthName "Protected Download"
AuthUserFile /full/path/to/you/jamroom/songs/.htpasswd
Require valid-user
</Files>

Make sure and replace the “/full/path/to/you/jamroom/songs” path as shown above with the REAL path to your Jamroom Songs directory.

• Save the file - Now that it has been saved, ALL downloads from your Jamroom are now password protected. You can click on the Admin Button that you created above to add and remove user/password combinations for those that will be allowed to download.