Kingsman How To: Change Email Feature
Important: These docs are for the outdated Jets 5 versions and below. For the latest Jets docs: docs.rubyonjets.com
A common authentication feature is the ability to allow users to change their own email. We’ll show you an example implementation of this feature.
Note: This implementation assumes the confirmable module has been enabled.
Controller
app/controllers/account/emails_controller.rb
class Account::PasswordsController < ApplicationController
before_action :authenticate_user!
def edit
end
def update
if current_user.update_with_password(user_params)
bypass_sign_in current_user
redirect_to root_path, :notice => "You updated your account successfully, but we need to verify your new email address. Please check your email and follow the confirmation link to confirm your new email address."
else
render :edit
end
end
private
def user_params
params.require(:user).permit(:current_password, :email)
end
end
Note, current_user.update_with_password(user_params) is provided by Kingsman and requires the user to specify their current password to perform the update.
Routes
config/routes.rb
Jets.application.routes.draw do
namespace :account do
resource :emails, only: %w[edit update]
end
end
Views
app/views/account/passwords/edit.html.erb
<h1>Change email</h1>
<%= render partial: "shared/error_messages", locals: {model: current_user} %>
<%= form_with(model: current_user, url: account_email_path) do |form| %>
<div class="form-group">
<%= form.label :current_password %>
<%= form.password_field :current_password, class: "form-control" %>
<small class="form-text">Note: Provide the current password to change the email.</small>
</div>
<div class="form-group">
<%= form.label :email, "Current Email" %>
<%= form.email_field :email, class: "form-control" %>
<small class="form-text">Note: Changing the current email will send an email to confirm.</small>
</div>
<% unless current_user.unconfirmed_email.blank? %>
<div class="form-group">
<%= form.label :unconfirmed_email, "New Unconfirmed Email" %>
<%= current_user.unconfirmed_email %>
<small class="form-text">This email is pending confirmation. Please check the email for confirmation instructions.</small>
</div>
<% end %>
<div class="actions">
<%= form.submit "Change my email" %>
</div>
<% end %>
app/views/shared/error_messages.html.erb
<% if model.errors.any? %>
<div id="error_explanation">
<h2><%= pluralize(model.errors.count, "error") %> prohibited this <%= model.class.name.underscore %> from being saved:</h2>
<ul>
<% model.errors.full_messages.each do |message| %>
<li><%= message %></li>
<% end %>
</ul>
</div>
<% end %>