get_comment_author_email_link

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

WordPress Version: 6.3

/**
 * Returns the HTML email link to the author of the current comment.
 *
 * Care should be taken to protect the email address and assure that email
 * harvesters do not capture your commenter's email address. Most assume that
 * their email address will not appear in raw form on the site. Doing so will
 * enable anyone, including those that people don't want to get the email
 * address and use it for their own means good and bad.
 *
 * @since 2.7.0
 * @since 4.6.0 Added the `$comment` parameter.
 *
 * @param string         $link_text Optional. Text to display instead of the comment author's email address.
 *                                  Default empty.
 * @param string         $before    Optional. Text or HTML to display before the email link. Default empty.
 * @param string         $after     Optional. Text or HTML to display after the email link. Default empty.
 * @param int|WP_Comment $comment   Optional. Comment ID or WP_Comment object. Default is the current comment.
 * @return string HTML markup for the comment author email link. By default, the email address is obfuscated
 *                via the {@see 'comment_email'} filter with antispambot().
 */
function get_comment_author_email_link($link_text = '', $before = '', $after = '', $comment = null)
{
    $comment = get_comment($comment);
    /**
     * Filters the comment author's email for display.
     *
     * Care should be taken to protect the email address and assure that email
     * harvesters do not capture your commenter's email address.
     *
     * @since 1.2.0
     * @since 4.1.0 The `$comment` parameter was added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param WP_Comment $comment              The comment object.
     */
    $comment_author_email = apply_filters('comment_email', $comment->comment_author_email, $comment);
    if (!empty($comment_author_email) && '@' !== $comment_author_email) {
        $display = ('' !== $link_text) ? $link_text : $comment_author_email;
        $comment_author_email_link = $before . sprintf('<a href="%1$s">%2$s</a>', esc_url('mailto:' . $comment_author_email), esc_html($display)) . $after;
        return $comment_author_email_link;
    } else {
        return '';
    }
}

WordPress Version: 5.5

/**
 * Returns the HTML email link to the author of the current comment.
 *
 * Care should be taken to protect the email address and assure that email
 * harvesters do not capture your commenter's email address. Most assume that
 * their email address will not appear in raw form on the site. Doing so will
 * enable anyone, including those that people don't want to get the email
 * address and use it for their own means good and bad.
 *
 * @since 2.7.0
 * @since 4.6.0 Added the `$comment` parameter.
 *
 * @param string         $linktext Optional. Text to display instead of the comment author's email address.
 *                                 Default empty.
 * @param string         $before   Optional. Text or HTML to display before the email link. Default empty.
 * @param string         $after    Optional. Text or HTML to display after the email link. Default empty.
 * @param int|WP_Comment $comment  Optional. Comment ID or WP_Comment object. Default is the current comment.
 * @return string HTML markup for the comment author email link. By default, the email address is obfuscated
 *                via the {@see 'comment_email'} filter with antispambot().
 */
function get_comment_author_email_link($linktext = '', $before = '', $after = '', $comment = null)
{
    $comment = get_comment($comment);
    /**
     * Filters the comment author's email for display.
     *
     * Care should be taken to protect the email address and assure that email
     * harvesters do not capture your commenter's email address.
     *
     * @since 1.2.0
     * @since 4.1.0 The `$comment` parameter was added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param WP_Comment $comment              The comment object.
     */
    $email = apply_filters('comment_email', $comment->comment_author_email, $comment);
    if (!empty($email) && '@' !== $email) {
        $display = ('' !== $linktext) ? $linktext : $email;
        $return = $before;
        $return .= sprintf('<a href="%1$s">%2$s</a>', esc_url('mailto:' . $email), esc_html($display));
        $return .= $after;
        return $return;
    } else {
        return '';
    }
}

WordPress Version: 5.4

