Jomsocial Facebook Connect application Guideline

Facebook Connect

Facebook Connect in JomSocial allows users who already have a Facebook account to seamlessly connect their Facebook account and information with your site with a single sign on process which does not require the user to remember multiple account information.

Setting up Facebook Connect

1. To setup Facebook connect, you will first need to create a new application in Facebook by accessing http://www.facebook.com/developers/. You are required to have a Facebook account.

At the top right, there should be a button called 'Set Up a New Application'


2. Give your application a name. This name will appear as your applications and you are not restricted to use any name. You will have to read through Facebook's Terms of Service before accepting it.


3. Copy your API Key and Secret. You will need to submit this information inside JomSocial Configuration. Describe your application, change your icon and logo if you already have them. Remember, your API Key and Secret should not be given to anyone else. You will be awarded the API Key and Secret once your application is saved.


4.Submit your Contact details. Help, Privacy & Term of Service are optional.


5. Then browse to the Authentication Tab. At Authentication Settings, select both Users and Facebook Pages. Submit your URL at the Authentication Callback URLs.


6. Then browse to the Connect Tab. All fields under Facebook Connect Settings must use an absolute URL EXCEPT Base Domain. For Base Domain, just submit your domain (without http://www). Now you are done. Save all your changes.


7.Now save the changes done to your new Facebook Application.


8. Above is a quick information that you will see once you saved your application. Copy the Secret and API key.


9. Go to JomSocial Configuration > Facebook Connect and paste the API Key and Secret.


10. Congratulations! JomSocial Facebook Connect is now set up on your website!


Note: Facebook Connect is only applicable for JomSocial version 1.2 and above.

Common Issues and Conflicts

Symptom
Facebook Connect does not work on site with 'www' or vice versa.

Remedy: Check the 'base domain' setting under Facebook Application page. Do not use http://www.yoursite.com or http://yoursite.com. Only submit yoursite.com.


Symptom
Facebook Connect button does not show up.

Remedy: Install Firebug for Firefox and locate whether you have any Javascript conflict. If the origin of the conflicting javascript is from other module or plugis, try disabling the specific module or plugin.