Scroll to navigation

CatalystX::SimpleLogin::Form::Login(3pm) User Contributed Perl Documentation CatalystX::SimpleLogin::Form::Login(3pm)

NAME

CatalystX::SimpleLogin::Form::Login - validation for the login form

DESCRIPTION

A HTML::FormHandler form for the login form.

FIELDS

username
password
remember
submit

METHODS

validate
add_auth_errors

SEE ALSO

CatalystX::SimpleLogin::Controller::Login

CUSTOMIZATION

By default, the params passed to authenticate() are 'username' and 'password'. If you need to use different names, then you'll need to set the correct value(s) via login_form_args in the configuration. The keys are 'authenticate_username_field_name' and/or 'authenticate_password_field_name'. 

    __PACKAGE__->config(
        'Controller::Login' => {
            login_form_args => {
               authenticate_username_field_name => 'name',
               authenticate_password_field_name => 'password2',
            },
        },
    );

You can also change the way that the form is displayed by setting attributes. In MyApp.pm:

    __PACKAGE__->config(
        'Controller::Login' => {
            login_form_args => {
               login_error_message => 'Login failed',
               field_list => [
                   '+submit' => { value => 'Login' },
               ]
            }
        },
    );

Additional fields can be added:

   field_list => [
       'foo' => ( type => 'MyField' ),
       'bar' => { type => 'Text' },
   ]

Additional arguments to the authenticate call can be added: If your user table has a column "status" and you want only those with "status = 'active'"to be able to log .in

    __PACKAGE__->config(
        'Controller::Login' => {
            login_form_args => { 
                authenticate_args => { status => 1 },
            },
        },
    };

AUTHORS

See CatalystX::SimpleLogin for authors.

LICENSE

See CatalystX::SimpleLogin for license.
2016-07-29 perl v5.22.2