NAME

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

VERSION

version 1.1203

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

new ( [ params ] )

params

A hash or hashref of parameters to pass to the constructor.

app_id

The application id that you get from Facebook after registering (http://developers.facebook.com/setup/) your application on their site.

postback

The URI that Facebook should post your authorization code back to.

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.

uri_as_string ( )

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

LEGAL

Facebook::Graph is Copyright 2010 - 2012 Plain Black Corporation (http://www.plainblack.com) and is licensed under the same terms as Perl itself.