Как сделать пагинацию в архиве тегов WordPress

Если в архиве тега у вас выводится слишком длинный список записей, его нужно не просто «укоротить», а разбить на страницы. В WordPress это обычная задача для архивов таксономий: тегов, категорий и пользовательских рубрик. Проблема обычно не в самом теге, а в том, как тема выводит список записей и подключает навигацию между страницами.

Для архива тегов есть три рабочих сценария: штатная пагинация WordPress, правка шаблона темы и подключение плагина, если тема не умеет показывать нормальную навигацию. Какой вариант выбрать, зависит от того, есть ли у вас доступ к шаблонам и насколько тема уже готова к архивам.

Что именно должно происходить в архиве тега

Архив тега — это страница, где WordPress показывает записи с выбранным тегом. Если записей много, на одной странице их лучше не держать: это ухудшает удобство просмотра, растягивает загрузку и делает навигацию неудобной. Пагинация решает задачу просто: на странице показывается ограниченное число записей, а ниже — ссылки на следующие страницы архива.

Важно не путать это с пагинацией внутри одной записи или с кнопкой «Читать далее». Здесь речь именно о навигации по списку записей в архиве тега.

Сначала проверьте, не решается ли задача настройками темы

Во многих темах WordPress пагинация в архивах уже предусмотрена. Если на странице тега вы видите только первую порцию записей, а ниже нет ссылок на следующие страницы, сначала проверьте саму тему:

• есть ли в шаблоне архива вывод навигации после цикла записей;
• не заменена ли стандартная пагинация кнопкой «Загрузить ещё» или бесконечной прокруткой;
• не ограничено ли число записей на странице слишком маленьким или слишком большим значением в настройках чтения.

В админке откройте Настройки → Чтение и посмотрите параметр «На страницах блога отображать не более». Он влияет на архивы записей и часто на архивы таксономий тоже, если тема использует стандартный основной запрос WordPress. Если там стоит слишком большое число, архив тега будет перегружен. Если слишком маленькое — страниц станет слишком много.

Это не отдельная «настройка пагинации тегов», а базовый лимит записей в списках. Для большинства сайтов именно с него и стоит начинать.

Как сделать пагинацию в архиве тегов через шаблон темы

Если тема не выводит навигацию сама, её нужно добавить в шаблон архива. Обычно за страницы тегов отвечает файл tag.php. Если его нет, WordPress использует более общий шаблон, например archive.php или index.php.

Логика простая: после цикла вывода записей должна стоять функция пагинации. В современных темах чаще используют the_posts_pagination(). Она подходит для архивов и работает со стандартным запросом WordPress.

Пример типового фрагмента для шаблона архива:

<?php if ( have_posts() ) : ?>
    <?php while ( have_posts() ) : the_post(); ?>
        <!-- вывод записи -->
    <?php endwhile; ?>

    <?php the_posts_pagination( array(
        'mid_size'  => 2,
        'prev_text' => 'Назад',
        'next_text' => 'Вперёд',
    ) ); ?>
<?php endif; ?>

Здесь the_posts_pagination() выводит ссылки на страницы архива, а параметры prev_text и next_text задают подписи для переходов назад и вперёд. mid_size определяет, сколько номеров страниц показывать рядом с текущей.

Если тема старая или использует собственную разметку, вместо этого может быть paginate_links(). Но для большинства архивов тегов в обычной теме удобнее и безопаснее использовать именно the_posts_pagination().

Почему лучше править дочернюю тему

Если вы меняете файлы темы напрямую, обновление может затереть правки. Для шаблона архива это особенно неприятно: после обновления пагинация исчезнет, и придётся искать изменения заново. Поэтому правки шаблонов лучше делать в дочерней теме. Это стандартный и безопасный путь, если сайт уже работает в продакшене.

Если вы не уверены, какой файл отвечает за архив тегов, сначала проверьте иерархию шаблонов WordPress. Для тега приоритет обычно такой: tag-{slug}.php, затем tag-{id}.php, потом tag.php, далее archive.php и index.php.

Когда удобнее использовать плагин пагинации

Плагин нужен не всегда. Если тема уже умеет выводить стандартную навигацию, дополнительный плагин только усложнит сайт. Но есть ситуации, когда он действительно полезен:

