facebook

Version: stable

FUNCTION
login_with_permissions()
logout()
access_token()
permissions()
post_event()
enable_event_usage()
disable_event_usage()
show_dialog()
get_version()
deferred_deep_link()

CONSTANT
STATE_OPEN
STATE_CLOSED_LOGIN_FAILED
GAMEREQUEST_ACTIONTYPE_NONE
GAMEREQUEST_ACTIONTYPE_SEND
GAMEREQUEST_ACTIONTYPE_ASKFOR
GAMEREQUEST_ACTIONTYPE_TURN
GAMEREQUEST_FILTER_NONE
GAMEREQUEST_FILTER_APPUSERS
GAMEREQUEST_FILTER_APPNONUSERS
EVENT_ACHIEVED_LEVEL
EVENT_ADDED_PAYMENT_INFO
EVENT_ADDED_TO_CART
EVENT_ADDED_TO_WISHLIST
EVENT_COMPLETED_REGISTRATION
EVENT_COMPLETED_TUTORIAL
EVENT_INITIATED_CHECKOUT
EVENT_PURCHASED
EVENT_RATED
EVENT_SEARCHED
EVENT_SPENT_CREDITS
EVENT_TIME_BETWEEN_SESSIONS
EVENT_UNLOCKED_ACHIEVEMENT
EVENT_VIEWED_CONTENT
PARAM_CONTENT_ID
PARAM_CONTENT_TYPE
PARAM_CURRENCY
PARAM_DESCRIPTION
PARAM_LEVEL
PARAM_MAX_RATING_VALUE
PARAM_NUM_ITEMS
PARAM_PAYMENT_INFO_AVAILABLE
PARAM_REGISTRATION_METHOD
PARAM_SEARCH_STRING
PARAM_SOURCE_APPLICATION
PARAM_SUCCESS
AUDIENCE_NONE
AUDIENCE_ONLYME
AUDIENCE_FRIENDS
AUDIENCE_EVERYONE

Functions

login_with_permissions()

login_with_permissions(permissions,audience,callback)

