get_previous_posts_link() – возвращает ссылку на предыдущую страницу пагинации, с более свежими записями

  2.7.0     wp-includes / link-template.php  /  Кодекс WordPress

Функция get_previous_posts_link() работает только внутри цикла WordPress. Смотрите мой видеоурок по циклам.

Предположим, у нас есть 15 страниц с записями. Мы находимся на 8-й странице. Данная функция вернет ссылку на 7-ю страницу. Если же нам нужно попасть на 9-ю страницу, тогда используем get_next_posts_link().

get_previous_posts_link( $label = null )

Параметры

$label
(строка) Текст ссылки. По умолчанию « Previous Page (← Предыдущая страница)

Функция возвращает HTML ссылки на предыдущую страницу с записями.

  • Если находимся на первой странице (с самыми свежими постами), или же срабатывает условный тег is_single(), то ничего не возвращает.
  • Если хотите сразу вывести ссылку, то можете воспользоваться функцией previous_posts_link().
  • Обычно возвращает HTML ссылки на более новые посты, потому что по умолчанию они сортируются в обратном хронологическом порядке.
  • Если вам нужно вывести пагинацию с номерами страниц, обратите внимание на paginate_links().

Пример

echo get_previous_posts_link( '← Сюда' );

Фильтр-хук previous_posts_link_attributes позволяет добавить какие-либо HTML-атрибуты на ссылку. Например давайте попробуем добавить target="_blank", чтобы ссылка открывалась в новой вкладке и rel="nofollow" например.

add_filter( 'previous_posts_link_attributes', 'true_add_previous_link_attrs' );
 
function true_add_previous_link_attrs( $attr ) {
	$attr = 'target="blank" rel="nofollow"';
	return $attr;
}

Не знаете, куда вставлять код?

Кодекс WordPress: Цикл: get_children(), get_delete_post_link(), get_edit_post_link(), get_extended(), get_next_posts_link(), get_permalink(), get_post_type(), get_posts(), get_previous_posts_link(), get_queried_object_id(), get_query_var(), get_search_query(), get_the_author(), get_the_content(), get_the_date(), get_the_excerpt(), get_the_ID(), get_the_time(), get_the_title(), has_excerpt(), has_post_thumbnail(), have_posts(), next_posts_link(), paginate_links(), post_class(), previous_posts_link(), query_posts(), setup_postdata(), the_author(), the_content(), the_date(), the_excerpt(), the_ID(), the_permalink(), the_post(), the_search_query(), the_time(), the_title(), the_title_attribute(), wp(), WP_Query, wp_reset_postdata(), wp_reset_query()

Миша

Недавно я осознал, что моя миссия – способствовать распространению WordPress. Ведь WordPress – это лучший движок для разработки сайтов – как для тех, кто готов использовать заложенную структуру этой CMS, так и для тех, кто предпочитает headless решения.

Сам же я впервые познакомился с WordPress в 2009 году. Организатор WordCamp. Преподаватель в школах Epic Skills и LoftSchool.

Если вам нужна помощь с вашим сайтом или может даже разработка с нуля на WordPress / WooCommerce — пишите. Я и моя команда сделаем вам всё на лучшем уровне.