Documentation

In order to have your site make additional communications (such as publishing content to Facebook walls, obtaining email addresses, etc) with Facebook, your users must manually grant permissions for your site. Using the permissions parameter on the Facebook Login button (FBC:Login tag) allows you to control and set permissions for the user. However, if the account was synced with the Facebook Registration form or through Passive Registration, you'll have to use this tag to have the user grant more permissions to your site. Also, if you've already had a user grant permissions for some things, but you'd like to request more permissions at any time afterwards, you'd do so with this tag. The Set_Permissions tag allows to you create a button that lets your users do so. When clicked, it opens an FB dialogue box that prompts the current FB user to allow the current site extended permissions.

If all of the permissions tied to this button have been granted for a given user, when that user clicks the button an additional time, it will not load the modal window again (until there's a new permission to grant).

• Parameters
• Examples

Parameters

The following parameters are available for use:

• button_label
• button_size
• permissions
• refresh_page

button_label=

You can change the text label for the Facebook-style Permissions button with this parameter.

button_size=

This parameter allows you to change the size of the Facebook Set Permissions button. You can only choose from predetermined options from Facebook: small, medium, large, or xlarge.

permissions=

This parameter allows you to provide a list of permissions (seperate with pipe character) to request from the user as below:

• email - this permission grants the current site permission to send email to the user using the proxied FB email address.
• publish_stream - this permission allows the current site to submit a user's comments and other submissions up to their FB wall or news stream.
• read_stream - this permission allows the current site to read from a user's FB stream and grab stuff like comments and statuses and the like.
• The above 3 permissions are the main ones you'll need. You can view the full list of permissions in the Facebook Permissions Documentation. Use the names mentioned in the User permission column.

refresh_page=

By default, users granting permissions to the site will see the page refresh once they have granted those permissions. Use this parameter to disable this by setting the value to no.

Examples

Below is an example of how you would display a Facebook-style button in your template that allows a Facebook logged in user to allow more permissions to your site (will display as a button):