The Social Connect Addon is meant primarily to allow your users to both register, and log in, using popular social websites such as Facebook and Google+. Currently only Facebook connect is implemented but we have plans to add more sites in future versions.

The secondary function is to add various integration options, such as showing a seller's Facebook profile pic on the seller's listings.

This addon currently allows users to click a link Login with Facebook. This will pop up a window that will let them log into their Facebook account, and "approve" your website's Facebook app to access minimal information. The user is then taken back to the site. Below are the different scenarios for what will happen:

• If the Facebook profile ID is already attached to an account in the software, the user is logged in under that account. <
• If the user's e-mail matches a user already in the system, then the user is logged in as that user, and the Facebook profile is attached to that user. <
• Rare Scenario: If trying to link up a FB account to one account, when it is already linked to another account, it will merge both user accounts together using the "older" of the two user accounts in the system. Typically this will happen if someone that already has a user account attempts to use "login with Facebook" when the e-mail does not match, so that it creates a brand new user account. If that user later tries to link the FB account to the older account within the software, it will merge the newer account created using Facebook connect into the pre-existing older user account. <
• If there are no matching accounts on the site yet, it will register a new "minimal" user with the following information obtained from the user's Facebook profile:
  • Username: Tries to use the best appropriate username in the software according to the following heirarchy:
    1. Facebook username if set for the profile¹⁾ - example: facebookusername <
    2. First name and last initial - example: First L <
    3. Full name - example: First Last (Only if first/last name could not be determined) <
    4. If the username generated matches one in the system, it adds a number - example: First L 1 or First L 5 if happen to already have 4 other users with same first name and last initial. <

<

• First Name: Set to first name in Facebook profile. <
• Last Name: Set to last name in Facebook profile. <
• Email: Set to e-mail for Facebook profile. Note that when user is "allowing access" to your site, they can elect to use anonymous e-mail, which will still work fine, you can read more info on facebook.com's FAQs. <
• Country: It looks at the "locale" on the Facebook profile, and attempts to determine if it matches to any countries within the software. If it finds a match, it sets the user's country. <
• Profile ID: In order to allow future "login with facebook" to work, and to allow displaying the profile picture for the user, it stores the Facebook profile ID. <
• That's all! Even if you have other required fields set in your registration settings, the above are the only fields that will be populated for a user registered using Login with Facebook. If however, the user ever tries to edit the profile information within "my account" area, it will require that all required fields are entered at that time before they can save any other changes. <

<

These instructions will walk you through steps necessary to set your site up to start using Facebook Connect.

1. Install and enable the addon as instructed in Installation of Addons. <
2. If you do not already have a Facebook App for your website, go to http://developers.facebook.com/setup to sign up.

1. For the Site name enter your website's name. <
2. For the Site URL enter the URL to the website, like http://example.com <
3. The rest of the instructions are pending. <

<

1. In the admin, go to Addons > Social Connect > Settings. <

We have plans for the future! Eventually we'll put them here.