Tags Order A-Z Category Context

<sn:multi-friend-selector>

Renders a friend selector box for sending requests/invites to the user's friends.

Modes

This tag has two modes, full screen (default) and compact. In full screen mode, this tag renders a large window which allows the user to select pictures of their friends. In compact mode, only the names of their friends are displayed. In either case, selecting someone from this list will add another variable named ids[] to the request.

In compact mode, if the selected_rows is zero, the bottom box is not rendered, and this control basically behaves like a list of checkboxes.

Attributes

  • string < required > A short message to display above the friend selector. Can be any string .
  • boolean < optional > Whether or not to show a border around the friend selector. The default is false. Must be a boolean .
  • integer < optional > The height of the friend selector in rows. Can vary from 3 to 10. The default is 4. Must be an int .
  • integer < optional > The maximum number of users that can be selected by the friend selector. Can range from 2 to 20 with 15 as the default. Must be an int .
  • string < optional > A comma separated list of member ids that will not show up in the selector. Can be any string .
  • boolean < optional > If true, render the condensed version of the friend selector. Must be a boolean . Default is false.
  • integer < optional > The number of rows in the selected portion of the condensed selector. Must be an int between 0 and 15 . Default is 5.
  • integer < optional > The number of rows in the unselected portion of the condensed selector. Must be an int between 5 and 15 . Default is 5.
  • boolean < optional > Additionally shows the online presence (online, offline, away, idle, mobile) of the friends. The default is false. Must be a boolean .
  • boolean < optional > Only display friends who are online at the moment.Requires the online_status attribute to be set to true. The default is false. Must be a boolean .

Valid Contexts

  • : The area where your app is displayed alone

Code

<sn:request-form action="" type="the evil" content="This is the
               content, but it's invalid"> <sn:multi-friend-selector
               actiontext="this is the action text"/> </sn:request-form>
Play with this code in the sandbox

this is the action text

Select up to 20 of your friends by clicking on their pictures.