Use Facebook identification (prefixed syntax)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Overview
The elements proposed by WLanguage
Declaring the application in Facebook
Declaring the WINDEV application in Facebook
Declaring the Android application in Facebook
Declaring the iOS application in Facebook
Declaring the WEBDEV site in Facebook
Implementing the Facebook identification in the WINDEV or WINDEV Mobile application or in the WEBDEV site
Establishing the connection
Using the Facebook API

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Use Facebook identification (prefixed syntax)

Overview

Facebook, 1st social network in the world, is very much used by the companies to group their customers. Facebook includes a very powerful API to efficiently exploit the platform.

WINDEV, WEBDEV and WINDEV Mobile (for the Android and iOS applications) propose two modes for using Facebook:

a simple use, where the Facebook login of user can be used to identify in the WINDEV or WINDEV Mobile application or in the WEBDEV site. The end user will have less passwords to remember.
an advanced use, allowing you to interface with Facebook in order to use the Facebook API from a WINDEV or WINDEV Mobile application or from a WEBDEV site.

The principle is the same regardless of the selected use mode. You must:

Declare the WINDEV or WINDEV Mobile application or the WEBDEV site to Facebook.
Use the Facebook identifiers in the WINDEV or WINDEV Mobile application or in the WEBDEV site.
Connect to Facebook from the WINDEV or WINDEV Mobile application or from the WEBDEV site to identify the user.

For an advanced use, several WLanguage functions allow you to communicate with Facebook via its API.

Versions 22 and later

This feature is now available for WEBDEV sites in Linux.

This feature is now available for WEBDEV sites in Windows.

Caution: This feature is not available for the WINDEV applications in Linux.

New in version 22

This feature is now available for WEBDEV sites in Linux.

This feature is now available for WEBDEV sites in Windows.

Caution: This feature is not available for the WINDEV applications in Linux.

This feature is now available for WEBDEV sites in Linux.

This feature is now available for WEBDEV sites in Windows.

Caution: This feature is not available for the WINDEV applications in Linux.

The elements proposed by WLanguage

The following WLanguage elements can be used to communicate with Facebook:

the fbSession type. This type of variable contains all the elements required to implement the Facebook connection and authentication .

several functions:


Versions 21 and later <fbSession variable>.GetUserInformation New in version 21 <fbSession variable>.GetUserInformation <fbSession variable>.GetUserInformation	Retrieves the Facebook information of connected user.
Versions 21 and later <fbSession variable>.Request New in version 21 <fbSession variable>.Request <fbSession variable>.Request	Performs a communication request (HTTP request) to the Facebook Graph API.
Versions 21 and later <fbSession variable>.Status New in version 21 <fbSession variable>.Status <fbSession variable>.Status	Checks the status of a Facebook session.
Versions 21 and later <fbSession variable>.Start New in version 21 <fbSession variable>.Start <fbSession variable>.Start	Used to authenticate and log in to Faceboook.
Versions 21 and later <fbSession variable>.Stop New in version 21 <fbSession variable>.Stop <fbSession variable>.Stop	Stops the Facebook session that was started by <fbSession variable>.Start.

Declaring the application in Facebook

Declaring the WINDEV application in Facebook

A Facebook Windows application must be created beforehand.

Let's see the steps to follow (valid at the time this page was written):

Connect to the "https://developers.facebook.com/" site.
Identify yourself ("Connection" button).
Register yourself if necessary (click the "Register" button and follow the wizard).
In "My Apps", click "Create App".
In the popup that appears, select "Consumer".
Click "Next".
In the popup that is displayed, specify:
- In "App Display Name", enter the name of the application.
- In "App Contact Email", enter a valid email address.
Confirm the app creation (and validate the security check, if necessary).
The page of the application that was just created is displayed.
Then, click the "Settings" menu and choose "Basic".
Note down the "App ID" and "App Secret".
In the "App Domains" area, type "localhost".
At the bottom of the page, click on "Add Platform" and select "Website".
Enter the URL of the site: "http://localhost/".
Then, click "Save Changes".

