get_comment_reply_link() │ WP 2.7.0

Gets the link <a> that allows replying to a comment. Used in the comment loop.

If JavaScript comment-reply.js is enabled, then clicking this link will move the comment form under the comment the user wants to reply to.

Used By: comment_reply_link()
1 time — 0.000774 sec (slow) | 50000 times — 19.68 sec (slow)
Hooks from the function

Returns

String|false|null. Nothing/false/string. A link to display the comment form, in case of success. False if commenting is closed.

Usage

get_comment_reply_link( $args, $comment, $post );
$args(array)
Parameters that affect the display of the link. See below.
Default: presets
$comment(int/WP_Comment)
ID of the comment to reply to. By default, the current comment in the loop.
Starting from version 4.4, you can pass the comment object WP_Comment.
Default: null
$post(int/WP_Post)
ID or object of the post to which the comment relates. By default, the current post.
Default: null

Arguments for the $args parameter

add_below(string)
The prefix name for the comment container. By default comment, means that the form will move under the container with the attribute id="comment-23" (23 is the ID of the comment we are replying to).
Default: 'comment'
respond_id(string)
The value of the id attribute of the comment form container. That is, if respond is specified, then when clicking the link, the block with id="respond" will move (this is the comment form block).
Default: 'respond'
reply_text(string)
The text of the link.
Default: __('Reply')
login_text(string)
The text of the link that is shown when you need to log in to leave a comment.
Default: __('Log in to Reply')
depth(int)
The depth of comments for which the link will be shown. For threaded comments. If you specify, for example, 3, then for a comment with a nesting depth of 4, the link will no longer be displayed.
Default: 0
before(string)
Text or html to add before the link.
after(string)
Text or html to add after the link.
Default: array()

Examples

0

#1 Link to reply to comment

Let's display a link to reply to a comment of maximum nesting level - 5, and change the link text to "reply to comment":

$link = get_comment_reply_link( [
	'reply_text' => "reply to comment",
	'respond_id' => 'comment',
	'depth'      => 5,
	'max_depth'  => 10,
], 2881, 631 );

// here we can process the link before it is displayed on the screen
//$link = str_replace( 'foo', 'bar', $link );

echo $link;

Outputs this html code:

<a
 rel='nofollow'
 class='comment-reply-link'
 href='/function/comment_reply_link?replytocom=2881#comment'
 onclick='return addComment.moveForm( "comment-2881", "2881", "comment", "631" )'
 aria-label='Comment on Vladimir's post'
>
reply to comment
</a>

Changelog

Since 2.7.0 Introduced.
Since 4.4.0 Added the ability for $comment to also accept a WP_Comment object.

get_comment_reply_link() code WP 6.9.1

wp-includes/comment-template.php 
function get_comment_reply_link( $args = array(), $comment = null, $post = null ) {
	$defaults = array(
		'add_below'          => 'comment',
		'respond_id'         => 'respond',
		'reply_text'         => __( 'Reply' ),
		/* translators: Comment reply button text. %s: Comment author name. */
		'reply_to_text'      => __( 'Reply to %s' ),
		'login_text'         => __( 'Log in to Reply' ),
		'max_depth'          => 0,
		'depth'              => 0,
		'before'             => '',
		'after'              => '',
		'show_reply_to_text' => false,
	);

	$args = wp_parse_args( $args, $defaults );

	$args['max_depth'] = (int) $args['max_depth'];
	$args['depth']     = (int) $args['depth'];

	if ( 0 === $args['depth'] || $args['max_depth'] <= $args['depth'] ) {
		return null;
	}

	$comment = get_comment( $comment );

	if ( empty( $comment ) ) {
		return null;
	}

	if ( empty( $post ) ) {
		$post = $comment->comment_post_ID;
	}

	$post = get_post( $post );

	if ( ! comments_open( $post->ID ) ) {
		return false;
	}

	if ( get_option( 'page_comments' ) ) {
		$permalink = str_replace( '#comment-' . $comment->comment_ID, '', get_comment_link( $comment ) );
	} else {
		$permalink = get_permalink( $post->ID );
	}

	/**
	 * Filters the comment reply link arguments.
	 *
	 * @since 4.1.0
	 *
	 * @param array      $args    Comment reply link arguments. See get_comment_reply_link()
	 *                            for more information on accepted arguments.
	 * @param WP_Comment $comment The object of the comment being replied to.
	 * @param WP_Post    $post    The WP_Post object.
	 */
	$args = apply_filters( 'comment_reply_link_args', $args, $comment, $post );

	if ( get_option( 'comment_registration' ) && ! is_user_logged_in() ) {
		$link = sprintf(
			'<a rel="nofollow" class="comment-reply-login" href="%s">%s</a>',
			esc_url( wp_login_url( get_permalink() ) ),
			$args['login_text']
		);
	} else {
		$data_attributes = array(
			'commentid'      => $comment->comment_ID,
			'postid'         => $post->ID,
			'belowelement'   => $args['add_below'] . '-' . $comment->comment_ID,
			'respondelement' => $args['respond_id'],
			'replyto'        => sprintf( $args['reply_to_text'], get_comment_author( $comment ) ),
		);

		$data_attribute_string = '';

		foreach ( $data_attributes as $name => $value ) {
			$data_attribute_string .= " data-{$name}=\"" . esc_attr( $value ) . '"';
		}

		$data_attribute_string = trim( $data_attribute_string );

		$reply_text = $args['show_reply_to_text']
			? sprintf( $args['reply_to_text'], get_comment_author( $comment ) )
			: $args['reply_text'];

		$aria_label = $args['show_reply_to_text'] ? '' : sprintf( $args['reply_to_text'], get_comment_author( $comment ) );

		$link = sprintf(
			'<a rel="nofollow" class="comment-reply-link" href="%s" %s%s>%s</a>',
			esc_url(
				add_query_arg(
					array(
						'replytocom'      => $comment->comment_ID,
						'unapproved'      => false,
						'moderation-hash' => false,
					),
					$permalink
				)
			) . '#' . $args['respond_id'],
			$data_attribute_string,
			$aria_label ? ' aria-label="' . esc_attr( $aria_label ) . '"' : '',
			$reply_text
		);
	}

	$comment_reply_link = $args['before'] . $link . $args['after'];

	/**
	 * Filters the comment reply link.
	 *
	 * @since 2.7.0
	 *
	 * @param string     $comment_reply_link The HTML markup for the comment reply link.
	 * @param array      $args               An array of arguments overriding the defaults.
	 * @param WP_Comment $comment            The object of the comment being replied.
	 * @param WP_Post    $post               The WP_Post object.
	 */
	return apply_filters( 'comment_reply_link', $comment_reply_link, $args, $comment, $post );
}

Comments