/**
 * Returns the HTML email link to the author of the current comment.
 *
 * Care should be taken to protect the email address and assure that email
 * harvesters do not capture your commenter's email address. Most assume that
 * their email address will not appear in raw form on the site. Doing so will
 * enable anyone, including those that people don't want to get the email
 * address and use it for their own means good and bad.
 *
 * @since 2.7.0
 * @since 4.6.0 Added the `$comment` parameter.
 *
 * @param string         $linktext Optional. Text to display instead of the comment author's email address.
 *                                 Default empty.
 * @param string         $before   Optional. Text or HTML to display before the email link. Default empty.
 * @param string         $after    Optional. Text or HTML to display after the email link. Default empty.
 * @param int|WP_Comment $comment  Optional. Comment ID or WP_Comment object. Default is the current comment.
 * @return string HTML markup for the comment author email link. By default, the email address is obfuscated
 *                via the {@see 'comment_email'} filter with antispambot().
 */
function get_comment_author_email_link($linktext = '', $before = '', $after = '', $comment = null)
{
    $comment = get_comment($comment);
    /**
     * Filters the comment author's email for display.
     *
     * Care should be taken to protect the email address and assure that email
     * harvesters do not capture your commenter's email address.
     *
     * @since 1.2.0
     * @since 4.1.0 The `$comment` parameter was added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param WP_Comment $comment              The comment object.
     */
    $email = apply_filters('comment_email', $comment->comment_author_email, $comment);
    if (!empty($email) && '@' !== $email) {
        $display = ('' != $linktext) ? $linktext : $email;
        $return = $before;
        $return .= sprintf('<a href="%1$s">%2$s</a>', esc_url('mailto:' . $email), esc_html($display));
        $return .= $after;
        return $return;
    } else {
        return '';
    }
}

WordPress Version: 5.2

/**
 * Return the html email link to the author of the current comment.
 *
 * Care should be taken to protect the email address and assure that email
 * harvesters do not capture your commenter's email address. Most assume that
 * their email address will not appear in raw form on the site. Doing so will
 * enable anyone, including those that people don't want to get the email
 * address and use it for their own means good and bad.
 *
 * @since 2.7.0
 * @since 4.6.0 Added the `$comment` parameter.
 *
 * @param string         $linktext Optional. Text to display instead of the comment author's email address.
 *                                 Default empty.
 * @param string         $before   Optional. Text or HTML to display before the email link. Default empty.
 * @param string         $after    Optional. Text or HTML to display after the email link. Default empty.
 * @param int|WP_Comment $comment  Optional. Comment ID or WP_Comment object. Default is the current comment.
 * @return string HTML markup for the comment author email link. By default, the email address is obfuscated
 *                via the {@see 'comment_email'} filter with antispambot().
 */
function get_comment_author_email_link($linktext = '', $before = '', $after = '', $comment = null)
{
    $comment = get_comment($comment);
    /**
     * Filters the comment author's email for display.
     *
     * Care should be taken to protect the email address and assure that email
     * harvesters do not capture your commenter's email address.
     *
     * @since 1.2.0
     * @since 4.1.0 The `$comment` parameter was added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param WP_Comment $comment              The comment object.
     */
    $email = apply_filters('comment_email', $comment->comment_author_email, $comment);
    if (!empty($email) && $email != '@') {
        $display = ($linktext != '') ? $linktext : $email;
        $return = $before;
        $return .= sprintf('<a href="%1$s">%2$s</a>', esc_url('mailto:' . $email), esc_html($display));
        $return .= $after;
        return $return;
    } else {
        return '';
    }
}

WordPress Version: 4.6

