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

Retrieves the text of the current comment.

Contents

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 );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/formatting.php: esc_url()

Checks and cleans a URL.
wp-includes/formatting.php: ent2ncr()

Converts named entities into numbered entities.
wp-includes/query.php: is_comment_feed()

Is the query for a comments feed?
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.
wp-includes/comment-template.php: get_comment_link()

Retrieves the link to a given comment.
wp-includes/comment-template.php: get_comment_text

Filters the text of a comment.
wp-includes/comment-template.php: get_comment_author()

Retrieves the author of the current comment.
wp-includes/comment.php: get_comment()

Retrieves comment data given a comment ID or comment object.
Show 4 more uses Hide more uses

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
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
    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.