Configuration Guide

User Configuration Settings:

JFBConnect can be used on a standard Joomla installation to allow for quick and painless registration, or in conjuction with the 3rd party community components JomSocial, Community Builder, Kunena, K2, Agora and Virtuemart to automatically populate profile data. Click on the "User Configuration" tab to set this up; the settings below relate to all configurations. 

If you don't plan to let users login or register through Facebook, please skip to the next section.

Registration Flow:

• Normal Registration- when new users register to your site, they will be presented with the 'Quick Registration' page which asks for their username, password, and email address. Once entered, they will have a fully-functional Joomla username that they can use to access the site OR they can return and log in with their Facebook credentials by using the blue Facebook connect button. This setting is enabled on our JFBConnect demo site, which you can test at: http://demo.sourcecoast.com

• Automatic Registration- when new users sign up on your site, a username will automatically be assigned to them; their email address and full name will be imported from Facebook. On return visits, they will be able to login by using the Facebook connect button. Additionally, if the Generate Random Password option is enabled, a username and password will be generated, which the user will be able to log in with later. With Automatic Registration, all functionality within Joomla and 3rd party components will perform the same as normal (they will be treated as "Registered" users). This setting is a great way to let users access your site with minimum hassle. This setting is enabled on SourceCoast.com (this site). To test out how it works, simply log in above.

In both cases, if you have JomSocial, Community Builder, Kunena, K2, Agora, or Virtuemart integration enabled, the user's profile will automatically be imported into the respective profile (as configured in later sections).

Automatically Link Facebook Users by Email:

Enabling this setting will automatically connect a new Facebook user to an existing user on your Joomla site if their email addresses match. This is great for sites with lots of existing Joomla users to make adding Facebook Connect a smooth process.

If the email address is already taken in the system, a blank email address field will be shown for the user to manually enter a new email address, regardless of the Email Field on Registration setting. If the user then tries to enter the taken email address, an error will be shown to the user to enter a new valid email address.

Email Field on Registration:

Selecting 'Hide' for this setting will automatically set the new user's email address to their Facebook email address, or proxy email address if they don't allow your site access to their real email permission. If set to 'Show', an Email field will appear on the registration form, pre-populated with their Facebook address.  This only applies when the Registration Flow setting is set to "Normal Registration"; therefore, this option will be hidden in the backend when "Automatic Registration" is selected.

Auto Username Prefix

When Automatic Registration is selected, JFBConnect will automatically generate a username for the Joomla user that will be created. The username will consist of a string and a unique number; this option specifies the format of the string prefix for the new username. This only applies when the Registration Flow setting is set to "Automatic Registration"; therefore, this option will be hidden in the backend when "Normal Registration" is selected.

Generate Random Password

When Automatic Registration is selected, JFBConnect can automatically generate a password for the Joomla user that will be created. The automatically generated username and password will then be mailed to the user on account creation. On return visits, the user can either use these account credentials or their Facebook credentials to log in to the site. This option only applies when the Registration Flow setting is set to "Automatic Registration"; therefore, it will be hidden in the backend when "Normal Registration" is selected.

Skip Joomla User Activation:

This setting allows additional control for User Activation. If you have enabled new user account activation in Joomla (in the User Manager - Options), enabling skip here will automatically activate all new Facebook users. If set to No here, then the New User Account Activation setting in the User Manager Options will be used for all new Facebook users. We recommend enabling this setting, because Facebook users' email addresses are already verified.