Время для прочтения: 1 мин. 4 сек.

WP-PageNavi, давай, до свидания! Встречайте the_pagination

WP-PageNavi - это самый популярный и простой плагин для реализации постраничной навигации в WordPress. Он служил верой и правдой пользователям WordPress многие годы, за что ему огромное спасибо.

Но пришло время с ним расстаться, так как в WordPress версии 4.1 появилась возможность реализовывать постраничную навигацию средствами самого движка.

Встречайте the_pagination

Функция the_pagination() добавляет блок постраничной навигации в вашу тему WordPress аналогично wp_pagenavi().

pagination-example

the_pagination() в своих недрах использует paginate_links(), поэтому большинство аргументов у них совпадают:


<?php
if ( ! is_singular() ) {
	if ( function_exists( 'the_pagination' ) ) {
		the_pagination( array(
			'base' => '%_%',
			'format' => '?page=%#%',
			'total' => 1,
			'current' => 0,
			'show_all' => false, // показывать все страницы
			'prev_next' => true,
			'prev_text' => __('&laquo; Previous'), // текст ссылки назад
			'next_text' => __('Next &raquo;'), // текст ссылки вперёд
			'end_size' => 1, // количество страниц в начале и конце списка
			'mid_size' => 2, // количество страниц слева и справа от текущей страницы
			'type' => 'plain',
			'add_args' => false, // свой массив аргументов
			'add_fragment' => '',
			'before_page_number' => '', // добавить символ перед каждым номером страницы
			'after_page_number' => '', // добавить символ после каждого номера страницы
			'screen_reader_text' => __( 'Posts navigation' ) // замещающий текст для экранных читалок
		));		
	}
}
?>

Ссылки

Для вставки кода используйте HTML-теги
<pre><code class="php">ваш код</code></pre>