pre_comment_author_email │ filter-hook │ WP 1.5.0

Filters the comment author's email cookie before it is set.

When this filter hook is evaluated in wp_filter_comment(), the comment author's email string is passed.

Usage

add_filter( 'pre_comment_author_email', 'wp_kama_pre_comment_author_email_filter' );

/**
 * Function for `pre_comment_author_email` filter-hook.
 * 
 * @param string $author_email_cookie The comment author email cookie.
 *
 * @return string
 */
function wp_kama_pre_comment_author_email_filter( $author_email_cookie ){

	// filter...
	return $author_email_cookie;
}

$author_email_cookie(string)

The comment author email cookie.

Changelog

Where the hook is called

$comment_author_email = apply_filters( 'pre_comment_author_email', $_COOKIE[ 'comment_author_email_' . COOKIEHASH ] );

$commentdata['comment_author_email'] = apply_filters( 'pre_comment_author_email', $commentdata['comment_author_email'] );

Where the hook is used in WordPress

add_filter( $filter, 'trim' );

add_filter( $filter, 'sanitize_email' );

add_filter( $filter, 'wp_filter_kses' );