wordpress / latest / functions / get_comment_author.html

get_comment_author( int|WP_Comment $comment_ID ): string

Retrieves the author of the current comment.

Description

If the comment has an empty comment_author field, then ‘Anonymous’ person is assumed.

Parameters

$comment_ID int|WP_Comment Optional
WP_Comment or the ID of the comment for which to retrieve the author.
Default current comment.

Return

string The comment author

Source

File: wp-includes/comment-template.php. View all references

function get_comment_author( $comment_ID = 0 ) {
	$comment    = get_comment( $comment_ID );
	$comment_ID = ! empty( $comment->comment_ID ) ? $comment->comment_ID : $comment_ID;

	if ( empty( $comment->comment_author ) ) {
		$user = ! empty( $comment->user_id ) ? get_userdata( $comment->user_id ) : false;
		if ( $user ) {
			$author = $user->display_name;
		} else {
			$author = __( 'Anonymous' );
		}
	} else {
		$author = $comment->comment_author;
	}

	/**
	 * Filters the returned comment author name.
	 *
	 * @since 1.5.0
	 * @since 4.1.0 The `$comment_ID` and `$comment` parameters were added.
	 *
	 * @param string     $author     The comment author's username.
	 * @param string     $comment_ID The comment ID as a numeric string.
	 * @param WP_Comment $comment    The comment object.
	 */
	return apply_filters( 'get_comment_author', $author, $comment_ID, $comment );
}

Hooks

Uses

Uses Description

Used By

Used By Description

Changelog

Version Description
4.4.0 Added the ability for $comment_ID to also accept a WP_Comment object.
1.5.0 Introduced.

© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_comment_author