Social Login: Facebook App Setup
This document provides instructions on how to properly set 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 login via Facebook.
Creating a new app
- To allow users to log in to your site with their Facebook account you need to create a Facebook app. To create a new Facebook app please do the following:
- Go to the Facebook Developers site: https://developers.facebook.com/
- If you are not logged in, log in to the site using your Facebook account details
- Once logged in, click on Add a new App button then Choose the "Consumer" type.
- Fill out the Display Name, Contact Email. Then click the Create App ID button.
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 that you will need to do before your app setup is complete.
App Review > Permissions and Features
On this tab, you can set the permissions for scopes. In Graph API version 11, it is required that you add advanced permissions to scopes `public_profile` and `email` so that the API returns the Email Address and syncs it with UM Form. Click on the "Request Advanced Access" buttons.
Settings > Basic
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:
Facebook Login > Settings
On the Products tab, click on +Add Product then click Get Started button on Facebook Login. After you clicked the Get Started button, click on Settings under the Facebook Login tab.
Client OAuth Settings - You just 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 are planning to use the social login shortcode on the custom page.
We recommend adding additional URLs with the parameter " return_provider" and "provider", see example:
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.