How To Create a Facebook custom App for the Splash Page

This article explains how to create a new Facebook custom App for your White Label Domain and obtain the right permissions to use it.
 

Part 1: How to create a new Facebook APP 

 

STEP 1

Go to https://developers.facebook.com ‎and log in with your Facebook credentials.

 

STEP 2

In the upper left menu bar click on "My Apps" then "Add New App" and choose "Other uses"

​
 







write the name of your App and click on "Crate App ID"





 

STEP 3

The  “Quick Start for Website” page will appear, if you want skip it and on the left menu, click on Settings ---> Basic



 
Add your App Domain, the full URLs of your Policy and Terms of Service.
Then  click on “+ Add Platform”
 

NOTE
Please change yourdomain.com  with your current setting, according to this article: Creating CNAMES for your Splash Page, Dashboard and Splash Editor.

STEP 4

From "Select Platform" page choose “Website”.


 

Add your website  URL in the format:
 

​http://splash.yourdomain.com

 

NOTE
Please change splash.yourdomain.com with your current setting, according to this article: Creating CNAMES for your Splash Page, Dashboard and Splash Editor

 

STEP 5

On the left menu click on Products and  then Set Up in the Facebook Login box. 

 

STEP 6

If you prefer skip the proposed default "Use the Quickstart to add Facebook Login to your app" and click on Settings under Facebook login.
In the  "Client OAuth Settings" page set  "Valid OAuth redirect URIs" with  your splash page address such as 

 

https://splash.yourdomain.com/index.php?action=oauth_facebook_callback

 

NOTE
please change splash.yourdomain.com with your current setting, according to this article: Creating CNAMES for your Splash Page, Dashboard and Splash Editor.

 Save your setting and test your URI
 

 

CAUTION
Starting from March 2018, Facebook introduced a new parameter "Enforce HTTPS" that requires some changes in the below procedure.
In any new Facebook App, this parameter is active by default and can't be changed.

We created a specific article to keep track of this change and any possible impact on the procedure for old and new Apps:

The Enforce HTTPS setting on Facebook apps prevents them from working correctly on splash pages belonged to White Label accounts

Part 2: How to go live with the new  APP

 

STEP 1

On the top of your page change the status from "Under development"  to "Enable" 



 

 

Now your new Custom App with basic permissions is ready for use 

 

NOTE

After these steps, by default, Facebook allows your App to access Facebook user's email and profile info, thanks to these two permissions:

       -  email
       -  default

This is enough to get you Facebook App.

 

 

 

STEP 2

In order to use your new Facebook App with your White Label Splash Page, on the left menu click on  Settings -->Basic,  write down the App ID and App Secret  and set them  in "White Label Splash Editor", like shown in this article:
How to configure the Classic Hotspot Splash Page to work with your custom app

 

STEP 3 (OPTIONAL)

If you need to get extra user's information (like his birthday or his location), you will need to start a Facebook App Submission, which requires extra steps, and a more complicated process to get the approval from the social media.

If this is your case, please follow this article:
Request additional Facebook permissions for your custom Facebook App

 

 

Related articles:

How to configure the Classic Hotspot Splash Page to work with your custom app