/**
 * Return the html email link to the author of the current comment.
 *
 * Care should be taken to protect the email address and assure that email
 * harvesters do not capture your commentors' email address. Most assume that
 * their email address will not appear in raw form on the site. Doing so will
 * enable anyone, including those that people don't want to get the email
 * address and use it for their own means good and bad.
 *
 * @since 2.7.0
 * @since 4.6.0 Added the `$comment` parameter.
 *
 * @param string         $linktext Optional. Text to display instead of the comment author's email address.
 *                                 Default empty.
 * @param string         $before   Optional. Text or HTML to display before the email link. Default empty.
 * @param string         $after    Optional. Text or HTML to display after the email link. Default empty.
 * @param int|WP_Comment $comment  Optional. Comment ID or WP_Comment object. Default is the current comment.
 * @return string HTML markup for the comment author email link. By default, the email address is obfuscated
 *                via the {@see 'comment_email'} filter with antispambot().
 */
function get_comment_author_email_link($linktext = '', $before = '', $after = '', $comment = null)
{
    $comment = get_comment($comment);
    /**
     * Filters the comment author's email for display.
     *
     * Care should be taken to protect the email address and assure that email
     * harvesters do not capture your commenter's email address.
     *
     * @since 1.2.0
     * @since 4.1.0 The `$comment` parameter was added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param WP_Comment $comment              The comment object.
     */
    $email = apply_filters('comment_email', $comment->comment_author_email, $comment);
    if (!empty($email) && $email != '@') {
        $display = ($linktext != '') ? $linktext : $email;
        $return = $before;
        $return .= sprintf('<a href="%1$s">%2$s</a>', esc_url('mailto:' . $email), esc_html($display));
        $return .= $after;
        return $return;
    } else {
        return '';
    }
}

WordPress Version: 4.5

/**
 * Return the html email link to the author of the current comment.
 *
 * Care should be taken to protect the email address and assure that email
 * harvesters do not capture your commentors' email address. Most assume that
 * their email address will not appear in raw form on the site. Doing so will
 * enable anyone, including those that people don't want to get the email
 * address and use it for their own means good and bad.
 *
 * @since 2.7.0
 *
 * @param string $linktext Optional. Text to display instead of the comment author's email address.
 *                         Default empty.
 * @param string $before   Optional. Text or HTML to display before the email link. Default empty.
 * @param string $after    Optional. Text or HTML to display after the email link. Default empty.
 * @return string
 */
function get_comment_author_email_link($linktext = '', $before = '', $after = '')
{
    $comment = get_comment();
    /**
     * Filter the comment author's email for display.
     *
     * Care should be taken to protect the email address and assure that email
     * harvesters do not capture your commenter's email address.
     *
     * @since 1.2.0
     * @since 4.1.0 The `$comment` parameter was added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param WP_Comment $comment              The comment object.
     */
    $email = apply_filters('comment_email', $comment->comment_author_email, $comment);
    if (!empty($email) && $email != '@') {
        $display = ($linktext != '') ? $linktext : $email;
        $return = $before;
        $return .= sprintf('<a href="%1$s">%2$s</a>', esc_url('mailto:' . $email), esc_html($display));
        $return .= $after;
        return $return;
    } else {
        return '';
    }
}

WordPress Version: 4.4

/**
 * Return the html email link to the author of the current comment.
 *
 * Care should be taken to protect the email address and assure that email
 * harvesters do not capture your commentors' email address. Most assume that
 * their email address will not appear in raw form on the blog. Doing so will
 * enable anyone, including those that people don't want to get the email
 * address and use it for their own means good and bad.
 *
 * @since 2.7.0
 *
 * @param string $linktext Optional. Text to display instead of the comment author's email address.
 *                         Default empty.
 * @param string $before   Optional. Text or HTML to display before the email link. Default empty.
 * @param string $after    Optional. Text or HTML to display after the email link. Default empty.
 * @return string
 */
