[Facebook for Websites] - Update 1-29-2016

Joannesalfa

I'm still tweaking the post to share story. But it will eventually be PromptToShareLink, PromptToShareApp, PromptWallPost all in the same action. It is now but I'm going to make it so if you leave a line blank then it will not be included in the final feed. Currently it is.

Also if you notice the get high score action. It has a new variable for appnamespace. This can be any appnamespace, not just yours. So the myid from apps.facebook.com/myid. This could be great to use if you want to try and get users from another game to come over. IE Have a "Limited time only, Farmville players get 10 free app credits for making the switch to coolgame". You just ping new users with that appnamespace and see if there is a score. Great marketing technique.

Current version contains a <BREAKING CHANGE> update to the Post Story action. Before you download the new version, remove all reference in your capx of the Post Story action and note their placement so you may place the new action in its place. New version allows for inclusion of mp3 files and a reference code for Facebook insights. Also the StoryFeedPostID now accurately records either the post id on success or the error message on failure. See the docs for more details on this action.

Facebook Developers Feed Use and Explanations.

Current Version: 0.22

Facebook Complete 0.22

Version 0.21 (old for breaking changes purposes)

Facebook Complete

Currently it has:

Actions:

Update Status - Update the user login status

Login Dialog - Log User Into your app

Update Basic User Info - Fetch available basic user data

Facebook Logout - Log User out of Facebook

Delete App - Delete your application for the user

Post Story - Post Story to Users Feed

Publish score - Publish a score for this user

Request user top score - Request user top score

Conditions:

On App User Logged In - triggers when user status changes to installed

On App Not Installed - triggers when user status changes to not installed

On Facebook Logged Out - triggers when user status changes to a user who has not logged into Facebook

On Facebook Info Populated - Triggered When user Facebook Information Expressions are populated

Is user logged in - True if currently being viewed inside Facebook by a logged in user

Expressions:

UserID - Return the UserID of the Facebook player.

UserAccessTokenExpiresIn - Return the seconds left until the Access token expires.

UserLoginStatus - Return the login status of the Facebook player

UserAccessToken - Return the current User Access Token

UserSignedRequest - Return the current Signed Request

UserFullName - Return the users full name

UserFirstName - Return the users first name

UserLastName - Return the users last name

ThirdPartyID - Return the users Third Party ID

UserGender - Return the users gender

UserLocale - Return the users locale

UserLink - Return the users Facebook link

UserUserName - Return the users Facebook Username

StoryFeedPostID - Return the PostID for the last story feed posting or error if an error occured

UserPicture - Return the users true Facebook Picture Url

ScoreError - Return the status of the last Score Posting

Score - Get the score, when in a 'on user top score' or 'on hi-score' event

New Version contains a new way to engage users on their feed(wall)

Prompt To Share Story - Action

On Story Success - Condition

On Story Failed - Condition

See all features and get the latest version on page 1.

Go To Page 1 For More Info