Login to Facebook and request a set of publish permissions. The user is prompted to authorize the application using the login dialog of the specific platform. Even if the user is already logged in to Facebook this function can still be used to request additional publish permissions. A comprehensive list of permissions can be found in the [Facebook permissions](https://developers.facebook.com/docs/facebook-login/permissions) documentation, as well as in their [guide to best practices for login management](https://developers.facebook.com/docs/facebook-login/best-practices).

PARAMETERS

`permissions`	table with the requested publish permission strings.
`audience`	The audience that should be able to see the publications. Can be any of - `facebook.AUDIENCE_NONE` - `facebook.AUDIENCE_ONLYME` - `facebook.AUDIENCE_FRIENDS` - `facebook.AUDIENCE_EVERYONE`
`callback`	Callback function that is executed when the permission request dialog is closed.

EXAMPLES

local permissions = {"publish_actions"}
facebook.login_with_permissions(permissions, facebook.AUDIENCE_FRIENDS, function(self, data)
    if (data.status == facebook.STATE_OPEN and data.error == nil) then
        print("Successfully logged into Facebook")
        pprint(facebook.permissions())
    else
        print("Failed to get permissions (" .. data.status .. ")")
        pprint(data)
    end
end)

local permissions = {"public_profile", "email", "user_friends"}
facebook.login_with_read_permissions(permissions, facebook.AUDIENCE_EVERYONE, function(self, data)
    if (data.status == facebook.STATE_OPEN and data.error == nil) then
        print("Successfully logged into Facebook")
        pprint(facebook.permissions())
    else
        print("Failed to get permissions (" .. data.status .. ")")
        pprint(data)
    end
end)

logout()

logout()

Logout from Facebook

PARAMETERS

access_token()

access_token()

Get the current Facebook access token. This function returns the currently stored access token after a previous successful login. If it returns nil no access token exists and you need to perform a login to get the wanted permissions.

PARAMETERS

RETURNS

string the access token or nil if the user is not logged in

EXAMPLES

Get the current access token, then use it to perform a graph API request.

local function get_name_callback(self, id, response)
    -- do something with the response
end
function init(self)
    -- assuming we are already logged in.
    local token = facebook.access_token()
    if token then
        local url = "https://graph.facebook.com/me/?access_token=".. token
        http.request(url, "GET", get_name_callback)
    end
end

permissions()

permissions()

Get the currently granted permissions. This function returns a table with all the currently granted permission strings.

PARAMETERS

RETURNS

table The permissions

EXAMPLES

Check the currently granted permissions for a particular permission

for _,permission in ipairs(facebook.permissions()) do
    if permission == "user_likes" then
        -- "user_likes" granted...
        break
    end
end

post_event()

post_event(event,value,params)

Post an event to Facebook Analytics This function will post an event to Facebook Analytics where it can be used in the Facebook Insights system.

PARAMETERS

`event`	An event can either be one of the predefined constants below or a text string which can be used to define a custom event that is registered with Facebook Analytics. - `facebook.EVENT_ACHIEVED_LEVEL` - `facebook.EVENT_ADDED_PAYMENT_INFO` - `facebook.EVENT_ADDED_TO_CART` - `facebook.EVENT_ADDED_TO_WISHLIST` - `facebook.EVENT_COMPLETED_REGISTRATION` - `facebook.EVENT_COMPLETED_TUTORIAL` - `facebook.EVENT_INITIATED_CHECKOUT` - `facebook.EVENT_PURCHASED` - `facebook.EVENT_RATED` - `facebook.EVENT_SEARCHED` - `facebook.EVENT_SPENT_CREDITS` - `facebook.EVENT_TIME_BETWEEN_SESSIONS` - `facebook.EVENT_UNLOCKED_ACHIEVEMENT` - `facebook.EVENT_VIEWED_CONTENT`
`value`	A numeric value for the event. This should represent the value of the event, such as the level achieved, price for an item or number of orcs killed.
`params`	Optional table with parameters and their values. A key in the table can either be one of the predefined constants below or a text which can be used to define a custom parameter. - `facebook.PARAM_CONTENT_ID` - `facebook.PARAM_CONTENT_TYPE` - `facebook.PARAM_CURRENCY` - `facebook.PARAM_DESCRIPTION` - `facebook.PARAM_LEVEL` - `facebook.PARAM_MAX_RATING_VALUE` - `facebook.PARAM_NUM_ITEMS` - `facebook.PARAM_PAYMENT_INFO_AVAILABLE` - `facebook.PARAM_REGISTRATION_METHOD` - `facebook.PARAM_SEARCH_STRING` - `facebook.PARAM_SOURCE_APPLICATION` - `facebook.PARAM_SUCCESS`

EXAMPLES

Post a spent credits event to Facebook Analytics

params = {[facebook.PARAM_LEVEL] = 30, [facebook.PARAM_NUM_ITEMS] = 2}
facebook.post_event(facebook.EVENT_SPENT_CREDITS, 25, params)

enable_event_usage()

enable_event_usage()

Enable event usage with Facebook Analytics This function will enable event usage for Facebook Analytics which means that Facebook will be able to use event data for ad-tracking. [icon:attention] Event usage cannot be controlled and is always enabled for the Facebook Canvas platform, therefore this function has no effect on Facebook Canvas.

PARAMETERS

disable_event_usage()

disable_event_usage()

Disable event usage with Facebook Analytics This function will disable event usage for Facebook Analytics which means that Facebook won't be able to use event data for ad-tracking. Events will still be sent to Facebook for insights. [icon:attention] Event usage cannot be controlled and is always enabled for the Facebook Canvas platform, therefore this function has no effect on Facebook Canvas.

PARAMETERS

show_dialog()

show_dialog(dialog,param,callback)

Show facebook web dialog Display a Facebook web dialog of the type specified in the `dialog` parameter. The `param` table should be set up according to the requirements of each dialog type. Note that some parameters are mandatory. Below is the list of available dialogs and where to find Facebook's developer documentation on parameters and response data. `"apprequests"` Shows a Game Request dialog. Game Requests allows players to invite their friends to play a game. Available parameters - [type:string] `title` - [type:string] `message` - [type:number] `action_type` - [type:number] `filters` - [type:string] `data` - [type:string] `object_id` - [type:table] `suggestions` - [type:table] `recipients` - [type:string] `to` On success, the "result" table parameter passed to the callback function will include the following fields - [type:string] `request_id` - [type:table] `to` [Details for each parameter](https://developers.facebook.com/docs/games/services/gamerequests/v2.6#dialogparameters) `"feed"` The Feed Dialog allows people to publish individual stories to their timeline. - [type:string] `caption` - [type:string] `description` - [type:string] `picture` - [type:string] `link` - [type:table] `people_ids` - [type:string] `place_id` - [type:string] `ref` On success, the "result" table parameter passed to the callback function will include the following fields - [type:string] `post_id` [Details for each parameter](https://developers.facebook.com/docs/sharing/reference/feed-dialog/v2.6#params) `"appinvite"` The App Invite dialog is available only on iOS and Android. Note that the `url` parameter corresponds to the appLinkURL (iOS) and setAppLinkUrl (Android) properties. - [type:string] `url` - [type:string] `preview_image` [Details for each parameter](https://developers.facebook.com/docs/reference/ios/current/class/FBSDKAppInviteContent)

PARAMETERS

`dialog`	Dialog to show - `"apprequests"` - `"feed"` - `"appinvite"`
`param`	table with dialog parameters
`callback`	Callback function that is called when the dialog is closed.

EXAMPLES

Show a dialog allowing the user to share a post to their timeline

local function fb_share(self, result, error)
    if error then
        -- something did not go right...
    else
        -- do something sensible
    end
end
function init(self)
    -- assuming we have logged in with publish permissions
    local param = { link = "http://www.mygame.com",picture="http://www.mygame.com/image.jpg" }
    facebook.show_dialog("feed", param, fb_share)
end

get_version()

get_version()

Get the version of the Facebook SDK used by the extension.

PARAMETERS

RETURNS

string The Facebook SDK version

deferred_deep_link()

deferred_deep_link(callback)

Allows receiving deferred deep link URL and parameters. [More info about Referred Deep Links](https://developers.facebook.com/docs/app-ads/deep-linking/)

PARAMETERS

callback Callback function that is called when information is ready.

EXAMPLES

Show a dialog allowing the user to share a post to their timeline

local function deferred_deep_link_callback(self, result, error)
  if error then
    print(error.error)
  else
    pprint(result)
  end
end

function init(self)
  facebook.deferred_deep_link(deferred_deep_link_callback)
end

facebook

Functions

Constants