get_previous_comments_link() │ WP 2.7.1

Получает ссылку (тег A) на предыдущую страницу комментариев. Должна использоваться на странице записи.

Чтобы получить ссылку на следующую страницу комментариев, используйте get_next_comments_link()

Работает на основе: get_comments_pagenum_link()
Основа для: get_the_comments_navigation(), previous_comments_link()
1 раз — 0.00019 сек (быстро) | 50000 раз — 2.7 сек (быстро)
Хуки из функции

Возвращает

Строку|null. Если ссылка есть вернет HTML код ссылки (тег А).

Использование

get_previous_comments_link( $label );
$label(строка)
Текст ссылки
По умолчанию: '' (← Предыдущие комментарии)

Примеры

0

#1 Получим ссылку на предыдущую страницу комментариев текущей записи

Допустим у записи 44 наукометрия и мы находимся на второй странице комментариев, тогда:

$prev_link = get_previous_comments_link();

/* $link будет равно
<a href="http://example.com/foo/comment-page-1#comments" >← Предыдущие комментарии</a>
*/

Список изменений

С версии 2.7.1 Введена.
С версии 6.7.0 Added the page parameter.

Код get_previous_comments_link() WP 6.7.2

wp-includes/link-template.php 
function get_previous_comments_link( $label = '', $page = null ) {
	if ( ! is_singular() ) {
		return;
	}

	if ( is_null( $page ) ) {
		$page = get_query_var( 'cpage' );
	}

	if ( (int) $page <= 1 ) {
		return;
	}

	$previous_page = (int) $page - 1;

	if ( empty( $label ) ) {
		$label = __( '&laquo; Older Comments' );
	}

	/**
	 * Filters the anchor tag attributes for the previous comments page link.
	 *
	 * @since 2.7.0
	 *
	 * @param string $attributes Attributes for the anchor tag.
	 */
	$attr = apply_filters( 'previous_comments_link_attributes', '' );

	return sprintf(
		'<a href="%1$s" %2$s>%3$s</a>',
		esc_url( get_comments_pagenum_link( $previous_page ) ),
		$attr,
		preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label )
	);
}

Пагинация комментариев (навигация)

link ссылка (HTML тег A)

Комментарии