New Design Feed Wall
From Facebook Developer Wiki
Contents |
[edit] Combined Feed and Wall
The Mini-Feed and Wall are combined into a single flow to encourage the idea that the profile is a place for all of a user's content and activity. The profile is about a user, not just content created by the user. Users can filter Wall posts from Feed stories or filter Feed stories from Wall posts. Users can post content to their own or friends' Walls, using the Publisher to post anything from text to music to other rich content.
[edit] Multiple Sizes for Feed Stories
In order to place greater emphasis on Feed, Feed stories now come in two sizes -- one line and short. Users can create their own content, and then publish it directly into their own Feeds. When users publish something into their own Feed, this gets picked up in one or more of their friends' News Feeds as well. These different sizes will enable applications to have significantly more opportunities to create rich content – such as sharing a song and being able to play it from within the Feed.
One line stories get their point across in a single line. Short stories are formatted with templates and allow a small amount of text with media – for example up to six images or a SWF file.
The one line and short presentations will look very much like they always have.
Instead of posting the one line and short story templates with every single publish action (as used to be done with feed.publishTemplatizedAction), you now register a template bundle ahead of time. Facebook returns a template bundle ID, which you reference every time the application publishes a story of that type. You must register templates of the appropriate size in order to publish stories of that size. Each template bundle should include a template for each possible story size, if possible, to give your users the most control over their Feeds. You register templates using the Feed Template Console or the feed.registerTemplateBundle API method.
For short stories, you can use Feed forms or the Publisher.
Note: Use feed.publishUserAction to publish Feed stories.
[edit] Feed Story Behavior
Applications can automatically publish one line stories -- without user approval -- on the owner's Wall and the owner's friends' News Feed. Applications can publish short stories with user approval on the owner's Wall as well as the owner's friends' Wall and News Feed. Users can choose to publish on up to 5 friends' Walls, at a time, and applications can pre-fill one friend automatically.
Applications can automatically publish short stories without user approval in the owner's Mini-Feed under certain conditions.
[edit] One Line Stories
One line stories are rendered as single line stories with a width of 500 pixels. They always require templates. The only HTML and FBML tags Facebook supports for one line story templates are <a>, <br />, <small>, <fb:name>, <fb:pronoun>, and <fb:if-multiple-actors>.
For example:
- {*actor*} went to see {*movie*} and <fb:if-multiple-actors>they all<fb:else><fb:pronoun uid="actor" useyou="false"/></fb:else></fb:if-multiple-actors> {*past-tense-verb*} it.
- {*actor*} challenged {*target*} to a game of chess.
- {*actor*} bought {*gift*} for {*target*}.
Every story published requires a one line story version to be included.
[edit] Clustering One Line Stories
When an application generates a series of one line stories for a user, Facebook groups them together in a cluster and displays just one story on the Wall, hiding the rest. The story header will include a clearly identifiable link to display the rest of the stories inline. Stories chosen for clustering are stories that are published within the same 24 hour period and can come from different template bundles.
Facebook will not cluster short stories.
[edit] Short Stories
Short stories also require templates. The only HTML and FBML tags Facebook supports for short story templates are fb:name, fb:pronoun, fb:if-multiple-actors, <a>, <b>, and <i>. Short stories will be rendered using one of a number (approximately 5-10) of Facebook-managed layouts. Developers can (note: this is still TBD -- there is one default layout currently) specify which layout they prefer, or Facebook can decide which layout to use based on the supplied content.
Short stories can contain an image that is 100, 110, or 130 pixels wide and up to 100 pixels tall. It can include several sentences of text. [Can anyone provide more detail on "several sentences"? Is there a character limit? Does it need to fit within a box of a certain size when the text is rendered?]
Short stories are large enough that you can specify both a title template and a body template. You do not have to include a short story when you publish a story.
[edit] Feed Story Template API Calls
For more information about the new API methods for creating Feed story templates, see Registering Templates: New API Methods.
[edit] Related Links
- Old Feed forms
- Creating Feed Stories on the developers blog
