So I just recently modified my code to adhere to the invitation use case because as you mention, it is a pretty common business use case.
I am sure there are many ways to do it but this is my approach. It is important to mention that I didn’t wanted to change the library’s flow that much so in the sake of clarity, some copy and paste was done with the required adjustments for the use case. One last important comment: this code is still not in production environment but working in development as expected.
I will also like to have anyones comments and feedback to make this code better and safer before it goes into production.
1. Add the required routes to handle the invitation
This routes require that the user be authenticated
get "/users/invite", UserInvitationController, :new
post "/users/invite", UserInvitationController, :create
This routes do no require the user to be authenticated
get "/users/invite/:token", UserInvitationController, :accept
put "/users/invite/:token/:id/invite_update", UserInvitationController, :update_user
2. Add a user invitation controller
The Flow:
a. Authorized user creates the invitation (new) and a user_invitation is sent by email
b. The invited user clicks the link (accept) and updates its name or other required fields.
c. The user is updated in the database (update_user)
d. Normal confirmation flow (in my case, we use this confirmation flow for legal purposes you might not need it. If this is the case, you might want to update the confirmation user’s field in step 3.
defmodule EprWeb.UserInvitationController do
use EprWeb, :controller
alias Epr.Accounts
alias Epr.Accounts.User
def new(conn, _params) do
changeset = Accounts.change_user_invitation(%User{})
render(conn, "new.html", changeset: changeset)
end
def create(conn, %{"user" => user_params}) do
case Accounts.invite_user(user_params) do
{:ok, user} ->
{:ok, _} =
Accounts.deliver_user_invitation_instructions(
user,
&Routes.user_invitation_url(conn, :accept, &1)
)
conn
|> put_flash(:info, "User invited successfully.")
|> redirect(to: "/users")
{:error, %Ecto.Changeset{} = changeset} ->
render(conn, "new.html", changeset: changeset)
end
end
def accept(conn, %{"token" => token}) do
case Accounts.fetch_user_from_invitation(token) do
{:ok, user} ->
changeset = Accounts.change_user_invitation(user)
render(conn, "accept.html", changeset: changeset, user: user, token: token)
:error ->
invalid_token(conn)
end
end
def update_user(conn, %{"user" => user_params, "token" => token}) do
case Accounts.accept_invitation(token, user_params) do
{:ok, user} ->
{:ok, _} =
Accounts.deliver_user_confirmation_instructions(
user,
&Routes.user_confirmation_url(conn, :confirm, &1)
)
conn
|> put_flash(:info, "User registered successfully.")
|> redirect(to: "/")
{:error, %Ecto.Changeset{} = changeset} ->
case Accounts.fetch_user_from_invitation(token) do
{:ok, user} ->
render(conn, "accept.html", changeset: changeset, user: user, token: token)
:error ->
invalid_token(conn)
end
:error ->
invalid_token(conn)
end
end
defp invalid_token(conn) do
conn
|> put_flash(:error, "Invitation link is invalid or it has expired.")
|> redirect(to: "/")
end
end
3. Templates and views are very simple and straight forward
4. In your context… in my case, Accounts Context
def change_user_invitation(%User{} = user, attrs \\ %{}) do
User.invitation_changeset(user, attrs)
end
def deliver_user_invitation_instructions(%User{} = user, invitation_url_fun)
when is_function(invitation_url_fun, 1) do
if user.confirmed_at do
{:error, :already_confirmed}
else
{encoded_token, user_token} = UserToken.build_email_token(user, "invitation")
Repo.insert!(user_token)
UserNotifier.deliver_invitation_instructions(user, invitation_url_fun.(encoded_token))
end
end
def fetch_user_from_invitation(token) do
with {:ok, query} <- UserToken.verify_email_token_query(token, "invitation"),
%User{} = user <- Repo.one(query) do
{:ok, user}
else
_ -> :error
end
end
def accept_invitation(token, user_params) do
with {:ok, query} <- UserToken.verify_email_token_query(token, "invitation"),
%User{} = user <- Repo.one(query),
{:ok, changeset} <- valid_invitation_changeset(user, user_params),
{:ok, %{user: user}} <- Repo.transaction(accept_invitation_multi(user, changeset)) do
{:ok, user}
else
{:error, %Ecto.Changeset{} = ch} -> {:error, ch}
_ -> :error
end
end
defp valid_invitation_changeset(user, params) do
changeset = User.accept_invitation_changeset(user, params)
case changeset.valid? do
true -> {:ok, changeset}
false -> {:error, changeset}
end
end
defp accept_invitation_multi(user, user_update_changeset) do
Ecto.Multi.new()
|> Ecto.Multi.update(:user, user_update_changeset)
|> Ecto.Multi.delete_all(:tokens, UserToken.user_and_contexts_query(user, ["invitation"]))
end
5. In your user_token.ex
I am keeping the invitation validity for 7 days
@invite_validity_in_days 7
Added the “invitation” case in the days_for_context validation time
defp days_for_context("invitation"), do: @invite_validity_in_days
6. Finally, modify your user_notification.ex file to your specific case
I just added a function to handle the invitation case
def deliver_invitation_instructions(user, url) do
....
end
I think this is it…
Hope this helps,
Best regards,