login.rdoc

doc/login.rdoc
Last Update: 2024-04-16 08:22:53 -0700

Documentation for Login Feature

The login feature implements a login page. It’s the most commonly used feature.

In addition to the auth methods below, it provides a login method that wraps login_session, running login hooks and redirecting to the configured location.

rodauth.account           #=> { id: 123, ... }
rodauth.login('password') # login the current account

Auth Value Methods

login_additional_form_tags

HTML fragment containing additional form tags to use on the login form.

login_button

The text to use for the login button.

login_error_flash

The flash error to show for an unsuccessful login.

login_error_status

The response status to use when using an invalid login or password to login, 401 by default.

login_form_footer_links

An array of entries for links to show on the login page. Each entry is an array of three elements, sort order (integer), link href, and link text.

login_form_footer_links_heading

A heading to show before the login form footer links.

login_notice_flash

The flash notice to show after successful login.

login_page_title

The page title to use on the login form.

login_redirect

Where to redirect after a sucessful login.

login_redirect_session_key

The key in the session hash storing the location to redirect to after successful login.

login_return_to_requested_location?

Whether to redirect to the originally requested location after successful login when require_login was used, false by default.

login_route

The route to the login action. Defaults to login.

multi_phase_login_forms

An array of entries for authentication methods that can be used to login when using multi phase login. Each entry is an array of three elements, sort order (integer), HTML, and method to call if this entry is the only authentication method available (or nil to not call a method).

multi_phase_login_page_title

The page title to use on the login form after login has been entered when using multi phase login.

need_password_notice_flash

The flash notice to show during multi phase login after the login has been entered, when requesting the password.

use_multi_phase_login?

Whether to ask for login first, and only ask for password after asking for the login, false by default unless an alternative login feature such as email_auth or webauthn_login is used.

Auth Methods

before_login_route

Run arbitrary code before handling a login route.

login_form_footer

A message to display after the login form.

login_response

Return a response after a successful login. By default, redirects to login_redirect (or the requested location if login_return_to_requested_location? is true).

login_return_to_requested_location_path

If login_return_to_requested_location? is true, the path to use as the requested location. By default, uses the full path of the request for GET requests, and is nil for non-GET requests (in which case the default login_redirect will be used).

login_view

The HTML to use for the login form.

multi_phase_login_view

The HTML to use for the login form after login has been entered when using multi phase login.