Version 0.24 is here and with it brings the first Javascript Facebook Credits payment system. The Javascript payments only work on canvas apps(apps.facebook.com) so for mobile and direct website games you will need to use the browser redirection version(see tutorials. You will need to setup your callback.php file and also setup payments in your app settings still.

Payments conditions:

On Payment Success

On Payment Failure

Payments actions:

Invoke Pay Dialog

Payments expressions:

Payment Order Status

Payment Order ID

Payment Error Code

Payment Error Message

Version 0.25 is here and with it brings the ability to find all a users friends game scores information. Also you can now access Facebooks built in age ranges to restrict access for users based on age appropriateness. Don't forget to check out the payments update which came out in version 0.24

Current Version: 0.25

Version 0.25

Version 0.21 (old for breaking changes purposes) If you are updating from version o.21, make sure to remove any story posting references first. Or you will need to revert back to this version to do so before updating.

Facebook Complete

<font color="red"><font size="6">CURRENT FEATURES</font></font>

<font size="5">ACTIONS:</font>

Update Status - Update the user login status

Login Dialog - Log User Into your app

Update Basic User Info - Fetch available basic user data

Facebook Logout - Log User out of Facebook

Delete App - Delete your application for the user

Post Story - Post Story to Users Feed

Publish score - Publish a score for this user

Request user top score - Request user top score

Prompt To Share Story - Prompt to Share Story to Users Feed

Invoke Pay Dialog - Prompt User to Purchase an Item with Facebook Credits.

<font color="green">Fetch Game Friend List</font> - Fetch a list of all users friends that play this app.

<font color="green">Fetch game friend info by array ranking number</font> - Fetch game friend info by array ranking number.

<font size="5">CONDITIONS:</font>

On App User Logged In - triggers when user status changes to installed

On App Not Installed - triggers when user status changes to not installed

On Facebook Logged Out - triggers when user status changes to a user who has not logged into Facebook

On Facebook Info Populated - Triggered When user Facebook Information Expressions are populated

Is user logged in - True if currently being viewed inside Facebook by a logged in user

On Story Success - Triggered when the last story action completes successfully.

On Story Failed - Triggered when the last story action completes unsuccessfully

On Payment Success - Triggered When user successfully completes a credits transaction.

On Payment Failure - Triggered When user unsuccessfully completes a credits transaction.

<font color="green">On Game Friends Loaded</font> - Triggered once all game friends have been loaded.

<font size="5">EXPRESSIONS:</font>

UserID - Return the UserID of the Facebook player.

UserAccessTokenExpiresIn - Return the seconds left until the Access token expires.

UserLoginStatus - Return the login status of the Facebook player

UserAccessToken - Return the current User Access Token

UserSignedRequest - Return the current Signed Request

UserFullName - Return the users full name

UserFirstName - Return the users first name

UserLastName - Return the users last name

ThirdPartyID - Return the users Third Party ID

UserGender - Return the users gender

UserLocale - Return the users locale

UserLink - Return the users Facebook link

UserUserName - Return the users Facebook Username

StoryFeedPostID - Return the PostID for the last story feed posting or error if an error occured

UserPicture - Return the users true Facebook Picture Url

ScoreError - Return the status of the last Score Posting

Score - Get the score, when in a 'on user top score' or 'on hi-score' event

Payment Order Status - A Facebook order status IE.. 'settled'.

Payment Order ID - A Facebook order id.

Payment Error Code - An error code identifying the error.

Payment Error Message - An error message describing the error.

<font color="green">Current friend score</font> - Current selected game friends score.

<font color="green">Current friend name</font> - Current selected game friends name.

<font color="green">Current friend ID</font> - Current selected game friends ID.

<font color="green">Current friend rank</font> - Current selected game friends rank.

<font color="green">Game Friend Array length</font> - Current selected game friends array length.

<font color="green">Minimum Age Range</font> - The user's minimum age range.

<font color="green">Maximum Age Range</font> - The user's maximum age range.

<img src="smileys/smiley32.gif" border="0" align="middle" />

Version 0.27 is here and with it brings the ability to login using javascript. Use this when a user is logged into Facebook but hasn't authorized your app. Use the redirect login when user is not logged into Facebook. This is as per Facebook recommendations. Don't forget to check out the payments update which came out in version 0.24

Current Version: 0.27

Version o.27

Example Capx

Capx

Example in action

Sample Here

Version 0.21 (old for breaking changes purposes) If you are updating from version o.21, make sure to remove any story posting references first. Or you will need to revert back to this version to do so before updating.

Facebook Complete

<font color="red"><font size="6">CURRENT FEATURES</font></font>

<font size="5">ACTIONS:</font>

Update Status - Update the user login status

Login Dialog - Log User Into your app

Update Basic User Info - Fetch available basic user data

Facebook Logout - Log User out of Facebook

Delete App - Delete your application for the user

Post Story - Post Story to Users Feed

Publish score - Publish a score for this user

Request user top score - Request user top score

Prompt To Share Story - Prompt to Share Story to Users Feed

Invoke Pay Dialog - Prompt User to Purchase an Item with Facebook Credits.

Fetch Game Friend List - Fetch a list of all users friends that play this app.

Fetch game friend info by array ranking number - Fetch game friend info by array ranking number.

<font color="green">Login Popup</font> - Log into your app using javascript(non redirect)

<font size="5">CONDITIONS:</font>

On App User Logged In - triggers when user status changes to installed

On App Not Installed - triggers when user status changes to not installed

On Facebook Logged Out - triggers when user status changes to a user who has not logged into Facebook

On Facebook Info Populated - Triggered When user Facebook Information Expressions are populated

Is user logged in - True if currently being viewed inside Facebook by a logged in user

On Story Success - Triggered when the last story action completes successfully.

On Story Failed - Triggered when the last story action completes unsuccessfully

On Payment Success - Triggered When user successfully completes a credits transaction.

On Payment Failure - Triggered When user unsuccessfully completes a credits transaction.

<font color="green">On Game Friends Loaded</font> - Triggered once all game friends have been loaded.

<font size="5">EXPRESSIONS:</font>

UserID - Return the UserID of the Facebook player.

UserAccessTokenExpiresIn - Return the seconds left until the Access token expires.

UserLoginStatus - Return the login status of the Facebook player

UserAccessToken - Return the current User Access Token

UserSignedRequest - Return the current Signed Request

UserFullName - Return the users full name

UserFirstName - Return the users first name

UserLastName - Return the users last name

ThirdPartyID - Return the users Third Party ID

UserGender - Return the users gender

UserLocale - Return the users locale

UserLink - Return the users Facebook link

UserUserName - Return the users Facebook Username

StoryFeedPostID - Return the PostID for the last story feed posting or error if an error occured

UserPicture - Return the users true Facebook Picture Url

ScoreError - Return the status of the last Score Posting

Score - Get the score, when in a 'on user top score' or 'on hi-score' event

Payment Order Status - A Facebook order status IE.. 'settled'.

Payment Order ID - A Facebook order id.

Payment Error Code - An error code identifying the error.

Payment Error Message - An error message describing the error.

<font color="green">Current friend score</font> - Current selected game friends score.

<font color="green">Current friend name</font> - Current selected game friends name.

<font color="green">Current friend ID</font> - Current selected game friends ID.

<font color="green">Current friend rank</font> - Current selected game friends rank.

<font color="green">Game Friend Array length</font> - Current selected game friends array length.

<font color="green">Minimum Age Range</font> - The user's minimum age range.

<font color="green">Maximum Age Range</font> - The user's maximum age range.

Looks very useful! Is there any potential of being to access friends who are not already playing the game? Does this play nice with Cocoon?

— yes the ability is there if you make an Ajax call. I can add it to a future version but updates will be a bit slower now that I'm tackling a bigger project that doesn't utilize Facebook.

Hey, i realy need something that isn't here yet

to post a snapshot from the app to facebook as a picture...

could you help me with that?

taltal I'll look into that over the next couple of days.

—

thanks man!

— - did you find something about it?

taltal,

Completely spaced out. I did learn that its much easier done through php but its possible through javascript by passing the picture data as a string. I'll look to adding it at some point today.

Version 0.28 is here and with it brings the ability to post a photo to the users profile using a picture url. In order to use a snapshot you will need to upload a photo to your server first or utilize the old rest api through an ajax plugin call. Don't forget to check out the payments update which came out in version 0.24

Current Version: 0.28

Version o.28

Example Capx

Capx

Example in action

Sample Here

Version 0.21 (old for breaking changes purposes) If you are updating from version o.21, make sure to remove any story posting references first. Or you will need to revert back to this version to do so before updating.

Facebook Complete

<font color="red"><font size="6">CURRENT FEATURES</font></font>

<font size="5">ACTIONS:</font>

Update Status - Update the user login status

Login Dialog - Log User Into your app

Update Basic User Info - Fetch available basic user data

Facebook Logout - Log User out of Facebook

Delete App - Delete your application for the user

Post Story - Post Story to Users Feed

Publish score - Publish a score for this user

Request user top score - Request user top score

Prompt To Share Story - Prompt to Share Story to Users Feed

Invoke Pay Dialog - Prompt User to Purchase an Item with Facebook Credits.

Fetch Game Friend List - Fetch a list of all users friends that play this app.

Fetch game friend info by array ranking number - Fetch game friend info by array ranking number.

Login Popup - Log into your app using javascript(non redirect)

<font color="green">Upload Photo by URL</font> - Upload a photo to the users profile.

<font size="5">CONDITIONS:</font>

On App User Logged In - triggers when user status changes to installed

On App Not Installed - triggers when user status changes to not installed

On Facebook Logged Out - triggers when user status changes to a user who has not logged into Facebook

On Facebook Info Populated - Triggered When user Facebook Information Expressions are populated

Is user logged in - True if currently being viewed inside Facebook by a logged in user

On Story Success - Triggered when the last story action completes successfully.

On Story Failed - Triggered when the last story action completes unsuccessfully

On Payment Success - Triggered When user successfully completes a credits transaction.

On Payment Failure - Triggered When user unsuccessfully completes a credits transaction.

On Game Friends Loaded - Triggered once all game friends have been loaded.

<font color="green">On Photo Upload Fail</font> - Triggered once a photo failed to upload.

<font color="green">On Photo Upload Success</font> - Triggered once a photo has been uploaded.

<font size="5">EXPRESSIONS:</font>

UserID - Return the UserID of the Facebook player.

UserAccessTokenExpiresIn - Return the seconds left until the Access token expires.

UserLoginStatus - Return the login status of the Facebook player

UserAccessToken - Return the current User Access Token

UserSignedRequest - Return the current Signed Request

UserFullName - Return the users full name

UserFirstName - Return the users first name

UserLastName - Return the users last name

ThirdPartyID - Return the users Third Party ID

UserGender - Return the users gender

UserLocale - Return the users locale

UserLink - Return the users Facebook link

UserUserName - Return the users Facebook Username

StoryFeedPostID - Return the PostID for the last story feed posting or error if an error occured

UserPicture - Return the users true Facebook Picture Url

ScoreError - Return the status of the last Score Posting

Score - Get the score, when in a 'on user top score' or 'on hi-score' event

Payment Order Status - A Facebook order status IE.. 'settled'.

Payment Order ID - A Facebook order id.

Payment Error Code - An error code identifying the error.

Payment Error Message - An error message describing the error.

Current friend score - Current selected game friends score.

Current friend name - Current selected game friends name.

Current friend ID - Current selected game friends ID.

Current friend rank - Current selected game friends rank.

Game Friend Array length - Current selected game friends array length.

Minimum Age Range - The user's minimum age range.

Maximum Age Range - The user's maximum age range.