email_change_email │ filter-hook │ WP 4.3.0

Filters the contents of the email sent when the user's email is changed.

Usage

add_filter( 'email_change_email', 'wp_kama_email_change_filter', 10, 3 );

/**
 * Function for `email_change_email` filter-hook.
 * 
 * @param array $email_change_email Used to build wp_mail().
 * @param array $user               The original user array.
 * @param array $userdata           The updated user array.
 *
 * @return array
 */
function wp_kama_email_change_filter( $email_change_email, $user, $userdata ){

	// filter...
	return $email_change_email;
}

$email_change_email(array)

Used to build wp_mail().

• to(string)
  The intended recipients.

• subject(string)
  The subject of the email.

• message(string)
  The content of the email.

  The following strings have a special meaning and will get replaced dynamically:
  
  - ###USERNAME###    The current user's username.
  - ###ADMIN_EMAIL### The admin email in case this was unexpected.
  - ###NEW_EMAIL###   The new email address.
  - ###EMAIL###       The old email address.
  - ###SITENAME###    The name of the site.
  - ###SITEURL###     The URL to the site.
  

• headers(string)
  Headers.

$user(array)

The original user array.

$userdata(array)

The updated user array.

Changelog

Where the hook is called

$email_change_email = apply_filters( 'email_change_email', $email_change_email, $user, $userdata );

Where the hook is used in WordPress