pre_user_email filter-hookWP 2.0.3

Filters a user's email before the user is created or updated.

Usage

add_filter( 'pre_user_email', 'wp_kama_pre_user_email_filter' );

/**
 * Function for `pre_user_email` filter-hook.
 * 
 * @param string $raw_user_email The user's email.
 *
 * @return string
 */
function wp_kama_pre_user_email_filter( $raw_user_email ){

	// filter...
	return $raw_user_email;
}
$raw_user_email(string)
The user's email.

Changelog

Since 2.0.3 Introduced.

Where the hook is called

wp_insert_user()
pre_user_email
wp-includes/user.php 2198
$user_email = apply_filters( 'pre_user_email', $raw_user_email );

Where the hook is used in WordPress

wp-includes/default-filters.php 52
add_filter( $filter, 'trim' );
wp-includes/default-filters.php 53
add_filter( $filter, 'sanitize_email' );
wp-includes/default-filters.php 54
add_filter( $filter, 'wp_filter_kses' );