The Facebook application is ready for testing.

At this point, you can log in to the application with the Facebook user who declared the application (administrator by default).

To use other users for the tests, click the "Roles" menu and add the users with the relevant rights (developers, testers, ...). You also have the ability to create users for test ("Test users" tab) without using the existing Facebook accounts

For a real use of the application, the application must be made public and it must be submitted to Facebook if necessary ("Review apps" options). For more details, see the Facebook documentation.

Declaring the Android application in Facebook

A Facebook Android application must be created beforehand.

Remark: Some elements required to create the Facebook application are supplied in the wizard for generating an Android application ("Facebook" screen). In order for the Facebook step to appear in this wizard, you must use a WLanguage function linked to Facebook.

Let's see the steps to follow (valid at the time this page was written):

Connect to the "https://developers.facebook.com/" site.
Identify yourself ("Connection" button).
Register yourself if necessary (click the "Register" button and follow the wizard).
In "My Apps", click "Create App".
In the popup that appears, select "Consumer".
Click "Next".
In the popup that is displayed, specify:
- In "App Display Name", enter the name of the application.
- In "App Contact Email", enter a valid email address.
Confirm the app creation (and validate the security check, if necessary).
The page of the application that was just created is displayed.
Then, click the "Settings" menu and choose "Basic".
Note down the "App ID" and "App Secret".
At the bottom of the page, click "Add Platform" and select "Android".
Specify:
- the name of the application package ("Name of Google Play package" option). This name is given in the wizard for Android generation ("General information" screen or "Facebook" screen).
- the class name. This name is given in the wizard for Android generation ("Facebook" screen).
- the certificate hash key ("Key Hashes")
  Remark: This information can be found in the "Facebook" screen when generating the Android application.
Click "Save Changes".
Your application is saved.

Declaring the iOS application in Facebook

A Facebook iOS application must be created beforehand.

Let's see the steps to follow (valid at the time this page was written):

Connect to the "https://developers.facebook.com/" site.
Identify yourself ("Connection" button).
Register yourself if necessary (click the "Register" button and follow the wizard).
In "My Apps", click "Create App".
In the popup that appears, select "Consumer".
Click "Next".
In the popup that is displayed, specify:
- In "App Display Name", enter the name of the application.
- In "App Contact Email", enter a valid email address.
Confirm the app creation (and validate the security check, if necessary).
The page of the application that was just created is displayed.
Then, click the "Settings" menu and choose "Basic".
Note down the "App ID" and "App Secret".
At the bottom of the page, click "Add Platform" and select "iOS"
In "Bundle ID", enter the Bundle ID of your application. This name is given in the wizard for iOS generation ("General information" screen).
Click "Save Changes".
Your application is saved.

Versions 22 and later

Declaring the WEBDEV site in Facebook

A Facebook application must be created beforehand.

Let's see the steps to follow (valid at the time this page was written):

Connect to the "https://developers.facebook.com/" site.
Identify yourself ("Connection" button).
Register yourself if necessary (click the "Register" button and follow the wizard).
In "My Apps", click "Create App".
In the popup that appears, select "Consumer".
Click "Next".
In the popup that is displayed, specify:
- In "App Display Name", enter the name of the application.
- In "App Contact Email", enter a valid email address.
Confirm the app creation (and validate the security check, if necessary).
The page of the application that was just created is displayed.
Then, click the "Settings" menu and choose "Basic".
Note down the "App ID" and "App Secret".

At this time, you have the ability to connect to the site with the Facebook user who declared the application (his administrator by default).

For a real use of the application, the application must be made public and it must be submitted to Facebook if necessary ("Review apps" options). For more details, see the Facebook documentation.

New in version 22

Declaring the WEBDEV site in Facebook

A Facebook application must be created beforehand.

