Setting Up Facebook Connect

<tip c w>Do not use or test this feature using the admin account or with any facebook account where the email on that account matches the email of the admin user in your Geo software</tip>

<tip c w>Facebook now requires you to click the "facebook login" button from a secure (https) page. So to use the Facebook Login feature you will need to have an ssl certificate in use on your site. If your whole site is not https all the time make sure to only allow the Facebook login button appear on pages that are ssl like your login page would be.</tip>

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

  1. Install and enable the Social Connect addon in the admin at Addons > Manage Addons, as instructed in Installation of Addons. Within the details for the settings page for the Social Connect app (Addons > Social Connect > Settings) you'll see a redirect url that will be used later in your Facebook App Setup Steps. <
  2. If you do not already have a Facebook App for your website, go to https://developers.facebook.com/ to sign up for a facebook developers account or to verify you have one. Note that you will need to have a personal Facebook account to create a Facebook App. Once setup go to https://developers.facebook.com/apps/. That is the link where you'll manage all the apps attached to your Facebook account. Within that page you'll see link to "Add a New App". Click any one of them <
  3. You will then see a screen like the one below:
    For the Display Name enter what you want the app name to be. This will show when visitors click to login with facebook, it will be used at the top of the window to log in. We recommend using your site's name or something similar. Insert the contact email you will use for this specific app. Once done with those fields click the Create App ID button at the bottom right.<
  4. You will now see a screenshot like the one below. Click the Set Up button within the Facebook Login box on that page :
    \\<
  5. You will now see a page like the one below:

    Click the Web link or www icon.<
  6. Next you will a page like you see here:

    Within that page fill in the url where your Geo software is installed. Once done click the Save button to commit your changes. You should see a Continue button appear. Click it. <
  7. Next you'll go through a series of instructions on setting up the Facebook SDK for Javascript, Check Login Status, Add the Facebook Login Button, and Next Steps. You will not need to go through or do any of the suggestions you see there. All of that is already within your Geo software.
  8. Next click the Settings link you see just below Facebook Login in the left column. That link is shown in the screenshot below. You will now see a page like the one below.

    Within the Valid OAuth Redirect URIs setting pointed out in the above screenshot you will paste in the url mentioned in the first step above from within the settings page of the Social Connect Addon in your Geo admin tool. Pasting the url should be all you need do. To save click Save Changes button at the bottom right of the page. <
  9. Now you will need to get the APP ID and App Secret from you App Dashboard. Click the Settings link in the left column and then the Basic link below that. You will then see a page like the following:

    Within that page you'll be able to get the App ID and the App Secret.

You will need to click on the show button next to App Secret to expose that value for cutting and pasting within those same fields in your ADDONS > SOCIAL CONNECT > SETTINGS section of your Geo admin tool. After entering those values within your Geo admin tool click the save button in that admin tool page.<

  1. Once you are sure you have everything correct you will need to change that status of your app from development to live within Facebook page at top right of the setup pages for your Facebook developers page as shown in the screenshot below:

    Click the sliding button. You will be prompted to fill in the url for your Privacy Policy URL and Terms of Service URL fields before you go live. The Geo software default designs provide links to both of those within the footer of the default designs. You can insert those URLs into those fields. The privacy policy and terms of service we provide are boilerplate and so must be edited to reflect the policies and terms of service for your site. <
  2. Now try the feature on the client side of your website. But DO NOT test this with an facebook account whose email matches the Geo admin users account.<