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

SYNOPSIS
    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
    When Catalyst::Plugin::Authentication 0.10 was released, the API had
    changed, resulting in broken code for some of my projects. They claim to
    have some backward compatibility however, so it was most likely just my
    own bad coding that broke stuff.

    Anyways, Catalyst::Plugin::Authentication::Credential::Flickr didn't do
    what I wanted it to do and so I decided to rewrite the code, based on
    the new API.

    This version tries to follow the guidelines of the new API and should
    almost be a drop in replacement for
    C::P::Authentication::Credential::Flickr. Well, at least code changes
    are kept to a minimal.

METHODS
    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.

  request_auth_url( $c )
    This method will return the authentication URL. Bounce your users there
    before calling the "authentication" method.

  authenticate_flickr_url( $c )
    Alias for "request_auth_url" ('cause
    C::P::Authentication::Credential::Flickr used to call the method like
    this).

  authenticate()
    Handles the authentication. Nothing more, nothing less.

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

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, Flickr::API

BUGS
    "Bugs? Impossible!". Please report bugs to
    <http://rt.cpan.org/Ticket/Create.html?Queue=Catalyst-Authentication-Cre
    dentials-Flickr>

THANKS
    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.

