Documentation

The Facebook Connect module (FBC) tries to have a light footprint on an EE site. It tries to confine itself to syncronizing EE accounts with FB accounts. It does not try to provide a vast array of FB functionality. That will be the work of other add-ons that build on FBC. You can use FBC to send comments on blog posts and Friends module status updates to your FB wall or news feed.

FBC can be used as the primary way that users login to an EE site, so it's possible that you never need to show an EE login form ever again if you wish. There are 3 modes in which you can integrate FBC into your site:

1. You can use the entirely passive mode. In this mode you never show a registration or login form to your site users. When they login using the Facebook Login button they are either simultaneously logged into their EE account or they are passively registered as an EE user and given an account. In this mode, since Facebook prohibits us from storing someone's name or email address for more than 24hrs, a fake username, screenname and email address are created for them based on their FB user id. facebook1234567 becomes the username and screen name. 1234567@facebook.com becomes the email address. Sending email to the fake address will result in bounce backs. We can store a proxied email address for people, but only after they have given the site permission to do so. See Prompt_for_Permission Documentation.
2. You can have people login using the FB login button on your site. They can then be redirected to an abridged registration page provided by the FBC module (FBC:Register_Form). This form requires only a username and an email address. When it is submitted, an EE account is created for the user with that data, connected to their FB user ID. The next time they use the FB login button they will be logged in to their EE account as well. This form respects EE settings about accepting terms of use and requiring captcha. As well, if member accounts require activation, that will also be respected.
3. You can require that people have fully fledged EE accounts in order to use FBC. You can prompt them to register for an EE account as normal. They can then use the FB login button. If they are logged into their EE account at the time they do the FB login, their accounts will be synced. EE accounts are automatically synced to FB accounts whenever someone uses the FB login button while they are already logged into EE. This default can be overridden by using the 'confirm_account_sync' param in the FBC:Login_Button tag. You also need the 'return_to_confirm_account_sync' param to tell FB where to send people once they have logged in through the FB login button. On that page, use the FBC:Account_Sync_Form to allow someone to submit their confirmation to sync accounts.

• Change Log
• Installation
• Updates
• Control Panel
• Creating a Facebook Application
• Overview & Important Notes
• Template Tags
  • Account Sync Form
  • Allow Stream Publish
  • Login Button
  • Login Logout Button
  • Login Status
  • Logout Button
  • Logout JS
  • Member Data
  • Prepare Page
  • Prompt For Permission
  • Register Form