Функция wp_link_pages() в WordPress с примерами.

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

Gutenberg

Если ваш сайт использует в качестве редактора постов — билдер Gutenberg, то данная опция не будет работать. Она предназначена только для Classic Editor. Для гутенберга есть альтернатива — Page Break Block которая решает похожую задачу.

wp_link_pages( array $args = array() )

Параметры

Функция принимает массив аргументов, который может включать следующие ключи:

• before (string) – HTML, выводимый перед списком ссылок на страницы. По умолчанию пусто.
• after (string) – HTML, выводимый после списка ссылок на страницы. По умолчанию пусто.
• link_before (string) – HTML, выводимый перед каждой ссылкой на страницу. По умолчанию пусто.
• link_after (string) – HTML, выводимый после каждой ссылки на страницу. По умолчанию пусто.
• next_or_number (string) – Определяет, нужно ли выводить номера страниц или ссылки на следующую/предыдущую страницу. Принимает значения number (для номеров страниц), next (для ссылок на следующую страницу) или both (и то, и другое). По умолчанию number.
• nextpagelink (string) – Текст ссылки на следующую страницу. По умолчанию «Next page».
• previouspagelink (string) – Текст ссылки на предыдущую страницу. По умолчанию «Previous page».
• pagelink (string) – Формат текста ссылок. % будет заменено на номер страницы, например, «Page %» выведет ссылки как «Page 1», «Page 2» и т.д. По умолчанию %.
• echo (bool) – Определяет, нужно ли выводить результат на экран (true) или возвращать его (false). По умолчанию true.

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

Функцию wp_link_pages() обычно вызывают внутри шаблонных файлов WordPress, таких как single.php, чтобы создать навигацию по страницам контента:

<?php
// Внутри вашего шаблона, например single.php
if ( have_posts() ) :
    while ( have_posts() ) : the_post();
        the_content( 
            wp_link_pages( array(
                'before'           => '<p>' . __('Pages:'),
                'after'            => '</p>',
                'link_before'      => '',
                'link_after'       => '',
                'next_or_number'   => 'number',
                'nextpagelink'     => __('Next page'),
                'previouspagelink' => __('Previous page'),
                'pagelink'         => '%',
                'echo'             => 1
            ) )
        );
    endwhile;
endif;
?>

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

Для быстрого добавления разрыва страницы в визуальном редакторе WordPress можно использовать комбинацию клавиш: alt + shift + p. Также можно добавить кнопку разрыва страницы в редактор TinyMCE (Нужно активировать классический редактор при помощи плагина) с помощью следующего кода в 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;
}

Параметры шаблона

Вы можете настроить вывод ссылок, обернув их в дополнительные HTML-теги и изменив текст каждой ссылки. Например:

<?php wp_link_pages( array(
    'before'    => '<div id="page-links">',
    'after'     => '</div>',
    'pagelink'  => 'Page %'
)); ?>

Заключение

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