WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

posts_nav_link() WP 0.71

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

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

Работает на основе: get_posts_nav_link()

Хуков нет.

Возвращает

null.

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

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

Примеры

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

<?php posts_nav_link( $sep, $prelabel, $nextlabel ); ?>

Выведет:

<a href="ссылка">« Предыдущая страница</a> — <a href="ссылка">Следующая страница »</a>

#2 Чтобы отцентрировать (показать по середине страницы) используйте такой код:

<div style="text-align:center;">
	<?php posts_nav_link(' · ', 'Предыдущая страница', 'Следующая страница'); ?>
</div>

#3 В качестве анкоров ссылок можно использовать картинки, например так:

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

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

С версии 0.71 Введена.

Код posts_nav_link() WP 5.8.1

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

navigation pagination (навигация пагинация)

Архивы

Записи: посты, страницы, ...

4 коммента
    Войти