• First, make sure you have download the latest version of the Jamroom Bonus Pack from the Jamroom 4 Core Downloads Page ¹⁾.

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

• 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/chart.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 Bonus Pack do not exist in your Jamroom install.

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

After installing the Jamroom Bonus Pack, you will see new "Signup options" will become available in the "General" tab of your Jamroom Quota config. You’ll want tocheck out this section and ensure all the Signup choices are configured as you want them to be. When you are satisfied with your configuration, press the “Save Changes" button to save the new signup settings to the quota.  There are also some new settings related to signing up that are available in the Jamroom Config -> Account Settings section - these relate to admin notification and if your users will be required to complete a CAPTCHA test to signup.

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.

Configuring Jamroom to allow your users to "invite" their friends to join

One feature you may want to add is the ability for your friends to "invite" their friends to join your Jamroom.  This is a great way to expand the membership of your system.  Enabling access to the Invitation system is easy

• In the Jamroom Quota that you want to enable the Invitation System for, select the "modify" button next to it in the Jamroom Config -> Jamroom Quotas section
• Scroll down a bit - you will see the new settings for "Allow Invitations" - make sure this is set to "yes".  There are 2 additional settings that impact the Jamroom Invitations:
  • "Max Invites Per User" - this allows you to set a "cap" on the number of invites a single user can send.  Set this to 0 to allow unlimited invites.
  • "Invite Profile Quota" - when a user has accepted the "invite", what Jamroom Quota will their account be created under?
• Make sure the 3 settings are as you want them, then save the Jamroom Quota settings.
• Repeat these steps for each Jamroom Quota you want to enable the Invitation System for.

Next, after configuring the Jamroom Quotas as you want them, you'll want to create a Custom Button that allows your users view the invitation system:

• Click on "Jamroom Config" -> "Custom Buttons" as the master admin
• Click on the "Create Button" button at the top of the page in the "Options" section
• Enter the following information to create the new Custom Button
  • Button Label - "Invite a Friend"
  • Button Url = "signup.php?mode=invite"
  • Select all of the Jamroom Quotas you want this available for in the "Button Quotas" section
  • Create your new Custom Button by clicking on "Create Button"

That's it - your new button has been created, and your users can invite their friends to signup in your Jamroom!

1) A Valid Jamroom License code is required to download the Jamroom Bonus Pack.
2) This option was developed and tested with the Apache web server - there’s no assurance this will work with other web servers