| FBML has been deprecated. Starting June 1, 2012 FBML apps will no longer work as all FBML endpoints will be removed. If you are building a new application on Facebook.com, please implement your application using HTML, JavaScript and CSS. You can use our JavaScript SDK and Social Plugins to embedded many of the same social features available in FBML. |
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
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.
The condensed multi-friend-selector also allows users to invite their non-Facebook email contacts through an email contact importer. In order to disable, this feature, see fb:request-form-submit.
| Name | Type | Description |
|---|---|---|
| condensed | bool | Set this to |
| 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 |
<div style="padding: 10px;">
<fb:request-form method="post" action="index.php" content="hey" type="sample" invite="true">
<div class="clearfix" style="padding-bottom: 10px;">
<fb:multi-friend-selector condensed="true" style="width: 200px;" />
</div>
<fb:request-form-submit />
</fb:request-form>
</div><div style="padding: 10px;">
<fb:request-form method="post" action="index.php" content="hey" type="sample" invite="true">
<div class="clearfix" style="padding-bottom: 10px;">
<fb:multi-friend-selector condensed="true" selected_rows="0" style="width: 200px;" />
</div>
<fb:request-form-submit />
</fb:request-form>
</div>