Installing the Jamroom Power Pack

• First, make sure you have download the latest version of the Jamroom Power Pack from the Jamroom Downloads Page.

• Next, uncompress the downloaded archive (it will be named something like "jamroom-powerpack-4.2.1.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-powerpack-4.2.1”.

• 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/comment.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.

• Next, if you haven't already done so, install the GetID3 Option.

Enabling the use of Video in your Jamroom Quotas

Now that you have uploaded the Jamroom Power Pack files, the next step is to enable the Video Support for the Jamroom Power Pack:

• First, log in to your Jamroom as the Master Admin, and click on the "Jamroom Config" option available from the Jamroom Admin menu.
• Click on the "Jamroom Quotas" option available within the Jamroom Config menu.
• Select the Jamroom Quota that you want to enable Video Support in, and click on the "Modify" button to the right of the Quota.
• Click on the "Media Support" tab located along the top, and part way down you will see the "Video Settings".
• Set the "Allow Videos" option to yes (you can also set the other options in the section if you would like), and save the settings.

That's it - Video support will now show up for Artist profiles using the Jamroom Quota.

Enabling the Jamroom Photo Galleries in your Jamroom Quotas

Now that you have uploaded the Jamroom Power Pack files, the next step is to enable the Photo Gallery Support for the Jamroom Power Pack:

• First, log in to your Jamroom as the Master Admin, and click on the "Jamroom Config" option available from the Jamroom Admin menu.
• Click on the "Jamroom Quotas" option available within the Jamroom Config menu.
• Select the Jamroom Quota that you want to enable Photo Gallery Support in, and click on the "Modify" button to the right of the Quota.
• Click on the "Media Support" tab located along the top, and part way down (under "Image Settings") you will see the option for "Allow Photo Gallery".  Set this option to "yes'.
• Save the Jamroom Quota settings.

That's it - Photo Gallery support will now show up for Artist profiles using the Jamroom Quota.

Enabling the Jamroom Comments/Reviews script

Now that the Jamroom comment system has been installed with the Jamroom Power Pack, you can enable the Jamroom Comments:

• First, log in to your Jamroom as the Master Admin, and click on the "Browse Quotas" option available from the Jamroom Admin menu.
• Select the Jamroom Quota that you want to enable Comments/Reviews Support in, and click on the "Modify" button to the right of the Quota.
• Click on the "Site Features" tab and set the "Allow Comments" setting to "yes".  You can also (optionally) set the "Allow Comment Removal" option here as well, which allows the Artist/Member to remove comments that have been left on their profile page.
• Save the Jamroom Config settings.
• Regenerate your Artist Pages from the Jamroom Tools menu.

That's it - if you are using a Jamroom Profile theme that supports comments/reviews (like the default Jamroom 4 "Cobalt" theme), they will now be activated on the profile page.

Enabling the Profile Page Guestbook option

Now that the Jamroom guestbooks have been installed with the Jamroom Power Pack, you can enable the Jamroom Guestbooks:

• First, log in to your Jamroom as the Master Admin, and click on the "Browse Quotas" option available from the Jamroom Admin menu.
• Select the Jamroom Quota that you want to enable Guestbook Support in, and click on the "Modify" button to the right of the Quota.
• Click on the "Site Features" tab and set the "Allow Guestbook" setting to "yes".  You can also (optionally) set the "Allow Guestbook Removal" option here as well, which allows the Artist/Member to remove guestbook entries that have been left on their profile page.
• Save the Jamroom Config settings.
• Regenerate your Artist Pages from the Jamroom Tools menu.

That's it - if you are using a Jamroom Profile theme that supports the Jamroom Guestbook (like the default Jamroom 4 "Cobalt" theme), they will now be activated on the profile page.

Enabling the Artist and Member Page Lock

The Jamroom Artist and Member Page Lock is a feature that allows you to password protect an entire Artist or Member Page - this makes it easy to create an Artist Profile, and then make it only accessible to those that have the  proper username and password.  This allows you to "stage" events on an Artist Page, such as having an online "release party" that is invite only, for example.  To enable the Artist and Member Page Lock, follow these steps:

• Log in to your Jamroom as the Master Admin
• Click on the "Create Button" link located in the Master Admin control panel
• Enter the following values for the new Custom Button:
  • Button Label - "Page Protect" (or whatever you would like to call it)
  • Button URL - protect.php?mode=menu
  • Button Quota - select "Master Admin only"
• Save the new Custom Button and refresh the Master Admin menu.

That's all to setting up the Artist and Member Page lock - Now you can click on the new "Page Protect" link in the "Extras" section, and you can enter username/password combinations on a per Artist/Member basis.

Enabling the Jamroom Community and Profile Forums

With the release of version 3.1, Jamroom now features a built in Community Forum, as well as individual forums for your profiles!  By default this new feature is not active, and so you will want to activate the Forum in the Jamroom Quotas you want to grant access, as well as enable the system-level Community Forum if desired.

Enabling the Jamroom Community Forum

To enable the Jamroom Community forum, log in to your Jamroom as the Master Admin, and click on the "Jamroom Config" option.  Next, go to the "Forum Settings" option.  From within this section you can enable the Community Forum, as well as set some other additional Forum options to your preferences.  Make sure and save the settings and you should be set.

 Note: The Jamroom Skin you are using will need to have a link to the Community Forum added if it does not support the forum feature.  By default, the Jamroom "Cobalt3" and "Sage" skins support the Community Forum, and these skins can be used as a base to add forum support to your own custom skin.

Enabling the Jamroom Forums for your Profiles

If you would like to alow your Jamroom Profiles to have their own forum on their profile page, you can enable this option with the Jamroom Quota Config.  Simply click on "Browse Quotas" as the Master Admin, then "modify" next the Quota you want to add the forum option to.  Next, click on "Site Features" and make sure the "Allow Forum" option is set to "yes".  Save your settings and the profile will now support a forum.

 Note: just like the Jamroom Skin, your Profile Theme will need to support the Jamroom Forum.  The Jamroom provided "Cobalt3" and "Sage" Profile Themes support the Profile Forum, and can be used as the basis for a custom profile theme.

Enabling the Jamroom Upload Progress Meter

The "Upload Progress Meter" feature is very helpful for users on slower internet connections as it gives them a continual visual indicator of how much they have uploaded, and how much time is left before their upload is finished.

The Jamroom Progress Meter has a separate set of requirements, as it is written in the PERL programming language (not PHP):

• You must have access to the perl interpreter on your server (all Unix/Linux servers will have this by default)
• You must be allowed to run CGI scripts - this is usually done from a "cgi-bin" directory on your website
• Your hosting provider must have the file extension ".cgi" setup to be processed as a CGI.

If you are unsure of these requirements, your hosting provider should be able to tell you if your server meets the requirements.

Once you are sure your server is setup to work with the Jamroom Progress Meter, follow these steps to configure your progress meter:

• First, if you are upgrading an existing Jamroom 4.1.x install (or older), you will need to modify your jamroom/config/settings.cfg.php file and add the following line in, right after the "jamroom_url" entry:

$config['jamroom_cgiurl'] = 'http://www.yourjamroomsite.com/cgi-bin';

This of course needs to be the proper URL to the cgi-bin directory on your server (the place where you would run perl scripts from).  After adding in the URL, save the file.

• Next, you want to upload the progress.cgi file from the cgi-bin directory to the cgi-bin directory on your web server.  Typically this directory can be found in your home directory on your web site when you log in via FTP.  For example - if your cgi-bin directory on your server is located at /home/yourname/cgi-bin, then you would upload the files from the Jamroom Power Pack cgi-bin directory directly into the cgi-bin directory.

• Next, you will want to change the permissions on the "progress.cgi" file to be 755 using your FTP client.  If you are unsure of how to change permissions on a file, you will want to consult your FTP client documentation for assistance.

• Next, we want to test and see if CGI scripts are working properly on your server.  You want to try and "load" these perl scripts in your browser - i.e.

http://yoursite.com/cgi-bin/progress.cgi

If your server is configured properly, you should get the following message in your browser:

 ERROR: Invalid tmp value received!

If you don't, and instead receive a "Page not found" or other browser error, then it likely means your server is not setup properly for CGI scripts, and you will want to contact your hosting provider for assistance on how you should install CGI scripts.

• With that configured, you can now log in to your Jamroom and enable the use of the Upload Progress Meter within the Jamroom Quotas you would like to give access to this feature.  You will find the Upload Progress Meter setting in the 'Media Support" section of the Jamroom Quota config.