posts_nav_link

Выводит ссылки на предыдущую и следующую страницы (посты/категории). Может пригодится для того, чтобы снабдить архивы ссылками навигации.

Чтобы получить ссылки на предыдущий/следующий посты в отдельности используйте функции: next_post_link() и previous_post_link().

Хуков нет.

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

<?php posts_nav_link( $sep, $prelabel, $nextlabel ); ?>
$sep(строка)
Текст отображаемый между ссылок.
По умолчанию: ‘ — ‘
$prelabel(строка)
Текст (анкор) ссылки для предыдущего поста.
По умолчанию: __(‘« Previous Page’)
$nxtlabel(строка)
Текст (анкор) ссылки для следующего поста.
По умолчанию: __(‘Next Page »’)

Примеры

#1 HTML который выводит функция

<?php 
posts_nav_link( 
	' ', 
	'<img src="' . get_stylesheet_directory_uri() . '/images/prev.jpg" />', 
	'<img src="' . get_stylesheet_directory_uri() . '/images/next.jpg" />' 
); 
?>

Код из


wp-includes/link-template.php

WP 4.7.2

<?php
function posts_nav_link( $sep = '', $prelabel = '', $nxtlabel = '' ) {
	$args = array_filter( compact('sep', 'prelabel', 'nxtlabel') );
	echo get_posts_nav_link($args);
}