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-3.0.20.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-3.0.20”.
- 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/search.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.
 |
Note: As of Jamroom 3.2, the Progress Meter files are no longer included as a progress.zip file - they are now contained in the /cgi-bin directory of the Jamroom root directory. The files inside this directory must be moved to the correct /cgi-bin directory for your server. |
- Finally, if you are using Jamroom 3.1.b1 or newer, unzip the "progress.zip" file that is within the directory created in the second step. This file contains the Perl scripts used by Jamroom for the upload progress meter. If you do not wish to use the Upload Progress Meter, you can skip this step. After unzipping the progress.zip file, upload the contents to the /cgi-bin directory on your web server (this is usually located in your home directory - i.e. /home/yourname/cgi-bin - if you cannot find your cgi-bin directory, you may need to contact your hosting provider for assistance on where you should place perl scripts).
All of the files required by the Jamroom Power Pack have now been installed.
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 3 "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 3 "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
If you are running Jamroom 3.1.b1 and newer, a new option has been added to the Jamroom Power Pack to allow the use of an "Upload Progress Meter". This 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 ".pl" 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 3.0.x install, 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.
- Within the Jamroom Power Pack download, you will find a directory called "cgi-bin" - inside this directory you will find several files. Open the file called "uu_default_config.pm". Within this file are 2 settings that you must change to reflect the proper URL and path to your Jamroom directory:
redirect_url => 'http://www.yourjamroomsite.com/progress.php',
upload_dir => '/path/to/your/jamroom/compile/',
You will want to change the URL to be the correct path to the progress.php script in your Jamroom directory. Note that if you are not sure what your "upload_dir" would be, if you save the file with only the "redirect_url" saved, and upload that back to your web server, when you run the Jamroom Tools -> Server Check, Jamroom will tell you the proper value to use
- Next, you want to upload the entire 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. You would end up with the "uu_default_config.pm" being located at /home/yourname/cgi-bin/uu_default_config.pm
- Next, you will want to change the permissions on the "uu_ini_status.pl" and "uu_upload.pl" to be 555 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. If you are using a Windows based server, you must allow these files to be executed by the web user.
- 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/uu_ini_status.pl
If your server is configured properly, you should get the following message in your browser:
ERROR: Invalid parameters
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.
Errors and Problems with the Jamroom Progress Meter
- I am receiving the error "Failed to mkdir /full/path/to/your/jamroom/compile/directory/: No such file or directory"
- You will receive this error if your Progress Meter is not installed properly. You need to make sure you have entered the proper FULL PATH to the jamroom/compile directory in the /cgi-bin/uu_default_config.pm file.
- I see the error "verify /cgi-bin/uu_ini_status.pl and /cgi-bin/uu_upload.pl are permissioned to 555" in the Jamroom Server Check
- First, check that the jamroom/cgi-bin/uu_ini_status.pl and jamroom/cgi-bin/uu_upload.pl are permissioned to 555 (or 755), and are executable on your web server. To test that it is executable, you can try loading the uu_upload.pl script directly within your browser - i.e. "http://yoursite.com/cgi-bin/uu_upload.pl" - you should see a RED Error message - if you do not, it means that CGI scripts are not set to run on your server. Alternately, it can mean that you have placed the Jamroom cgi-bin files in the wrong directory. If you are using a Plesk or Cpanel, you may see a cgi-bin directory at the same level as your httpdocs or public_html directory - if you do, then you will need to move the /home/username/public_html/cgi-bin Jamroom CGI files into the /home/username/cgi-bin directory, and try executing them again. If you are not able to get the cgi-bin files to work on your server, you will need to contact your hosting provider for assistance on where to place CGI perl scripts.
- I am receiving the message "ERROR: Failed to find flength file" when trying to use the Progress Meter.
- You will receive this error if Apache mod_security is running on your server, as it does not allow the server to "talk back" to itself. You may be able to work around this situation by adding the following code to the .htaccess file in your Jamroom directory (if you do not have a .htaccess file, you can create one. This will work on the Apache Web server only):
<IfModule mod_security.c>
# Turn off mod_security filtering.
SecFilterEngine Off
# The below probably isn't needed, but better safe than sorry.
SecFilterScanPOST Off
</IfModule>
If this doesn't work, then you will want to contact your hosting provider for assistance.
- I'm trying to upload very large files (over 1.5 gigabytes) and the upload is failing - what's wrong?
- As long as your PHP Maximum Allowed Uploads size is set large enough, you will also want to set the max allowed upload size in the Progress Meter config file, which by default is set for 1536 megabytes (as of Jamroom 3.3.0). You'll need to edit the /cgi-bin/uu_default_config.pm and change this line:
max_upload => 1610612736,
to something larger like:
max_upload => 1900000000,
Save the file and you should be configured to upload larger file sizes.
|
