apply_filters( 'email_change_email', array $email_change_email, array $user, array $userdata )

Compatibility

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$email_change_emailarray

{ Used to build wp_mail().
@type string $to The intended recipients.
@type string $subject The subject of the email.
@type string $message 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.
@type string $headers Headers.
}

• $tostring

  The intended recipients.

• $subjectstring

  The subject of the email.

• $messagestring

  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.

• $headersstring

  Headers.

$userarray

The original user array.

$userdataarray

The updated user array.

Where this hook fires · 1

• wp-includes/user.php:2923wp_update_user()

Source code

View on Trac ↗View on GitHub ↗

2917		 *          - `###SITEURL###`     The URL to the site.2918		 *     @type string $headers Headers.2919		 * }2920		 * @param array $user     The original user array.2921		 * @param array $userdata The updated user array.2922		 */2923		$email_change_email = apply_filters( 'email_change_email', $email_change_email, $user, $userdata );2924 2925		$email_change_email['message'] = str_replace( '###USERNAME###', $user['user_login'], $email_change_email['message'] );2926		$email_change_email['message'] = str_replace( '###ADMIN_EMAIL###', get_option( 'admin_email' ), $email_change_email['message'] );2927		$email_change_email['message'] = str_replace( '###NEW_EMAIL###', $userdata['user_email'], $email_change_email['message'] );2928		$email_change_email['message'] = str_replace( '###EMAIL###', $user['user_email'], $email_change_email['message'] );2929		$email_change_email['message'] = str_replace( '###SITENAME###', $blog_name, $email_change_email['message'] );

Changelog

Introduced in 4.3.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.