Reference Guide

facebook FBML Reference Guide Page 90 of 159
Fb:request-form
Description
Creates a form that sends requests to the selected users. To send requests/invitations to users, create one of these
forms and include either an fb:multi-friend-selector or any combination of fb:multi-friend-input, fb:friend-
selector and fb:request-form-submit. The form is submitted after the user confirms the sending of the request.
In the case where you are not using an fb:multi-friend-selector, the only way for a user to submit a
request/invitation through this form is via an fb:request-form-submit button.
In general, use fb:multi-friend-selector in a nearly full-page invitation interface where the user is intended to
select a large number of people, and fb:friend-selector or fb:multi-friend-input in situations where the user is
selecting a smaller number of users and you want to integrate it into the context of your own page. As a middle-
ground alternative, you can use the fb:multi-friend-selector (condensed) for places where the user might select a
medium-sized list of people without needing a full-page interstitial invitations interface.
For developers using iframes, you cannot get the full flexibility of the fb:request-form system. However, you
can still send requests using the Multi_friend_selector, or you can use the fb_force_mode parameter to render a
particular canvas page with FBML.
For developers wishing to utilize more form parameters, typical form input can be used with the attribute, fb-
protected="true", within any fb:request-form-submit tag.
Attributes
Required Name Type Description
required type
string
The type of request or invitation to generate. This corresponds to the word that is
displayed on the home page. For example, "event."
content
string
The contents of the request or invitation to be sent. It should use FBML
formatting that contains only links and the special tag <fb:req-choice url=""
label="" /> to specify the buttons to be included in the request. Make sure that
you properly encode this attribute. For example, use the PHP "htmlentities"
function.
optional invite
bool
Set this to true if you want to send an invitation or false if you want to send a
request. The difference between them is in the content that the user sees. (default
value is false)
action
string
The place where a user gets redirected after submitting the form through the
fb:request-form-submit button or when they click Skip this Step. By default the
user is directed to http://apps.facebook.com/yourapp/null. Note: This default
behavior may not be preserved.
[verify]
method
string
Set it to either GET or POST, as you would with a form.
Post Variables
Required Name Type Description
typeahead
string
The string containing any content the user typed into the multi-selector box.
www.yapish.com