Fb:multi-friend-selector
From Facebook Developers Wiki
Contents |
[edit] Description
There are actually two versions of this button - the full version and the condensed version. This page describes the full version. For information about the condensed version, see fb:multi-friend-selector (condensed).
This is a nearly full-page interface intended to be used on canvas pages to allow the user to send a "large" number of requests or invitations (where "large" is generally some number more than 4). This tag must be used inside an fb:request-form tag. This interface includes a series of <input type="hidden" name="ids[]" value="[friend id]"> which are included for selected users in the form that gets submitted to your <fb:request-form> action URL. Both the Skip this Step button and the Submit button take the user to the parent fb:request-form action URL.
For developers using iframes, a full page version of this is available. Please see Multi_friend_selector for information about using it.
A user may invite a number of people each day equal to the maximum number of requests allocated to your application. If a user attempts to go over this limit, the following message appears:
[edit] Attributes
| Required | Name | Type | Description | |
| required | actiontext | string | An instructional message to display to users at the top of the multi-friend-selector. | |
|---|---|---|---|---|
| optional | showborder | bool | Indicates whether you want a border around the outside of the multi-friend-selector. | |
| rows | int | The number of rows of friends to show in the multi-friend-selector. (Default value is 5 and the value must be between 3 and 10.) | ||
| 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 multi-friend-selector. | ||
| bypass | string | The version of the Bypass button you want to use. Set this attribute to "step", "cancel", or "skip", which results in Skip This Step, Cancel, or Skip, respectively. (Default value is skip.) |
[edit] POST Variables
| Required | Name | Type | Description | |
| ids | array | An array of the user IDs chosen by the user. |
[edit] Examples
 |
