Creating an Application

To create an application, you need to register on Facebook, go to the http://developers.facebook.com page and follow these steps:

• Enter username and password and click on “Login” to log in with the Facebook credentials;
• Click on “Register as a developer”;
• Activate “Yes” and press “Next”;
• Enter your phone number;
• Press “Send as Text”;
• Enter the code that will arrive via SMS;
• Press “Register”.

If everything is correct, you will see a confirmation message for the registration.

Now, elected to developers, you can create an application that will allow users to log in. To perform this:

• Move the mouse cursor above to “My Apps”;
• In the menu that appears, choose “Create App”;
• Select “Not Specified”
• Type the name of your app in the “App Display Name” field
• Type your email in the “App Contact Email” field
• Then click on “Create App” (if it is required, confirm your credentials)
• Once you have completed the app creation flow, the “Add a Product” page will appear, and in the Facebook Login section, click on “Set Up”
• A banner will appear, and in the WEB URL, you need to enter https://FQDN_TO_YOUR_APPLIANCE/, click “Save”
• Click on “Settings” under the Facebook Login app on the left menu
• Activate all options, leave turned off only Force Web OAuth reauthentication
• Type inside Valid OAuth Redirect URIs https://FQDN_TO_YOUR_APPLIANCE/social/facebooklogin.php

To complete the operation, you need to:

• Type inside “Namespace” field what you prefer
• In the “App Domains” field, enter FQDN_TO_YOUR_APPLIANCE
• In the “Privacy Policy URL” field, enter https://FQDN_TO_YOUR_APPLIANCE/privacy.php?id=9&lang=en, where 9 is the ID of your Manager in which you put your privacy policy
• In the “Terms of Service URL” field enter https://FQDN_TO_YOUR_APPLIANCE/terms.php?id=9&lang=en, where 9 is the ID of your Manager in which you put your Terms & Conditions
• Add the Icon App according to the Facebook directive (1024×1024 pixels)
• Flag “Clients”
• In the Category, choose “Social Networks”
• In the top menu, switch from “In development” to LIVE, and confirm switch mode

At this point, you need to copy the Application ID and the APP secret in your Wi5stars. From the “Admin” tab“, click “ External Authentications”,  expand Social Networks and enter the details in the “Facebook ID” and “Facebook secret” fields.

Starting from March 2018, all new created Apps have the “Apply HTTPS” setting within the Facebook login/settings menu, enabled by default and cannot be disabled. In order to use the login via Facebook you must install a valid certificate inside Wi5stars and set in the field “Redirect Uri valid oAuth” the domain in HTTPS. For old Apps, the “Apply HTTPS” setting, must be activated within March 2019.

Since version 5.0.180 you can no longer get gender, year of birth and the user’s city by Facebook. The choice has been forced by Facebook to introduce more restrictive policies on using the App and consequent to approval procedures much more complex. The restrictions take effect from 1 August 2018.

Creating a Page to Invite Users to Press “Like”

At the end of registration or at user login, you can invite to click “Like” to a page. To do this you have to create a page and get his ID to insert in the domain or HGW configuration.
To create a page, you must have a Facebook account, go to https://www.facebook.com/pages/create.php page and follow the procedure.
The page ID is determinable in the URL of the page you created. In practice if the URL of the new page is https://www.facebook.com/pages/NameNewPage/1234567890, the page ID is 1234567890.