• тема не выводит страницы архива, а править шаблон неудобно;
• нужен более заметный или другой по стилю блок навигации;
• тема использует нестандартную разметку, и встроенная пагинация выглядит плохо;
• вы не хотите лезть в PHP, но можете подключить готовое решение.

В таких случаях часто используют WP-PageNavi. Этот плагин заменяет стандартные ссылки «Предыдущая/Следующая» на более удобную навигацию с номерами страниц. Для длинных архивов тегов это практично: пользователь видит, сколько страниц есть у тега, и может быстро перейти к нужной.

Но здесь есть важный нюанс: плагин сам по себе не включает пагинацию в архиве. Он только даёт способ её красиво вывести. Если тема не вызывает функцию навигации в шаблоне, плагин не поможет без правки шаблона.

Как подключить WP-PageNavi в архиве тега

После установки и активации плагина в шаблоне архива нужно заменить стандартный вывод пагинации на вызов функции wp_pagenavi(). Обычно это делается после цикла записей:

<?php if ( have_posts() ) : ?>
    <?php while ( have_posts() ) : the_post(); ?>
        <!-- вывод записи -->
    <?php endwhile; ?>

    <?php if ( function_exists( 'wp_pagenavi' ) ) {
        wp_pagenavi();
    } ?>
<?php endif; ?>

Проверка через function_exists() нужна, чтобы сайт не падал, если плагин отключат. Это простая, но полезная страховка.

После этого откройте архив тега на сайте и проверьте, что:

• показывается не одна страница, а несколько;
• ссылки ведут на правильные URL вида /tag/slug/page/2/;
• на второй и следующих страницах отображаются другие записи, а не повтор первой страницы.

Что делать, если пагинация есть, но страницы дублируются или не открываются

Если ссылки на страницы архива есть, но содержимое повторяется, проблема обычно не в пагинации как таковой. Чаще всего причина в теме или в том, как сформирован запрос:

• тема выводит записи не через основной цикл WordPress, а через отдельный запрос;
• в шаблоне используется неправильная пагинация для кастомного запроса;
• кэш отдает старую версию страницы;
• на сервере или в .htaccess есть проблема с ЧПУ и правилами перезаписи.

Если архив тега открывается как страница 404 на второй странице, сначала проверьте постоянные ссылки в Настройки → Постоянные ссылки. Иногда достаточно просто сохранить их заново, чтобы WordPress пересоздал правила маршрутизации.

Если проблема появилась после ручной правки шаблона, проверьте, не сломана ли структура цикла. Для архивов важно, чтобы пагинация работала с тем же основным запросом, который WordPress формирует для тега. Если вы подменили его собственным WP_Query, тогда и пагинацию нужно настраивать отдельно.

Как не испортить навигацию и удобство на мобильных

Даже рабочая пагинация может быть неудобной, если она слишком мелкая или сливается с фоном. Для архивов тегов это особенно заметно на мобильных устройствах, где пользователь листает список быстро и часто попадает на страницы с большим количеством ссылок.

Проверьте три вещи:

• номера страниц достаточно крупные, чтобы по ним можно было нажимать пальцем;
• текущая страница визуально выделена;
• между ссылками есть нормальные отступы, а не плотная строка из цифр.

Если тема уже выводит пагинацию, иногда достаточно небольшого CSS-правила. Но здесь нельзя давать универсальный код без проверки разметки: у разных тем свои классы и структура. Сначала откройте страницу архива тега в браузере и посмотрите HTML блока пагинации через инструменты разработчика. Только после этого имеет смысл править стили.

Какой вариант выбрать в реальном проекте

Если у вас обычный блог или новостной сайт, стандартной пагинации WordPress часто достаточно. Если же это крупный сайт с большим количеством тегов и длинными архивами, удобнее сразу привести шаблон к нормальной навигации, а не надеяться на случайное поведение темы.

Когда задача выходит за рамки одной темы и вам нужно подобрать дополнительные инструменты для работы с архивами, шаблонами или навигацией, можно посмотреть каталог плагинов WPShop: https://wpshop.ru/plugins. Но для самой пагинации в архиве тега чаще всего хватает штатных возможностей WordPress или одного аккуратно подключенного плагина.