WordPress开发手册:get_comment_author_email_link()

函数原型

get_comment_author_email_link( string $linktext = ”, string $before = ”, string $after = ”, int|WP_Comment $comment = null ): string

函数描述

是否弃用

未弃用

函数参数

$linktext
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 link.

Default: ''

$after
string
Optional

Text or HTML to display after the email link.

Default: ''

$comment
int|WP_Comment
Optional

Comment ID or WP_Comment object. Default is the current comment.

Default: null

函数返回值

函数位置

函数源码

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
Github

变更日志