function get_comment_author_email_link($linktext = '', $before = '', $after = '')
{
    $comment = get_comment();
    /**
     * Filter the comment author's email for display.
     *
     * Care should be taken to protect the email address and assure that email
     * harvesters do not capture your commenter's email address.
     *
     * @since 1.2.0
     * @since 4.1.0 The `$comment` parameter was added.
     *
     * @param string     $comment_author_email The comment author's email address.
     * @param WP_Comment $comment              The comment object.
     */
    $email = apply_filters('comment_email', $comment->comment_author_email, $comment);
    if (!empty($email) && $email != '@') {
        $display = ($linktext != '') ? $linktext : $email;
        $return = $before;
        $return .= sprintf('<a href="%1$s">%2$s</a>', esc_url('mailto:' . $email), esc_html($display));
        $return .= $after;
        return $return;
    } else {
        return '';
    }
}

WordPress Version: 4.3

/**
 * Return the html email link to the author of the current comment.
 *
 * Care should be taken to protect the email address and assure that email
 * harvesters do not capture your commentors' email address. Most assume that
 * their email address will not appear in raw form on the blog. Doing so will
 * enable anyone, including those that people don't want to get the email
 * address and use it for their own means good and bad.
 *
 * @global object $comment The current Comment row object.
 *
 * @since 2.7.0
 *
 * @param string $linktext Optional. Text to display instead of the comment author's email address.
 *                         Default empty.
 * @param string $before   Optional. Text or HTML to display before the email link. Default empty.
 * @param string $after    Optional. Text or HTML to display after the email link. Default empty.
 * @return string
 */
function get_comment_author_email_link($linktext = '', $before = '', $after = '')
{
    global $comment;
    /**
     * Filter the comment author's email for display.
     *
     * Care should be taken to protect the email address and assure that email
     * harvesters do not capture your commenter's email address.
     *
     * @since 1.2.0
     * @since 4.1.0 The `$comment` parameter was added.
     *
     * @param string $comment_author_email The comment author's email address.
     * @param object $comment              The comment object.
     */
    $email = apply_filters('comment_email', $comment->comment_author_email, $comment);
    if (!empty($email) && $email != '@') {
        $display = ($linktext != '') ? $linktext : $email;
        $return = $before;
        $return .= "<a href='mailto:{$email}'>{$display}</a>";
        $return .= $after;
        return $return;
    } else {
        return '';
    }
}

WordPress Version: 4.1

/**
 * Return the html email link to the author of the current comment.
 *
 * Care should be taken to protect the email address and assure that email
 * harvesters do not capture your commentors' email address. Most assume that
 * their email address will not appear in raw form on the blog. Doing so will
 * enable anyone, including those that people don't want to get the email
 * address and use it for their own means good and bad.
 *
 * @global object $comment The current Comment row object.
 *
 * @since 2.7.0
 *
 * @param string $linktext Optional. Text to display instead of the comment author's email address.
 *                         Default empty.
 * @param string $before   Optional. Text or HTML to display before the email link. Default empty.
 * @param string $after    Optional. Text or HTML to display after the email link. Default empty.
 */
function get_comment_author_email_link($linktext = '', $before = '', $after = '')
{
    global $comment;
    /**
     * Filter the comment author's email for display.
     *
     * Care should be taken to protect the email address and assure that email
     * harvesters do not capture your commenter's email address.
     *
     * @since 1.2.0
     * @since 4.1.0 The `$comment` parameter was added.
     *
     * @param string $comment_author_email The comment author's email address.
     * @param object $comment              The comment object.
     */
    $email = apply_filters('comment_email', $comment->comment_author_email, $comment);
    if (!empty($email) && $email != '@') {
        $display = ($linktext != '') ? $linktext : $email;
        $return = $before;
        $return .= "<a href='mailto:{$email}'>{$display}</a>";
        $return .= $after;
        return $return;
    } else {
        return '';
    }
}

WordPress Version: 3.9

