In this section, we'll go through the steps for creating and configuring a Facebook application through the Facebook developers portal.
Step 1: Create your Social Network Application
Login with Facebook, enter: developers.facebook.com and register a Facebook developer account by clicking Get started in the top right corner.
Then, go to the My Apps dropdown and click "Add a new App".
A pop-up will appear with fields for your to enter your desired Display Name, Contact Email and Category. Fill in the fields with the correct information, and then click "Create App ID".
Step 2: Configuring the callback URL
The callback URL is the URL where you should redirect the user when they complete the social login process. You are required to include the callback URL in the configuration settings of your application so that Facebook can confirm you own this URL and that it is secure.
To configure your callback URL, click on +Add Product in the left-hand menu and then click "Get Started" in the Facebook Login tab.
Step 3: Decide which user permissions you will ask for in your app
By default, Facebook allows you to request the following basic user permissions (no extra steps required):
However, in order to obtain additional valuable information from your users such us their Likes, Posts or Locations, we also recommend to request these advanced Facebook permissions:
In order to request these advanced user permissions, your application will have to be approved by Facebook through a review process, where Facebook will check that all data privacy and usage requirements are met according to their policies. Without approval, your Facebook application will only be allowed to request basic user permissions. To submit your Facebook application for review, navegate to the App Review section in the left-hand menu and click "Start a Submission".
On the next screen that appears, you'll see a list of all the advanced user permissions that can be requested, for which you are requesting approval from Facebook. Select the user permissions you would like to request in order to access specific social datapoints about each user that logs in via your Facebook login option:
Step 4: Getting Facebook approval to request advanced user permissions
As part of the review process, Facebook will be checking that your application makes use of the social data requested to enchance the user's interactive experience on your website, application, mobile application or Wi-Fi hotspot.
To get your applications approved by Facebook, you'll need to:
- Implement the Xeerpa Connect Summary Widget (see below).
- Send submission to Facebook.
Once you've selected the desired user permissions, Facebook's review process can take anywhere between 3-5 days.
Xeerpa Connect Summary Widget
How they work
- User signs in with Facebook into your website or app.
- User accepts your request for user permissions.
- Xeerpa analyses the user's profile and returns the widget's HTML code based on her/his data.
- The HTML code can be rendered anywhere within your website or app, typically the "My Profile" page.
How to use them
To use the Xeerpa Connect Summary Widget, they must be invoked in the call to Xeerpa. Depending on the connection method you're utilizing, have a look at either Xeerpa Connect Backend Auth or Xeerpa Connect Discovery to learn more about implementing these widgets.