get_comment_author_email

The timeline below displays how wordpress function get_comment_author_email has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.2

/**
 * Retrieves the email of the author of the current comment.
 *
 * @since 1.5.0
 * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object.
 *
 * @param int|WP_Comment $comment_id Optional. WP_Comment or the ID of the comment for which to get the author's email.
 *                                   Default current comment.
 * @return string The current comment author's email
 */
function get_comment_author_email($comment_id = 0)
{
    $comment = get_comment($comment_id);
    /**
     * Filters the comment author's returned email address.
     *
     * @since 1.5.0
     * @since 4.1.0 The `$comment_id` and `$comment` parameters were added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param string     $comment_id           The comment ID as a numeric string.
     * @param WP_Comment $comment              The comment object.
     */
    return apply_filters('get_comment_author_email', $comment->comment_author_email, $comment->comment_ID, $comment);
}

WordPress Version: 5.9

/**
 * Retrieves the email of the author of the current comment.
 *
 * @since 1.5.0
 * @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
 *
 * @param int|WP_Comment $comment_ID Optional. WP_Comment or the ID of the comment for which to get the author's email.
 *                                   Default current comment.
 * @return string The current comment author's email
 */
function get_comment_author_email($comment_ID = 0)
{
    $comment = get_comment($comment_ID);
    /**
     * Filters the comment author's returned email address.
     *
     * @since 1.5.0
     * @since 4.1.0 The `$comment_ID` and `$comment` parameters were added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param string     $comment_ID           The comment ID as a numeric string.
     * @param WP_Comment $comment              The comment object.
     */
    return apply_filters('get_comment_author_email', $comment->comment_author_email, $comment->comment_ID, $comment);
}

WordPress Version: 5.4

/**
 * Retrieves the email of the author of the current comment.
 *
 * @since 1.5.0
 * @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
 *
 * @param int|WP_Comment $comment_ID Optional. WP_Comment or the ID of the comment for which to get the author's email.
 *                                   Default current comment.
 * @return string The current comment author's email
 */
function get_comment_author_email($comment_ID = 0)
{
    $comment = get_comment($comment_ID);
    /**
     * Filters the comment author's returned email address.
     *
     * @since 1.5.0
     * @since 4.1.0 The `$comment_ID` and `$comment` parameters were added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param int        $comment_ID           The comment ID.
     * @param WP_Comment $comment              The comment object.
     */
    return apply_filters('get_comment_author_email', $comment->comment_author_email, $comment->comment_ID, $comment);
}

WordPress Version: 5.1

/**
 * Retrieve the email of the author of the current comment.
 *
 * @since 1.5.0
 * @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
 *
 * @param int|WP_Comment $comment_ID Optional. WP_Comment or the ID of the comment for which to get the author's email.
 *                                   Default current comment.
 * @return string The current comment author's email
 */
function get_comment_author_email($comment_ID = 0)
{
    $comment = get_comment($comment_ID);
    /**
     * Filters the comment author's returned email address.
     *
     * @since 1.5.0
     * @since 4.1.0 The `$comment_ID` and `$comment` parameters were added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param int        $comment_ID           The comment ID.
     * @param WP_Comment $comment              The comment object.
     */
    return apply_filters('get_comment_author_email', $comment->comment_author_email, $comment->comment_ID, $comment);
}

WordPress Version: 4.6

/**
 * Retrieve the email of the author of the current comment.
 *
 * @since 1.5.0
 * @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
 *
 * @param int|WP_Comment $comment_ID Optional. WP_Comment or the ID of the comment for which to get the author's email.
 *									 Default current comment.
 * @return string The current comment author's email
 */
function get_comment_author_email($comment_ID = 0)
{
    $comment = get_comment($comment_ID);
    /**
     * Filters the comment author's returned email address.
     *
     * @since 1.5.0
     * @since 4.1.0 The `$comment_ID` and `$comment` parameters were added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param int        $comment_ID           The comment ID.
     * @param WP_Comment $comment              The comment object.
     */
    return apply_filters('get_comment_author_email', $comment->comment_author_email, $comment->comment_ID, $comment);
}

WordPress Version: 4.4

/**
 * Retrieve the email of the author of the current comment.
 *
 * @since 1.5.0
 * @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
 *
 * @param int|WP_Comment $comment_ID Optional. WP_Comment or the ID of the comment for which to get the author's email.
 *									 Default current comment.
 * @return string The current comment author's email
 */
function get_comment_author_email($comment_ID = 0)
{
    $comment = get_comment($comment_ID);
    /**
     * Filter the comment author's returned email address.
     *
     * @since 1.5.0
     * @since 4.1.0 The `$comment_ID` and `$comment` parameters were added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param int        $comment_ID           The comment ID.
     * @param WP_Comment $comment              The comment object.
     */
    return apply_filters('get_comment_author_email', $comment->comment_author_email, $comment->comment_ID, $comment);
}

WordPress Version: 4.1

/**
 * Retrieve the email of the author of the current comment.
 *
 * @since 1.5.0
 *
 * @param int $comment_ID Optional. The ID of the comment for which to get the author's email. Default current comment.
 * @return string The current comment author's email
 */
function get_comment_author_email($comment_ID = 0)
{
    $comment = get_comment($comment_ID);
    /**
     * Filter the comment author's returned email address.
     *
     * @since 1.5.0
     * @since 4.1.0 The `$comment_ID` and `$comment` parameters were added.
     *
     * @param string $comment_author_email The comment author's email address.
     * @param int    $comment_ID           The comment ID.
     * @param object $comment              The comment object.
     */
    return apply_filters('get_comment_author_email', $comment->comment_author_email, $comment_ID, $comment);
}

WordPress Version: 3.9

/**
 * Retrieve the email of the author of the current comment.
 *
 * @since 1.5.0
 *
 * @param int $comment_ID Optional. The ID of the comment for which to get the author's email. Default current comment.
 * @return string The current comment author's email
 */
function get_comment_author_email($comment_ID = 0)
{
    $comment = get_comment($comment_ID);
    /**
     * Filter the comment author's returned email address.
     *
     * @since 1.5.0
     *
     * @param string $comment_author_email The comment author's email address.
     */
    return apply_filters('get_comment_author_email', $comment->comment_author_email);
}

WordPress Version: 3.8

/**
 * Retrieve the email of the author of the current comment.
 *
 * @since 1.5.0
 *
 * @param int $comment_ID Optional. The ID of the comment for which to get the author's email. Default current comment.
 * @return string The current comment author's email
 */
function get_comment_author_email($comment_ID = 0)
{
    $comment = get_comment($comment_ID);
    /**
     * Filter the comment author's returned email address.
     *
     * @since 1.5.0
     *
     * @param string $comment->comment_author_email The comment author's email address.
     */
    return apply_filters('get_comment_author_email', $comment->comment_author_email);
}

WordPress Version: 3.7

/**
 * Retrieve the email of the author of the current comment.
 *
 * @since 1.5.0
 *
 * @param int $comment_ID Optional. The ID of the comment for which to get the author's email. Default current comment.
 * @return string The current comment author's email
 */
function get_comment_author_email($comment_ID = 0)
{
    $comment = get_comment($comment_ID);
    /**
     * Filter the comment author's returned email address.
     *
     * @since 1.5.2
     *
     * @param string $comment->comment_author_email The comment author's email address.
     */
    return apply_filters('get_comment_author_email', $comment->comment_author_email);
}