Card Stories - Beta1.1 Specifications

= Summary =

The beta1.1 revision seeks to address the latest changes made by Facebook to the way it handles feed stories. Given the nature of Card Stories, it now makes more sense to use the Share function to share individual games rather than publishing stories through the API, and we add comments for extra interaction vetween players and improved visibility from the feed.

= Replacing Wall publication with Facebook Share =

Instead of using the application API to publish to the user's wall, we would switch to Facebook Share.

http://www.facebook.com/share/

It would thus involve adding a step for the author:

After "Choose a sentence" / before "Invite friends"



 * John Doe is the author name
 * "My great sentence" is the sentence the author has chosen
 * The link sends to cardstories.farsides.com (the page that contains the meta-data used by the Facebook sharer) and redirects players to apps.facebook.com when they click on it to ensure they play from within Facebook (they join the game).

After "Publish the results" / before displaying the results

 * The image displayed is the card that the author had selected
 * The link sends to cardstories.farsides.com (the page that contains the meta-data used by the Facebook sharer), but doesn't redirect to apps.facebook.com - it allows everyone to see the results of the game without adding the application. Clicking on "Create your own game" sends to apps.facebook.com though - requiring the user to add the application and then letting him create a new game.

Note: The Facebook share screen is shown in an Iframe, not in a browser pop-up.

= Adding comments in each game =

On each of the screen showing a game step (ie all screens exccept the welcome screen and the list of games), add the Facebook comments below the existing screen. It should use one Unique id for each different game.

http://developers.facebook.com/docs/reference/plugins/comments

= Requirements =

See Requirements and deliverables for patch submission