get_comment_text( int|WP_Comment $comment_ID, array $args = array() )

Retrieves the text of the current comment.


Description Description

See also See also


Top ↑

Parameters Parameters

$comment_ID

(int|WP_Comment) (Required) WP_Comment or ID of the comment for which to get the text. Default current comment.

$args

(array) (Optional) An array of arguments.

Default value: array()


Top ↑

Return Return

(string) The comment content.


Top ↑

Source Source

File: wp-includes/comment-template.php

function get_comment_text( $comment_ID = 0, $args = array() ) {
	$comment = get_comment( $comment_ID );

	$comment_content = $comment->comment_content;

	if ( is_comment_feed() && $comment->comment_parent ) {
		$parent = get_comment( $comment->comment_parent );
		if ( $parent ) {
			$parent_link = esc_url( get_comment_link( $parent ) );
			$name        = get_comment_author( $parent );

			$comment_content = sprintf(
				/* translators: %s: Comment link. */
				ent2ncr( __( 'In reply to %s.' ) ),
				'<a href="' . $parent_link . '">' . $name . '</a>'
			) . "\n\n" . $comment_content;
		}
	}

	/**
	 * Filters the text of a comment.
	 *
	 * @since 1.5.0
	 *
	 * @see Walker_Comment::comment()
	 *
	 * @param string     $comment_content Text of the comment.
	 * @param WP_Comment $comment         The comment object.
	 * @param array      $args            An array of arguments.
	 */
	return apply_filters( 'get_comment_text', $comment_content, $comment, $args );
}


Top ↑

Changelog Changelog

Changelog
Version Description
5.4.0 Added 'In reply to %s.' prefix to child comments in comments feed.
4.4.0 Added the ability for $comment_ID to also accept a WP_Comment object.
1.5.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by MakeWebBetter

    Change comment texts of specific comments

    /**
     * For comments with ID 723 or 15
     */
    add_filter( 'get_comment_text', 'change_org_comment', 10, 2 );
    
    function wpdocs_comment( $text_content, WP_Comment $com ) {
        if ( ! is_admin() && in_array( $com->comment_ID, array( 723, 15 ) ) ) {
            $text_content = __( 'You\'ve Just Been Erased!' );
        }
    
        return $text_content;
    }
    

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