WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Теги шаблонов/posts nav link

Описание

Выводит ссылки на предыдущую и следующую страницы. Полезна для постраничной навигации на главной странице блога, на страницах рубрик и на архивных страницах.

Для вывода следующей и предыдущей страниц записи используйте next_posts_link() и previous_posts_link().

Для вывода ссылок на следующую и предыдущую записи внутри отдельной записи используйте next_post_link() и previous_post_link().

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

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

Параметры

$sep 
(string) Текст, выводимый между ссылками.
  • По умолчанию: ' :: ' в 1.2.x.
  • По умолчанию: ' — ' в 1.5.
$prelabel 
(string) Текст ссылки на предыдущую страницу.
  • По умолчанию: '<< Previous Page' в 1.2.x.
  • По умолчанию: '« Previous Page' в 1.5.
$nxtlabel 
(string) Текст ссылки на следующую страницу.
  • По умолчанию: 'Next Page >>' в 1.2.x.
  • По умолчанию: 'Next Page »' в 1.5

Примечание

Поскольку традиционно записи в блогах сортируются в обратном хронологическом порядке (первыми выводятся свежие записи), возникает некоторая путаница в определении "следующей" страницы. WordPress называет следующей страницей страницу с более ранними записями.

В WordPress версии 1.5, стандартная тема Kubrick устранила эту путаницу, заменив "следующую страницу" текстом "предыдущие записи". См. пример: Kubrick Theme Format.

Примеры

По умолчанию

По умолчанию posts_nav_link() выглядит так:

« Previous PageNext Page »
<?php posts_nav_link(); ?>

По центру

Выводит ссылки на предыдущую и следующую страницы ("previous page · next page") с выравниванием по центру.

<div style="text-align:center;">
<?php posts_nav_link(' &#183; ', 'previous page', 'next page'); ?>
</div>

С изображениями

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

Формат темы Kubrick

Навигация в темы Kubrick может выводиться указанным способом. Однако, использование posts_nav_link() может привести к нежелательным результатам. Например, к дублированию ссылок, которые будут вести на несуществующие страницы.

В действительности в теме Kubrick используются функции next_posts_link() и previous_posts_link().

Такой вариант использовать нельзя:

<div class="navigation">
<div class="alignleft"><?php posts_nav_link('','','&laquo; Previous Entries') ?></div>
<div class="alignright"><?php posts_nav_link('','Next Entries &raquo;','') ?></div>
</div>

Это лучший вариант:

<div class="navigation">
<div class="alignleft"><?php previous_posts_link('&laquo; Previous Entries') ?></div>
<div class="alignright"><?php next_posts_link('Next Entries &raquo;','') ?></div>
</div>

Настраиваемый текст ссылки

Вы можете настраивать текст для каждой ссылки, а также текст между ними.

Вы можете вернуться на предыдущую страницу или вы можете перейти на следующую страницу.
<p><?php posts_nav_link(' или ', 'Вы можете вернуться на предыдущую страницу', 'вы можете перейти на следующую страницу'); ?>.</p>


Ссылки

Схожее

See also index of Function Reference and index of Template Tags.