/**
 * Return the html email link to the author of the current comment.
 *
 * Care should be taken to protect the email address and assure that email
 * harvesters do not capture your commentors' email address. Most assume that
 * their email address will not appear in raw form on the blog. Doing so will
 * enable anyone, including those that people don't want to get the email
 * address and use it for their own means good and bad.
 *
 * @global object $comment The current Comment row object.
 *
 * @since 2.7.0
 *
 * @param string $linktext Optional. Text to display instead of the comment author's email address.
 *                         Default empty.
 * @param string $before   Optional. Text or HTML to display before the email link. Default empty.
 * @param string $after    Optional. Text or HTML to display after the email link. Default empty.
 */
function get_comment_author_email_link($linktext = '', $before = '', $after = '')
{
    global $comment;
    /**
     * Filter the comment author's email for display.
     *
     * Care should be taken to protect the email address and assure that email
     * harvesters do not capture your commenters' email address.
     *
     * @since 1.2.0
     *
     * @param string $comment_author_email The comment author's email address.
     */
    $email = apply_filters('comment_email', $comment->comment_author_email);
    if (!empty($email) && $email != '@') {
        $display = ($linktext != '') ? $linktext : $email;
        $return = $before;
        $return .= "<a href='mailto:{$email}'>{$display}</a>";
        $return .= $after;
        return $return;
    } else {
        return '';
    }
}

WordPress Version: 3.8

/**
 * Return the html email link to the author of the current comment.
 *
 * Care should be taken to protect the email address and assure that email
 * harvesters do not capture your commentors' email address. Most assume that
 * their email address will not appear in raw form on the blog. Doing so will
 * enable anyone, including those that people don't want to get the email
 * address and use it for their own means good and bad.
 *
 * @global object $comment The current Comment row object.
 *
 * @since 2.7
 *
 * @param string $linktext Optional. The text to display instead of the comment author's email address. Default empty.
 * @param string $before   Optional. The text or HTML to display before the email link. Default empty.
 * @param string $after    Optional. The text or HTML to display after the email link. Default empty.
 */
function get_comment_author_email_link($linktext = '', $before = '', $after = '')
{
    global $comment;
    /**
     * Filter the comment author's email for display.
     *
     * Care should be taken to protect the email address and assure that email
     * harvesters do not capture your commentors' email address.
     *
     * @since 1.2.0
     *
     * @param string $comment->comment_author_email The comment author's email address.
     */
    $email = apply_filters('comment_email', $comment->comment_author_email);
    if (!empty($email) && $email != '@') {
        $display = ($linktext != '') ? $linktext : $email;
        $return = $before;
        $return .= "<a href='mailto:{$email}'>{$display}</a>";
        $return .= $after;
        return $return;
    } else {
        return '';
    }
}

WordPress Version: 3.7

/**
 * Return the html email link to the author of the current comment.
 *
 * Care should be taken to protect the email address and assure that email
 * harvesters do not capture your commentors' email address. Most assume that
 * their email address will not appear in raw form on the blog. Doing so will
 * enable anyone, including those that people don't want to get the email
 * address and use it for their own means good and bad.
 *
 * @global object $comment The current Comment row object.
 *
 * @since 2.7
 *
 * @param string $linktext Optional. The text to display instead of the comment author's email address. Default empty.
 * @param string $before   Optional. The text or HTML to display before the email link. Default empty.
 * @param string $after    Optional. The text or HTML to display after the email link. Default empty.
 */
function get_comment_author_email_link($linktext = '', $before = '', $after = '')
{
    global $comment;
    /**
     * Filter the comment author's email for display.
     *
     * Care should be taken to protect the email address and assure that email
     * harvesters do not capture your commentors' email address.
     *
     * @since 1.2.1
     *
     * @param string $comment->comment_author_email The comment author's email address.
     */
    $email = apply_filters('comment_email', $comment->comment_author_email);
    if (!empty($email) && $email != '@') {
        $display = ($linktext != '') ? $linktext : $email;
        $return = $before;
        $return .= "<a href='mailto:{$email}'>{$display}</a>";
        $return .= $after;
        return $return;
    } else {
        return '';
    }
}