Jesse Stay > Catalyst-Authentication-Credential-Facebook > Catalyst::Authentication::Credential::Facebook

Download:
Catalyst-Authentication-Credential-Facebook-0.01000.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 0.01000   Source  

NAME ^

Catalyst::Authentication::Credential::Facebook - Facebook authentication for Catalyst

SYNOPSIS ^

In MyApp.pm

 use Catalyst qw/
    Authentication
    Session
    Session::Store::FastMmap
    Session::State::Cookie
        Facebook
 /;
 
 MyApp->config(
     "Plugin::Authentication" => {
         default_realm => "facebook",
         realms => {
             'facebook' => {
                 credential => {
                     class => "Facebook",
                 },
             },
         },
     },
 );

And then in your Controller:

 sub login : Local {
    my ($self, $c) = @_;
   
        if (my $user = $c->authenticate(undef,'facebook')) {
                # user is logged in - redirect or do something
        }
        else {
                # user has no account in your system
                # detect Facebook credentials and create an account
                # or do comething else
        } 
 }

DESCRIPTION ^

This module handles Facebook Platform authentication in a Catalyst application.

METHODS ^

As per guidelines of Catalyst::Plugin::Authentication, there are two mandatory methods, new and authenticate.

new()

Will not be called by you directly, but will use the configuration you provide (see above). WWW::Facebook::API is required, but we also suggest you install Catalyst::Plugin::Facebook for ultimate Facebook integration after the user is authenticated.

authenticate( )

Handles the authentication. Nothing more, nothing less. It returns a Catalyst::Authentication::User::Hash (this is a user object from your database - the user table should have a column called "facebook_id", which the authenticated Facebook user is checked against)

AUTHOR ^

Jesse Stay <jesse@staynalive.com> http://staynalive.com

COPYRIGHT ^

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.

SEE ALSO ^

Catalyst::Plugin::Authentication, WWW::Facebook::API

BUGS ^

Bugs? Impossible!. Please report bugs to http://rt.cpan.org/Ticket/Create.html?Queue=Catalyst-Authentication-Credential-Facebook

THANKS ^

Special thanks to David Romano and Clayton Scott for writing and maintaining WWW::Facebook::API

syntax highlighting: