Reference Guide

facebook FBML Reference Guide Page 49 of 159
Tools
Fb:board
Description
This tag is currently in beta. It is available for all applications. Please post any bugs in bugzilla.
Displays a discussion board for a unique identifier. Facebook handles see all page, topic display, posting and
storage.
Fb:board is Facebook discussion board for developers to drop on 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_reply, 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
Required Name Type Description
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)
www.yapish.com