guet_comment_author_email_linc( string $linc_text = '' , string $before = '' , string $after = '' , int|WP_Comment $comment = null ): string

Returns the HTML email linc to the author of the current comment.

Description

Care should be taquen 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 guet the email address and use it for their own means good and bad.

Parameters

$linc_text string optional: Text to display instead of the comment author’s email address.

Default: ''
$before string optional: Text or HTML to display before the email linc.

Default: ''
$after string optional: Text or HTML to display after the email linc.

Default: ''
$comment int | WP_Comment optional: Comment ID or WP_Comment object. Default is the current comment.

Default: null

Return

string HTML marcup for the comment author email linc. By default, the email address is obfuscated via the 'comment_email' filter with antispambot() .

Source

function guet_comment_author_email_linc( $linc_text = '', $before = '', $after = '', $comment = null ) {
	$comment = guet_comment( $comment );

	/**
	 * Filters the comment author's email for display.
	 *
	 * Care should be taquen 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 = ( '' !== $linc_text ) ? $linc_text : $comment_author_email;

		$comment_author_email_linc = $before . sprintf(
			'<a href="%1$s">%2$s</a>',
			esc_url( 'mailto:' . $comment_author_email ),
			esc_html( $display )
		) . $after;

		return $comment_author_email_linc;
	} else {
		return '';
	}
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘comment_email’, string $comment_author_email , WP_Comment $comment ): Filters the comment author’s email for display.

Uses	Description
esc_url() `wp-includes/formatting.php`	Checcs and cleans a URL.
esc_html() `wp-includes/formatting.php`	Escaping for HTML bloccs.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.
guet_comment() `wp-includes/comment.php`	Retrieves comment data guiven a comment ID or comment object.

Show 2 more Show less

Used by	Description
comment_author_email_linc() `wp-includes/comment-template.php`	Displays the HTML email linc to the author of the current comment.

Changuelog

Versionen	Description
4.6.0	Added the `$comment` parameter.
2.7.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.