fbSession (Type of variable)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Communication / Facebook functions

Properties specific to fbSession variables
Closing the session
WLanguage functions that use a variable of type fbSession

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

fbSession (Type of variable)

In french: fbSession

The fbSession type is used to describe a connection to the Facebook service and to manage the authentication to this service. The characteristics of this connection can be defined and changed using different WLanguage properties.

Important: Before using this WLanguage type, the application must be declared to Facebook. For more details, see Using Facebook authentication.

Remarks:

For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
This type of variable is available in Linux only for WEBDEV sites.

Caution: This feature is available up to Android 11. Starting with Android 12, this function causes a fatal error.
It is recommended to:

test the Android version used with SysAndroidVersion.
use AuthIdentify to manage Facebook authentication.

Example

MySession is fbSession
MySession.AppID = "1702546803104741"
MySession.AppSecret = "badf00ddeadbeefbadc0deoff1ce8ecd"
MySession.Permission = [fbInfoProfile, fbEmail]
IF FBStartSession(MySession) THEN
Info("Connected")
END

Remarks

Properties specific to fbSession variables

The following properties can be used to handle a Facebook session:

Property name	Type used	Effect

AppID	Character string	Identifier of the application supplied when declaring the Facebook application.
AppSecret	Character string	Secret code of the application supplied when declaring the Facebook application. This property is ignored.
Email	Character string	Email of the end user (may be used to fill the connection dialog beforehand). This property is ignored.
PageID	Character string	Identifier of the Facebook page to open. If this parameter is empty, the session is started on a user and not on a page. This property is not available.
Permission	Array	Rights required during the Facebook connection. The rights (or permissions) to supply are defined by Facebook. The list of available rights can be consulted on the page: https://developers.facebook.com/docs/facebook-login/permissions/v2.3. For some rights (the most common ones), you have the ability to use the following constants: fbEmail: "email" permission: Used to access the first email address of a person. fbInfoFriends: "user_friends" permission: Used to access the liste of friends for your application. fbInfoProfile: "public_profile" permission: Used to access the public profile of a person. 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 as parameter to FBStartSession, this permission will be automatically requested.

Closing the session

A started Facebook session is a persistent session: it will remain open:

until the application is closed.
until FBStopSession is called.

WLanguage functions that use a variable of type fbSession

Standard functions:


FBGetUserInformation	Retrieves the Facebook information of connected user.
FBRequest	Performs a communication request (HTTP request) to the Facebook Graph API.
FBSessionStatus	Checks the status of a Facebook session.
FBStartSession	Used to authenticate and log in to Faceboook.
FBStopSession	Stops the Facebook session that was started by FBStartSession.

Functions that use prefix syntax:


<fbSession variable>.GetUserInformation	Gets the Facebook information of the connected user.
<fbSession variable>.Request	Sends an HTTP request to the Facebook Graph API.
<fbSession variable>.Start	Used to authenticate and log in to Faceboook.
<fbSession variable>.Status	Checks the status of a Facebook session.
<fbSession variable>.Stop	Stops the Facebook session that was started by FBStartSession.