Name

<fb:multi-friend-selector/>

Synopsis

<fb:multi-friend-selector actiontext="..."/>

Renders a full-page friend selector with pictures of all of the user’s friends and their names and networks. This control handles all limits that Facebook enforces on applications, preventing the user from going over their allocated number of requests per day for your application. For a smaller version of this without the pictures, see the condensed version of <fb:multi-friend-selector/>. This tag can be used only within <fb:request-form/> tags. Use the condensed attribute to produce a smaller version of this.

FBML-Specific Attributes

Required

actiontext=[string] default: none

The invite text to include in the multi-friend selector.

Optional

condensed=[true|false] default: false

If true, shows the condensed form of <fb:multi-friend-selector/>.

showborder=[true|false] default: false

If true, displays a border around the multi-friend selector. Works only if condensed="false".

rows=[int] default: 5

The number of rows of friends to display. Works only if condensed="false".

max=[1...35] default: none

The maximum number of friends allowed to be selected. This caps at the number of invites allowed to your app at a given time that remain for that user.

exclude_ids=[array] default: none

A comma-separated list of friends to be excluded from the list of friends.

bypass=[step|cancel|skip] default: skip

Each multi-friend selector includes a bypass button. This attribute designates the kind of bypass button to be used: step renders “Skip This Step”; cancel renders “Cancel”; and skip renders “Skip.” Works only if condensed="false".

unselected_rows=[4...15] default: 6

The number of unselected rows to display in the condensed form of <fb:multi-friend-selector/>. Works only if condensed="true".

selected_rows=[0,5...15] default: 5

The number of rows to display in the selected portion of the condensed form of <fb:multi-friend-selector/>. If 0, displays only a single box for both selected and unselected portions. Works only if condensed="true".

Example FBML

See the <fb:request-form/> tag earlier in this chapter for an example of the noncondensed <fb:multi-friend-selector/>.

Here is example FBML code for a condensed <fb:multi-friend-selector/> (Figure 3-48 shows the result):

<fb:request-form action="index.php" method="POST" invite="true" 
     type="FBML Essentials" content="Hello Friend.">
  <fb:multi-friend-selector condensed="true" exclude_ids="1,4,5,6" />
  <fb:request-form-submit/>
</fb:request-form>
The result of our condensed <fb:multi-friend-selector/> example
Figure 3-48. The result of our condensed <fb:multi-friend-selector/> example

Additional Information

  • This tag can be used only in <fb:request-form/> tags.

  • To use this tag for notifications, you have to generate your own HTML. View the source to see how Facebook does it, or create your own.

..................Content has been hidden....................

You can't read the all page of ebook, please click here login for view all page.
Reset
18.118.226.240