Social Login: Facebook App Setup

     Overview

    This document provides instructions on properly setting up a Facebook application so that users can log in/register via Facebook on your site. You will need to purchase the social login extension if you want users to log in via Facebook.

    Creating a new app

    1. You need to create a Facebook app to allow users to log in to your site with their Facebook account. To create a new Facebook app, please do the following:
    2. Go to the Facebook Developers site: https://developers.facebook.com/.
    3. If you are not logged in, log in to the site using your Facebook account details.
    4. Once logged in, go to My Apps.
    5. Click on Create App button. It will lead you to the app creations page.

      You'll be asked here " Which use case do you want to add to your app?" Select "Set up Facebook Login" then click on the Next button to continue.

    6. Fill out the App Name, and App Contact Email. Then click the Create App button.

      7. Note: After clicking the Create App button, you may be presented with a security check

      You will then get redirected to the App Dashboard page. On the left-side menu, go to Products > Added Products.


      Click on Quickstart from the Configure drop-down in the Facebook Login product. 

      Select the Web from the platform if you want to add a Facebook login to your app.

      Note: Add your website URL to the "Site URL" field as shown in the image below. Then click on the Save & Continue buttons.

      Setting up the app

      After you've completed creating the app, head to the app's navigation menu. You need to do the steps below before your app setup is complete.

      Go to App Review > Request Permissions and Features

      When you click on the  Request Permissions or Features button, you'll be redirected to Facebook Login Use Cases. You can set the permissions for scopes here. Add public_profile and email permission by clicking on the "Add" button. 

      Go to Settings > Basic 

      This tab contains the App ID and App Secret. Both must be copied and pasted later into the Ultimate Member> Settings>Extension>Social Login>Facebook Social Connect tab. You must fill in the following information: Privacy Policy URL and Terms of Service URL, and you can also include an app icon to make the app appear more professional.

      When you scroll down the page, you will find the Website section. Add your Site URL, then click the "Save Changes" button.

      Go to Settings > Advanced 

      App Restrictions - You can restrict your app to a specific age range and countries if your site references alcohol or an adult nature site.

      Security - These are optional if you wish to make the app more secure:

      Go to Products> Added Products>Facebook Login > Configure>Settings

      Client OAuth Settings - You need to enter your site's login, register, and account's social tab URIs into the field "Valid OAuth redirect URIs." Add the custom page URL if you use the social login shortcode on the custom page. 

      We recommend adding additional URLs with the parameter " return_provider" and "provider," see example:

      To make the app live, you need to go to the navigation menu and click on "Go Live"

      Note: Before switching to live mode, you must complete all the r equirements.

      When you complete the requirements, make sure to click on the "Go Live" button on the bottom right corner of the page.

    App Setup Complete

    After you've done all of that, the app is complete. Add the App ID and App Secret to the Ultimate Member Settings Facebook tab.

    Go to Meta for Developers > Settings> Basic      then Copy the App ID and App Secret.

    Go to Ultimate Member> Settings>Extension>Social Login>Facebook Social Connect tab, and paste the App ID and App Secret in the Facebook Social Connect App ID and App Secret fields.