get_post_reply_link() — описание функции WordPress на русском

Сигнатура

get_post_reply_link( array $args = array(), int|WP_Post $post = null ): string|false

Описание

Получает HTML-содержимое для ссылки «ответить на запись».

Параметры

$args array необязательный = array()

Переопределяет аргументы по умолчанию. add_below stringПервая часть селектора, используемого для определения комментария, под которым размещается ответ. Итоговое значение передаётся как первый параметр в addComment.moveForm() и объединяется в виде $add_below-$comment->comment_ID. По умолчанию 'post'. respond_id stringСелектор, определяющий комментарий, на который отвечают. Передаётся как третий параметр в addComment.moveForm() и добавляется к URL ссылки в виде значения-хэша. По умолчанию 'respond'. reply_text stringТекст ссылки «Ответить». По умолчанию ‘Leave a Comment’. login_text stringТекст ссылки для ответа, если пользователь не авторизован. По умолчанию ‘Log in to leave a Comment’. before stringТекст или HTML, добавляемый перед ссылкой на ответ. after stringТекст или HTML, добавляемый после ссылки на ответ.

$post int|WP_Post необязательный = null

ID записи или объект WP_Post, на котором будет отображён комментарий. По умолчанию — текущая запись.

Возвращаемое значение

string|false

Исходный код

wp-includes/comment-template.php:1915

function get_post_reply_link( $args = array(), $post = null ) {
	$defaults = array(
		'add_below'  => 'post',
		'respond_id' => 'respond',
		'reply_text' => __( 'Leave a Comment' ),
		'login_text' => __( 'Log in to leave a Comment' ),
		'before'     => '',
		'after'      => '',
	);

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

	$post = get_post( $post );

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

	if ( get_option( 'comment_registration' ) && ! is_user_logged_in() ) {
		$link = sprintf(
			'<a rel="nofollow" class="comment-reply-login" href="%s">%s</a>',
			wp_login_url( get_permalink() ),
			$args['login_text']
		);
	} else {
		$onclick = sprintf(
			'return addComment.moveForm( "%1$s-%2$s", "0", "%3$s", "%2$s" )',
			$args['add_below'],
			$post->ID,
			$args['respond_id']
		);

		$link = sprintf(
			"<a rel='nofollow' class='comment-reply-link' href='%s' onclick='%s'>%s</a>",
			get_permalink( $post->ID ) . '#' . $args['respond_id'],
			$onclick,
			$args['reply_text']
		);
	}

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

	/**
	 * Filters the formatted post comments link HTML.
	 *
	 * @since 2.7.0
	 *
	 * @param string      $post_reply_link The HTML-formatted post comments link.
	 * @param int|WP_Post $post            The post ID or WP_Post object.
	 */
	return apply_filters( 'post_comments_link', $post_reply_link, $post );
}

История изменений

Версия	Описание
2.7.0	Introduced.