Phauxth v1.1.0 Phauxth.Confirm View Source

Module to provide user confirmation for new users and when resetting passwords.

Link to this section Summary

Functions

Verify the confirmation key and get the user data from the database

Link to this section Functions

Link to this function get_user(key_source, arg) View Source
Link to this function verify(params, user_context, opts \\ []) View Source

Verify the confirmation key and get the user data from the database.

This can be used to confirm an email for new users and also for password resetting.

Options

There are four options for the verify function:

  • endpoint - the name of the endpoint of your app

    • this can also be set in the config
  • max_age - the maximum age of the token, in seconds

    • the default is 1200 seconds (20 minutes)
  • mode - the mode - email confirmation or password resetting

    • set this to :pass_reset to use this function for password resetting
  • log_meta - additional custom metadata for Phauxth.Log

    • this should be a keyword list

In addition, there are also options for generating the token. See the documentation for the Phauxth.Token module for details.

Examples

The following function is an example of using verify in a Phoenix controller.

def index(conn, params) do
  case Phauxth.Confirm.verify(params, Accounts) do
    {:ok, user} ->
      Accounts.confirm_user(user)
      Message.confirm_success(user.email)
      conn
      |> put_flash(:info, "Your account has been confirmed")
      |> redirect(to: session_path(conn, :new))
    {:error, message} ->
      conn
      |> put_flash(:error, message)
      |> redirect(to: session_path(conn, :new))
      |> halt
  end
end

In this example, the Accounts.confirm_user function updates the database, setting the confirmed_at value to the current time.