Catalyst::Authentication::Credential::Flickr - Flickr authentication for Catalyst


Catalyst-Authentication-Credential-Flickr documentation  | view source Contained in the Catalyst-Authentication-Credential-Flickr distribution.

Index


NAME

Top

Catalyst::Authentication::Credential::Flickr - Flickr authentication for Catalyst

SYNOPSIS

Top

In MyApp.pm

 use Catalyst qw/
    Authentication
    Session
    Session::Store::FastMmap
    Session::State::Cookie
 /;

 MyApp->config(
     "Plugin::Authentication" => {
         default_realm => "flickr",
         realms => {
             flickr => {
                 credential => {
                     class => "Flickr",
                 },

                 key    => 'flickr-key-here',
                 secret => 'flickr-secret-here',
                 perms  => 'read',
             },
         },
     },
 );

And then in your Controller:

 sub login : Local {
    my ($self, $c) = @_;

    my $realm = $c->get_auth_realm('flickr');
    $c->res->redirect( $realm->credential->authenticate_flickr_url($c) );
 }

And finally the callback you specified in your API key request (e.g. example.com/flickr/ ):

 sub flickr : Local {
    my ($self, $c) = @_;

    $c->authenticate();
    $c->res->redirect("/super/secret/member/area");
 }

DESCRIPTION

Top

This module handles Flickr API authentication in a Catalyst application.

When Catalyst::Plugin::Authentication 0.10 was released, the API had changed, resulting in broken code when using Catalyst::Plugin::Authentication::Credential::Flickr.

This module tries to follow the guidelines of the new API and deprecate Catalyst::Plugin::Authentication::Credential::Flickr.

Code changes are needed, but are fairly minimal.

METHODS

Top

As per guidelines of Catalyst::Plugin::Authentication, there are two mandatory methods, new and authenticate. Since this is not really enough for the Flickr API, I've added one more (and an alias).

new()

Will not be called by you directly, but will use the configuration you provide (see above). Mandatory parameters are key, secret and perms. Please see Flickr::API for more details on them.

authenticate_flickr_url( $c )

This method will return the authentication URL. Bounce your users there before calling the authentication method.

authenticate( )

Handles the authentication. Nothing more, nothing less. It returns a Catalyst::Authentication::User::Hash with the following keys (all coming straight from Flickr).

fullname
nsid
perms
token
username

AUTHOR

Top

M. Blom <blom@cpan.org> http://menno.b10m.net/perl/

COPYRIGHT

Top

SEE ALSO

Top

Catalyst::Plugin::Authentication, Flickr::API

BUGS

Top

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

THANKS

Top

Thanks go out Daisuke Murase for writing C::P::A::Credential::Flickr, Ashley Pond for inspiration and help in C::A::Credential::OpenID, Cal Henderson for Flickr::API.


Catalyst-Authentication-Credential-Flickr documentation  | view source Contained in the Catalyst-Authentication-Credential-Flickr distribution.