wp_link_pages

<?php wp_link_pages( $args ); ?>

Функция wp_link_pages() определена в файле wp-includes/post-template.php и выводит ссылки на страницы, на которые запись разделена псевдотегом <!--nextpage-->. (Она заменила устаревшую функцию link_pages(), которая имела аналогичные но нестроковые параметры.)

Подробнее: Разделение записи блога на части с помощью more, noteaser и nextpage

Параметры:

• before: текст перед всеми ссылками
• after: текст после всех ссылок
• link_before: текст перед текстом ссылки (с версии WordPress 2.7)
• link_after: текст после текста ссылки (с версии WordPress 2.7)
• next_or_number: переключатель на вывод номеров страниц ('number', по умолчанию) или ссылок на предыдущую и следующую страницы ('next')
• nextpagelink: текст для ссылки на следующую страницу
• previouspagelink: текст для ссылки на следующую страницу
• pagelink: строка форматирования ссылки с номером страницы ( номер страницы заменяет " %")
• more_file: Страница, на которую указывают ссылки (по умолчанию это текущая страница)
• echo: переключатель на вывод результата (1 или 'true', по умолчанию) или возврат результата (0 или 'false') .

По умолчанию

  <?php $args = array(
  'before'           => '<p>' . __('Pages:'),
  'after'            => '</p>',
  'link_before'      => ,
  'link_after'       => ,
  'next_or_number'   => 'number',
  'nextpagelink'     => __('Next page'),
  'previouspagelink' => __('Previous page'),
  'pagelink'         => '%',
  'more_file'        => ,
  'echo'             => 1 ); ?>

и ссылки на страницы выводятся в виде "Page 1, 2, 3"

Примеры задания параметров:

1. В виде списка с разделителем & (амперсанд)

Пример добавления CSS-стиля и изменения текста ссылки на страницу:

<div class="pagelink"><?php wp_link_pages('before="" &pagelink=Страница %'); ?></div>

Будут выведены ссылки с заданным стилем

Страница 1 Страница 2 Страница 3

Или можно добавить теги как текст до и после ссылок:

<?php wp_link_pages('before=<div id="page-links">&after=</div>'); ?>

2. В виде масива

Чтобы вставить символы, при задании которых используется амперсанд, параметры нужно задавать как массив.

Пример вывода ссылок на предыдущую и следующую страницы:

<?php wp_link_pages(array('before'=>'Страницы',
                          'next_or_number'=>'next',
                          'previouspagelink' => ' &laquo; ',
                          'nextpagelink'=>' &raquo;')); ?>

Получаем:

Страницы: « »