NAME

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

VERSION

version 0.0401

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.

LEGAL

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