Social Login: Facebook App Setup

      Overview

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

      Creating a new app

    1. To allow users to login to your site with their Facebook account you need to create a Facebook app. 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, login to the site using your Facebook account details
    4. Once logged in, click on Add a new App button. Fill out the Display Name, Contact Email. Then click the Create App ID button.

      Note: After clicking this button you may be presented with a security check

      Note: Add your website URL to the "Site URL" field below.

      Setting up the app

      After creating the app you should be taken to the dashboard page for your new app. There are a few steps which you will need to do before your app setup is complete.

      Settings Tab > Basic 

      On this tab you can get the App ID and App Secret. You need to copy and paste both of these into the Facebook tab on the Ultimate Member Settings Facebook tab. In particular, it is important that you fill in the following information: Privacy Policy URL and Terms of Service URL. Under the Add Platform - Select platform choose Website and add your website URL. You can also add app icon to make the app look more professional then click the "Save Changes" button.

      Settings Tab > Advanced 

      App Restrictions - You can restrict your app to 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:

      Products Tab

    1. On the Products tab, click on +Add Product then click Get Started button on Facebook Login.

      2. After you clicked the Get Started button, click on Settings under Facebook Login tab.

      Client OAuth Settings - You just need to enter your site's login, register and account's social tab URIs into the Valid OAuth redirects URIs field.

      Note: Starting from March 2018, Facebook API developers will turn "Use Strict Mode for Redirect URIs" option On by default. So to make the UM Social Login extension compatible, put additional URI without the "/?provider=facebook"  from the redirect URIs e.g. "https://www.ultimatemember.com/login/" and keep the existing ones.

      You can just leave the  Deauthorize Callback URL blank then click on save changes.

      App Review Tab

      Once you have done all these steps you can go to the App Review tab to make the app live. The app does not need to be submitted for approval as the app will only be requesting the standard data from users. To make the app live all you need to do is Click the switch button from No to Yes:

      App Setup Complete

      Once you have done all that, the app is now complete. You should now add the App ID and App Secret into the Ultimate Member Settings Facebook Tab if you have not already done so.