verify_account.rdoc

doc/verify_account.rdoc
Last Update: 2023-10-09 15:48:54 -0700

Documentation for Verify Account Feature

The verify account feature implements account verification after account creation. After account creation, users are sent an email containing a link to verify the account. Users cannot login to the account until after verifying the account. Depends on the login and create account features.

Auth Value Methods

attempt_to_create_unverified_account_error_flash

The flash error message to show when attempting to create an account awaiting verification.

attempt_to_login_to_unverified_account_error_flash

The flash error message to show when attempting to login to an account awaiting verification.

no_matching_verify_account_key_error_flash

The flash error message to show when an invalid verify account key is used.

resend_verify_account_page_title

The page title to use on page requesting resending the verify account email.

verify_account_additional_form_tags

HTML fragment containing additional form tags to use on the verify account form.

verify_account_autologin?

Whether to autologin the user after successful account verification, true by default.

verify_account_button

The text to use for the verify account button.

verify_account_email_last_sent_column

The email last sent column in the verify_account_table. Set to nil to always send a verify account email when requested.

verify_account_email_recently_sent_error_flash

The flash error to show if not sending verify account email because one has been sent recently.

verify_account_email_recently_sent_redirect

Where to redirect if not sending verify account email because one has been sent recently.

verify_account_email_sent_notice_flash

The flash notice to set after sending the verify account email.

verify_account_email_sent_redirect

Where to redirect after sending the verify account email.

verify_account_email_subject

The subject to use for the verify account email.

verify_account_error_flash

The flash error to show if no matching key is submitted when verifying an account.

verify_account_id_column

The id column in the verify_account_table, should be a foreign key referencing the accounts table.

verify_account_key_column

The verify account key/token column in the verify_account_table.

verify_account_key_param

The parameter name to use for the verify account key.

verify_account_notice_flash

The flash notice to show after verifying the account.

verify_account_page_title

The page title to use on the verify account form.

verify_account_redirect

Where to redirect after verifying the account.

verify_account_resend_additional_form_tags

HTML fragment containing additional form tags to use on the page requesting resending the verify account email.

verify_account_resend_button

The text to use for the verify account resend button.

verify_account_resend_error_flash

The flash error to show if unable to resend a verify account email.

verify_account_resend_explanatory_text

The text to display above the button to resend the verify account email.

verify_account_resend_link_text

The text to use for a link to the page to request the account verification email be resent.

verify_account_resend_route

The route to the verify account resend action. Defaults to verify-account-resend.

verify_account_route

The route to the verify account action. Defaults to verify-account.

verify_account_session_key

The key in the session to hold the verify account key temporarily.

verify_account_set_password?

Whether to ask for a password to be set on the verify account form. True by default. If set to false, will ask for password when creating the account instead of when verifying.

verify_account_skip_resend_email_within

The number of seconds before sending another verify account email, if verify_account_email_last_sent_column is set.

verify_account_table

The name of the verify account keys table.

Auth Methods

account_from_verify_account_key(key)

Retrieve the account using the given verify account key, or return nil if no account matches.

after_verify_account

Run arbitrary code after verifying the account.

after_verify_account_email_resend

Run arbitrary code after resending a verify account email.

allow_resending_verify_account_email?

Whether to allow sending the verify account email for the account, true by default only if the account has not been verified.

before_verify_account

Run arbitrary code before verifying the account.

before_verify_account_email_resend

Run arbitrary code before resending a verify account email.

before_verify_account_resend_route

Run arbitrary code before handling a verify account resend route.

before_verify_account_route

Run arbitrary code before handling a verify account route.

create_verify_account_email

A Mail::Message for the verify account email.

create_verify_account_key

Add the verify account key data to the database.

get_verify_account_email_last_sent

Get the last time a verify account email is sent, or nil if there is no last sent time.

get_verify_account_key(id)

Get the verify account key for the given account id from the database.

remove_verify_account_key

Remove the verify account key for the current account, run after successful account verification.

resend_verify_account_view

The HTML to use for page requesting resending the verify account email.

send_verify_account_email

Send the verify account email.

set_verify_account_email_last_sent

Set the last time a verify account email is sent.

verify_account

Verify the account by changing the status from unverified to open.

verify_account_email_body

The body to use for the verify account email.

verify_account_email_link

The link to the verify account form in the verify account email.

verify_account_email_sent_response

Return a response after successfully sending an verify account email. By default, redirects to verify_account_email_sent_redirect.

verify_account_key_insert_hash

The hash to insert into the verify_account_table.

verify_account_key_value

The value of the verify account key.

verify_account_response

Return a response after successfully verifying an account. By default, redirects to verify_account_redirect.

verify_account_view

The HTML to use for the verify account form.