Reference Guide

facebook FBML Reference Guide Page 99 of 159
Fb:multi-friend-selector (condensed)
Description
There are actually two versions of this button - the full version and the condensed version. This page describes
the condensed version. For information about the full version, see fb:multi-friend-selector.
This is a more condensed version of an interface which must be used inside an fb:request-form to select some
number of friends to send an invitation or request. This interface includes a series of <input type="checkbox"
name="ids[]" value="[friend id]"> which is included for selected users in the form that gets submitted to your
<fb:request-form> action URL. For more information, check out fb:request-form.
There are two versions of the condensed multi-friend-selector - a one box version and a two box version. With
selected_rows set to 0, the one box version appears; it works like a normal check box where clicking a user
selects that user. With selected_rows set to anything larger, the two box version is used; this results in an upper
list containing unselected users and a lower list containing selected users.
The condensed multi-friend-selector behaves like a normal block level element, which is to say that you can
style it with a style attribute or by giving it a CSS class, and its width stretches to fit into the containing block.
Attributes
Required Name Type Description
required condensed
bool
Set this to true to use the condensed version of the multi-friend-selector. If
not set, the full fb:multi-friend-selector is used.
optional max
int
The maximum number of users that can be selected. This value ranges
from 1 to 35, and is capped at the number of friend requests the user has
remaining under their limit. This attribute is ignored if it is greater than
the number of requests your application is able to send.
exclude_ids
array
A comma-separated list of user IDs to exclude from the condensed multi-
friend-selector.
unselected_rows
int
The number of rows of friends to display in the unselected part of the
condensed multi-friend-selector. (default value is 6, and must be a
number between 4 and 15)
selected_rows
int
The number of rows of friends to display in the selected part of the
condensed multi-friend-selector. (default value is 5, and must be a
number between 5 and 15; or set it to 0 to indicate that you want only a
single box for both selected and unselected friends)
Post Variables
Required Name Type Description
ids
array
An array of the user IDs chosen by the user.
www.yapish.com