Cataly...::Login(3pm)

💖 NAME 💖

ok so bestie, welcome to CatalystX::SimpleLogin::Form::Login — it's the validation for the login form ✨ (from the User Contributed Perl Documentation, perl v5.36.0, if you were clocking the vibe).

---

🌸 DESCRIPTION 🌸

It's an HTML::FormHandler form, but make it login. That's it. That's the whole assignment. It handles the login form for you and it ate 💅

---

🎀 FIELDS 🎀

these are the little input babies this form ships with, no cap:

• username — your name, bestie 🫶
• password — the secret one 🙈
• remember — the "keep me logged in" checkbox energy
• submit — the button that actually does the thing 👑

---

✨ METHODS ✨

the methods it's serving:

• validate — checks your input, does the vibe check 🌈
• add_auth_errors — adds the auth errors in 😭

---

🦋 SEE ALSO 🦋

go check out CatalystX::SimpleLogin::Controller::Login — that's the main character this form is besties with 👑

---

💜 CUSTOMIZATION 💜

changing the field names, lowkey

By default, the params passed to authenticate() are 'username' and 'password'. So like, default behaviour, standard stuff. But 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' — fr fr, those are the exact key names, don't freestyle them.

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

changing how it looks, highkey iconic

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' },
           ]
        }
    },
);

adding more fields ✨

Additional fields can be added — yes, you can just keep going:

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

extra args to authenticate 🧚

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 (yeah that's the original's spacing, we keep it verbatim bestie, the facts do not change 💖):

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

---

👑 AUTHORS 👑

See CatalystX::SimpleLogin for authors.

---

💀 LICENSE 💀

See CatalystX::SimpleLogin for license. (go read it, periodt)

---

ok that's the whole page, we're done here 🎀

perl v5.36.0 · 2022-08-28 · Cataly...::Login(3pm) — mwah, byeee 💖✨🦋