Функция next_comments_link() в WordPress выводит ссылку на следующую страницу комментариев для текущей записи. Это удобно для организации навигации по комментариям, если они разбиты на несколько страниц.
next_comments_link( string $label = 'Next Comments' );
next_comments_link() выводит HTML-ссылку, которая ведет на следующую страницу комментариев. Если следующая страница отсутствует (например, это последняя страница комментариев), то функция ничего не выведет.
Параметры
- $label
(строка, необязательный) – Текст ссылки. По умолчанию:'Next Comments'. Если параметр не задан, будет использоваться стандартный текст.
Возвращаемое значение
- null: Функция ничего не возвращает. Она выводит HTML-ссылку или не выводит ничего, если следующей страницы комментариев нет.
Пример использования
Пример 1: Простое использование
Для вывода ссылки на следующую страницу комментариев можно использовать следующий код:
<?php next_comments_link( 'Следующие комментарии →' ); ?>Если текущая страница комментариев не является последней, будет выведена ссылка на следующую страницу.
Пример 2: Навигация по страницам комментариев
Использование функции next_comments_link() вместе с previous_comments_link() позволяет создать полноценную навигацию между страницами комментариев.
<?php if ( get_comment_pages_count() > 1 && get_option( 'page_comments' ) ) : ?>
<nav class="comment-navigation">
<div class="nav-previous">
<?php previous_comments_link( '← Предыдущие комментарии' ); ?>
</div>
<div class="nav-next">
<?php next_comments_link( 'Следующие комментарии →' ); ?>
</div>
</nav>
<?php endif; ?>
Этот код выведет навигацию, если комментарии разбиты на несколько страниц. Ссылки будут отображены только в том случае, если есть предыдущие или следующие страницы комментариев.
Примечания
- Функция работает только при включенной разбивке комментариев на страницы. Чтобы включить эту опцию, нужно перейти в настройки обсуждений в панели администратора WordPress и включить «Разбить комментарии на страницы».
- Функция должна быть использована в контексте страниц, связанных с комментариями.
Заключение
Функция next_comments_link() позволяет легко добавлять навигацию по страницам комментариев в WordPress. Это полезно для улучшения пользовательского опыта на сайтах с большим количеством комментариев.