Fb:prompt-permission
From Facebook Developer Wiki
Contents |
Description
Renders the content of the tag as a link that, when clicked, initiates a dialog requesting the specified extended permissions from the user. You can prompt the user for a series of permissions.
If the user has already granted a permission, a dialog for that permission does not appear. If the user has not already authorized the application before clicking the link, he or she is prompted to authorize it before being prompted for the permission.
You can prompt a user to approve the following extended permissions for your application:
- Allowing email to be sent to the user
- Reading from a user's stream
- Publishing posts to a user's stream
- Granting offline access (what used to be known as an infinite session) for your application
- Updating user status
- Uploading and tagging photos
- Creating and modifying events
- Setting a user's RSVP status for an event
- Sending SMS to the user
- Uploading videos to user profiles
- Writing, editing, and deleting notes on user profiles
- Posting links to user profiles
Attributes
| Required | Name | Type | Description | |
| required | perms | string | A comma-separated string representing the extended permissions being requested. Specify any of the following permissions: email, read_stream, publish_stream, offline_access, status_update, photo_upload, create_event, rsvp_event, sms, video_upload, create_note, share_item. | |
|---|---|---|---|---|
| optional | next_fbjs | string | The FBJS that will be called if the user grants the requested permission. |
Examples
Whether you are formatting this tag as FBML or XFBML, it requires a closing tag.
<fb:prompt-permission perms="email">Would you like to receive email from our application?</fb:prompt-permission>
<fb:prompt-permission perms="read_stream,publish_stream">Would you like our application to read from and post to your News Feed?</fb:prompt-permission>