Let's see the steps to follow (valid at the time this page was written):

Connect to the "https://developers.facebook.com/" site.
Identify yourself ("Connection" button).
Register yourself if necessary (click the "Register" button and follow the wizard).
In "My Apps", click "Create App".
In the popup that appears, select "Consumer".
Click "Next".
In the popup that is displayed, specify:
- In "App Display Name", enter the name of the application.
- In "App Contact Email", enter a valid email address.
Confirm the app creation (and validate the security check, if necessary).
The page of the application that was just created is displayed.
Then, click the "Settings" menu and choose "Basic".
Note down the "App ID" and "App Secret".

At this time, you have the ability to connect to the site with the Facebook user who declared the application (his administrator by default).

For a real use of the application, the application must be made public and it must be submitted to Facebook if necessary ("Review apps" options). For more details, see the Facebook documentation.

Declaring the WEBDEV site in Facebook

A Facebook application must be created beforehand.

Let's see the steps to follow (valid at the time this page was written):

Connect to the "https://developers.facebook.com/" site.
Identify yourself ("Connection" button).
Register yourself if necessary (click the "Register" button and follow the wizard).
In "My Apps", click "Create App".
In the popup that appears, select "Consumer".
Click "Next".
In the popup that is displayed, specify:
- In "App Display Name", enter the name of the application.
- In "App Contact Email", enter a valid email address.
Confirm the app creation (and validate the security check, if necessary).
The page of the application that was just created is displayed.
Then, click the "Settings" menu and choose "Basic".
Note down the "App ID" and "App Secret".

At this time, you have the ability to connect to the site with the Facebook user who declared the application (his administrator by default).

For a real use of the application, the application must be made public and it must be submitted to Facebook if necessary ("Review apps" options). For more details, see the Facebook documentation.

Implementing the Facebook identification in the WINDEV or WINDEV Mobile application or in the WEBDEV site

Establishing the connection

To connect to Facebook, you must:

Configure a Facebook session (fbSession variable). In the different proprerties of this variable, you must specify:
- the "App ID" and the "App Secret" supplied when registering the application to Facebook.
- the "App ID" supplied when registering the application to Facebook.
Establish the connection with <fbSession variable>.Start.

For example:

MyConnection is fbSession

// Configure the session

MyConnection.AppID = "1664XXXXXXXXXXXX"

MyConnection.AppSecret = "c6e7XXXXXXXXXXXXXXXXX"

// Define the rights:

// - Read the email

// - Manage the pages

MyConnection.Permission = [fbEmail, "manage_pages", "publish_pages", "publish_actions"]

// Connection

MyConnection.Open()

If the connection is permanent, the function presents no connection screen and the session is started directly.

Remarks:

A Web page is displayed in the default browser, allowing the user to type his login and password.
The function is using the Facebook account entered by the user on the phone (if this account is specified).
The "public_profile" permission is always required when starting a Facebook session. If this permission was not specified in the list of permissions for the fbSession variable passed in parameter to FBStartSession, this permission will be automatically requested.
A started Facebook session is a persistent session: it will remain opened:
- until the application is closed.
- until the call to <fbSession variable>.Stop.

Using the Facebook API

<fbSession variable>.Request is used to perform requests toward Facebook.

The following example is used to list the pages and groups managed by the current user:

MyConnection is fbSession
...
sURL is ANSI string = GRAPHAPI + "me/accounts?local=en_US"
sJSON is ANSI string
vJSON is Variant

// Retrieves the pages managed by the user
sJSON = MyConnection.Request(sURL)
vJSON = JSONToVariant(sJSON)

The function returns the JSON response of Facebook.

Then, all you have to do is read and access the members documented in the Facebook API: "https://developers.facebook.com/docs/graph-api/reference".

FOR i = 1 _TO_ vJSON.data..Occurrence
LIST_PAGES.Add(gLink(i) + vJSON.data[i].Name)
END