Fb:board

From Facebook Developer Wiki

Jump to: navigation, search

Contents

Description

This tag is currently in beta. It is available for all applications. Please post any bugs in bugzilla.

Displays a discussion board with a unique identifier. Facebook handles pagination, topic display, posting and storage.

Fb:board is a Facebook discussion board for developers to drop onto canvas pages easily. It is not designed to be fully extensible or for the developer to get the data in the posts. Using the tag implies a board exists that can be posted on identified by the passed xid. Please note the following:

  • Every pageload for posting, see all page, and so forth refetches the configuration from the callbackurl supplied. The callbackurl defaults to the page where it was originally found, so the tag should work without any extra coding. However, you can point a callbackurl to a special page that can be more efficient, if you so desire.
  • An fb_sig_xid parameter is passed to these pages. Facebook looks for this xid when using this board. You can use it to short-circuit your application logic and only output the fb:board tag with the proper parameters.
  • When an action occurs, the page is also passed an fb_sig_xid_action parameter. If you return true for the action requested in the fb:board tag, you can assume the action was performed. Possible values are: new_topic, new_post, edit_topic, edit_post, delete_topic, delete_post, mark_irrelevant, mark_relevant. These actions correspond respectively to these parameters: cancreatetopic, canpost, cancreatetopic, canpost, candelete, candelete, canmark, canmark.
  • The refetch is in the form of a POST to the URL supplied in the callbackurl, mimicking a canvas page.
  • Note that some attributes may be ignored for the user acting on his or her own post.

Attributes

RequiredNameTypeDescription
required xid string The unique identifier for this board. The board name can contain alphanumeric characters (Aa-Zz, 0-9), hyphens (-) and underscores (_) only.
optional canpost bool Indicates whether the viewing user can post on this board. (Default value is true.)
candelete bool Indicates whether the viewing user can delete any post or topic on this board. (Default value is false.)
canmark bool Indicates whether the viewing user can mark a post as relevant or irrelevant. (Default value is false.)
cancreatetopic bool Indicates whether the viewing user can create a topic on this board. (Default value is true.)
numtopics int The maximum number of topics to show in the box. (Default value is 3.)
callbackurl string The URL to refetch this configuration. (Default value is the current page.)
returnurl string The URL where the user is returned after selecting a "back" link. (Default value is the current page.)

Examples

<fb:board xid="titans_board" canpost="true" candelete="false" canmark="false" cancreatetopic="true" numtopics="5" returnurl="http://apps.facebook.com/myapp/titans/"> <fb:title>Discuss the Titans</fb:title> </fb:board>
facebook_board_discuss_the_titans.jpg

Notes

  • This tag works on application canvas pages only and not in other integration points like profile boxes.
  • This tag may contain fb:title

History

  • [Nov 7 2007] fb:board went into production as a semi-public beta.
  • [Dec 10 2007] fb:board is now a fully public beta.
Retrieved from "http://wiki.developers.facebook.com/index.php/Fb:board"
reference