How would I show a message and define where the user is redirected after changing their email through a front end form?

Question

I have a profile form where a user can update their email.

Upon doing so I would like to:

1. Show the user a message saying they must check their email to verify the new email address.
2. After they click the "Verify Email" address in their inbox, redirect them to a url preferably with a Flash Message letting them know they'e successfully updated their email.

Possible?

Answer 1

Based on Brad's response I created the following controller in a plugin:

<?php
namespace Craft;

class Myplugin_SaveUserController extends BaseController
{
    protected $allowAnonymous = true;
    /**
     * Handle the save user form request.
     */
    public function actionSaveUser()
    {
        $this->requirePostRequest();
        $email  = craft()->request->getPost('email');
        $userId = craft()->request->getPost('userId');
        $user   = craft()->users->getUserById($userId);

        if ($email !== $user->email)
        {
            craft()->userSession->setFlash('changedEmail', 'changed email');
        }
        $this->forward('users/saveUser', false);
    }
}

I then check for it in my template:

{% if craft.session.getFlash('changedEmail') == 'changed email' %}

This seems to do the job.

For anyone who may be using this in the future, it's worth noting that I also had to change the "action" hidden input in my form:

<input type="hidden" name="action" value="myplugin/saveUser/saveUser">

Answer 2

In Craft when changing an email address (even if it's the currently logged in user), they must supply their existing password as well. You can use the hidden redirect input to send to whatever template you want (assuming saving the user was successful). In your case, then template can tell them to check their email and click the link it contains.

<form method="post" accept-charset="UTF-8">
    {{ getCsrfInput() }}

    <input type="hidden" name="action" value="users/saveUser">
    <input type="hidden" name="redirect" value="users/checkyouremail">
    <input type="hidden" name="userId" value="{{ currentUser.id }}">

    <input type="text" name="email" value="{{ currentUser.email }}">
    <input id="password" type="password" name="password">

    <input type="submit" value="Save Profile">
</form>

Once the click the link and verify they own the email address, they'll get redirected to the site root.

If you need different behavior than that, you can always write a plugin that has it's own controller actions that changes the workflow into something you need.