NAME

Facebook::Graph::Authorize - Authorizing an app with Facebook

VERSION

version 1.0801

SYNOPSIS

 my $fb = Facebook::Graph->new(
    secret      => $facebook_application_secret,
    app_id      => $facebook_application_id,
    postback    => 'https://www.yourapplication.com/facebook/postback',
 );

 my $uri = $fb->authorize
    ->extend_permissions(qw( email publish_stream ))
    ->set_display('popup')
    ->uri_as_string;

DESCRIPTION

Get an authorization code from Facebook so that you can request an access token to make privileged requests. The result of this package is to give you a URI to redirect a user to Facebook so they can log in, and approve whatever permissions you are requesting.

METHODS

extend_permissions ( permissions )

Ask for extra permissions for your app. By default, if you do not request extended permissions your app will have access to only general information that any Facebook user would have. Returns a reference to self for method chaining.

permissions

An array of permissions. See <http://developers.facebook.com/docs/authentication/permissions> for more information about what's available.

set_display ( type )

Sets the display type for the authorization screen that a user will see.

type

Defaults to "page". Valid types are "page", "popup", "wap", and "touch". See Dialog Form Factors in <http://developers.facebook.com/docs/authentication/> for details.

uri_as_string ( )

Returns a URI string to redirect the user back to Facebook.