WP_LINK_PAGES() ─ Функция для вывода страниц в WordPress

Функция wp_link_pages() позволяет создавать навигацию по страницам для постов, которые разбиты на страницы с помощью тега <!--nextpage-->. Она должна использоваться внутри основного цикла (The Loop).

Хуки функции

• wp_link_pages_args — настройка параметров.
• wp_link_pages_link — изменение вывода отдельных ссылок на страницы.
• wp_link_pages — фильтрация итогового HTML-кода.

Возвращаемое значение

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

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

Чтобы использовать эту функцию, вызовите wp_link_pages() и передайте ей массив или строку с параметрами.

wp_link_pages( $args );

Параметры

• $args (строка|массив) — массив или строка с параметрами (по умолчанию пустая строка).

  Параметры по умолчанию:

  • before (строка) — HTML или текст перед каждой ссылкой. По умолчанию: <p> Страницы:.
  • after (строка) — HTML или текст после каждой ссылки. По умолчанию: </p>.
  • link_before (строка) — HTML или текст перед каждой ссылкой внутри тега <a>. По умолчанию: пусто.
  • link_after (строка) — HTML или текст после каждой ссылки внутри тега <a>. По умолчанию: пусто.
  • aria_current (строка) — значение для атрибута aria-current. Возможные значения: 'page', 'step', 'location', 'date', 'time', 'true', 'false'. По умолчанию: 'page'.
  • next_or_number (строка) — определяет, использовать ли номера страниц. Возможные значения: 'number' и 'next'. По умолчанию: 'number'.
  • separator (строка) — текст между ссылками. По умолчанию: пробел.
  • nextpagelink (строка) — текст ссылки на следующую страницу. По умолчанию: 'Next Page'.
  • previouspagelink (строка) — текст ссылки на предыдущую страницу. По умолчанию: 'Previous Page'.
  • pagelink (строка) — формат строки для номеров страниц. % будет заменен на номер страницы (например, 'Page %' даст "Страница 1", "Страница 2" и т.д.). По умолчанию: %.
  • echo (boolean) — нужно ли выводить результат. Принимает 1|true или 0|false. По умолчанию: 1|true.

Примеры использования

Пример 1: Базовое использование

Выводим навигацию по страницам с настройками по умолчанию.

Пример 2: Добавление кнопки переноса страниц в визуальном редакторе

WordPress предоставляет кнопку для переноса страниц, но она не появляется по умолчанию. Мы можем добавить кнопку, используя хук. Вставьте следующий код в файл functions.php вашей темы:

add_filter('mce_buttons', 'mce_page_break');

function mce_page_break( $mce_buttons ) {
    $pos = array_search('wp_more', $mce_buttons, true);

    if( $pos !== false ) {
        $buttons = array_slice($mce_buttons, 0, $pos );
        $buttons[] = 'wp_page';
        $mce_buttons = array_merge( $buttons, array_slice($mce_buttons, $pos) );
    }

    return $mce_buttons;
}

Пример 3: Обернуть ссылки в тег <div>

Выводим ссылки на страницы, обернутые в тег <div> и изменяем текст каждой ссылки на "Страница #":

&after=