GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CATALYSTX::SIMPLELOGIN::CONTROLLER::LOGIN (3)

.ds Aq ’

NAME

CatalystX::SimpleLogin::Controller::Login - Configurable login controller

CONTENTS

SYNOPSIS



    # For simple useage exmple, see CatalystX::SimpleLogin, this is a
    # full config example
    __PACKAGE__->config(
        Controller::Login => {
            traits => [
                WithRedirect, # Optional, enables redirect-back feature
                -RenderAsTTTemplate, # Optional, allows you to use your own template
            ],
            actions => {
                login => { # Also optional
                    PathPart => [theloginpage], # Change login action to /theloginpage
                },
            },
        },
    );



See CatalystX::SimpleLogin::Form::Login for configuring the form.

DESCRIPTION

Controller base class which exists to have login roles composed onto it for the login and logout actions.

ATTRIBUTES

    login_form_class

A class attribute containing the class of the form to be initialised. One can override it in a derived class with the class of a new form, possibly subclassing CatalystX::SimpleLogin::Form::Login. For example:



    package MyApp::Controller::Login;

    use Moose;

    extends(CatalystX::SimpleLogin::Controller::Login);

    has +login_form_class => (
        default => "MyApp::Form::Login",
    );

    1;



    login_form_class_roles

An attribute containing an array reference of roles to be consumed by the form. One can override it in a similar way to login_form_class:



    package MyApp::Controller::Login;

    use Moose;

    extends(CatalystX::SimpleLogin::Controller::Login);

    has +login_form_class_roles => (
        default => sub { [qw(MyApp::FormRole::Foo MyApp::FormRole::Bar)] },
    );

    1;



METHODS

    BUILD

Cause form instance to be built at application startup.

    do_post_login_redirect

This method does a post-login redirect. <B>TODOB> for BOBTFISH - should it even be public? If it does need to be public, then document it because the Pod coverage test failed.

    login

Login action.

    login_redirect

Redirect to the login action.

    login_GET

Displays the login form

    login_POST

Processes a submitted login form, and if correct, logs the user in and redirects

    not_required

A stub action that is anchored at the root of the site (/) and does not require registration (hence the name).

    redirect_after_login_uri

If you are using WithRedirect (i.e. by default), then this methd is overridden to redirect the user back to the page they intially hit which required authentication.

Note that even if the original URI was a post, then the redirect back will only be a GET.

If you choose <B>NOTB> to compose the WithRedirect trait, then you can set the uri users are redirected to with the redirect_after_login_uri config key, or by overriding the redirect_after_login_uri method in your own login controller if you need custom logic.

    render_login_form

Renders the login form. By default it just calls the form’s render method. If you want to do something different, like rendering the form with a template through your view, this is the place to hook into.

    required

A stub action that is anchored at the root of the site (/) and does require registration (hence the name).

SEE ALSO

CatalystX::SimpleLogin::TraitFor::Controller::Login::WithRedirect
CatalystX::SimpleLogin::Form::Login

AUTHORS

See CatalystX::SimpleLogin for authors.

LICENSE

See CatalystX::SimpleLogin for license.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CATALYSTX::SIMPLELOGIN::CONTROLLER::LOGIN (3) 2012-07-15

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.