MultiFeedStory form

From Facebook Developer Wiki

Jump to: navigation, search

Contents

Description

Facebook has discontinued support for this Feed form method.

Please use FB.Connect.streamPublish and Facebook.streamPublish instead. For more information, please read the Developer Roadmap.


The multi-Feed story form is special FBML element that allows your application to publish Feed stories directly to the Wall of one of a user's friends.

You can publish directly to a user's own Wall with feedStory form.

To use the Feed form, create a standard HTML <form> with this special fbtype="multiFeedStory" attribute, and include a fb:friend-selector to allow the user to choose to which friend to publish the story.

To preselect which user the Feed story should publish to, add an attribute called fbuid to the input submit element, where the value is the user ID of the intended target of the story. Note that the target user specified here must be friends with the current user. On the label for the submit button, include "%n" which will be substituted with the first name of the target user (or "%N" for the full name).

You use a standard form input submit button (see the example below), and we intercept the click. Note: You cannot submit the form via FBJS ( as in form.submit() ) as this call will not be intercepted.

You need to provide an action callback. On form submission, we ping your callback and wait for a response from you containing the Feed story and the follow-up URL to where the user gets redirected after publishing or canceling the form. For example, the story is specified by $feed and the follow-up URL is specified by next in the JSON example below. Or you could pass next_fbjs instead and execute JavaScript after publishing or canceling.

Important! The template bundle must contain a {*target*} token, in order to ensure that the target of the story is mentioned in the Feed story. For more information about configuring the template data, see Template Data.

The user sending the form specifies the target directly, so you shouldn't include the target in the response from the callback.

Read more about Feed forms.

Attributes

RequiredNameTypeDescription
required fbtype string Must be "multiFeedStory."
action string The callback to a multiFeedStory feed handler.

Response Content

Facebook expects the following arguments from the response endpoint.

RequiredNameTypeDescription
required feed array The Feed template bundle. The template bundle must contain a {*target*} token. See Template Data for details.
next string The page to load after the Feed dialog appears.
optional next_fbjs string JavaScript to run after the form is done. (You can use this parameter instead of the next parameter.)

Examples

Utensil Poke

<form fbtype="multiFeedStory" action="http://my.app/feed_handler.php" > <select size=3 name="utensil"> <option value="spoon" selected="true"> spoon </option> <option value="fork"> fork </option> <option value="knife"> knife </option> </select> <fb:friend-selector> </fb:friend-selector> <input type="submit" label="Utensil Poke" /> </form>


Poke Handler (JSON)

{"content": {"feed": {"template_id":55555555, "template_data": {"utensil":"utensil"} } }, "method":"multiFeedStory" }


Preselecting the Target User

<input type="submit" fbuid="1160" id="mood" label="Send Smiley to %n">
Retrieved from "http://wiki.developers.facebook.com/index.php/MultiFeedStory_form"