get_previous_posts_link() │ WP 2.7.0

Отримує HTML-посилання ( <a> ) на сторінку з попередніми постами (свіжіші пости).

Оскільки пости у WordPress виводяться у зворотному хронологічному порядку

Так як пости зазвичай сортуються у зворотному хронологічному порядку (пізні пости показуються раніше), get_next_posts_link() , яка направляє на минулі пости.

Працює на основі:
previous_posts() ,
get_previous_posts_page_link()

Основа для:
get_posts_nav_link() ,
get_the_posts_navigation() ,
previous_posts_link()

Хуки з функції

previous_posts_link_attributes

Повертає

Строку|null. Посилання на групу попередніх постів у пагінації.

Використання

get_previous_posts_link($label);

$label (рядок): Текст посилання.

За замовчуванням: __( ‘Previous Page’ )

Приклади

#1 Запишемо посилання на попередні пости в змінну і виведемо її на екран

<?php
$prev = get_previous_posts_link();
echo $prev;
?>

нотатки

Global. int. $paged

список змін

З версії 2.7.0

Введено.

Код `get_previous_posts_link() get previous posts link` ^{WP 6.0.2}

wp-includes/link-template.php

function get_previous_posts_link( $label = null ) {
	global $paged;

	if ( null === $label ) {
		$label = __( '« Previous Page' );
	}

	if ( ! is_single() && $paged > 1 ) {
		/**
		 * Filters anchor tag atributes for previous posts page link.
		 *
		 * @ Since 2.7.0
		 *
		 * @param string $attributes Attributes for the anchor tag.
		 */
		$attr = apply_filters( 'previous_posts_link_attributes', '' );
		return '<a href="' . previous_posts( false ) . ""$attr>" . preg_replace( '/&([^#])(?![az]{1,8};)/i', '&$1', $label ) . '</a>';
	}
}