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

Главная - WordPress Codex - Функция previous_comments_link() в WordPress с примерами
Доступна с версии: 2.7
Раздел: Комментарии
Написал: Александр Сокирка

Функция previous_comments_link() в WordPress выводит ссылку на предыдущую страницу комментариев для текущего поста. Эта функция полезна, когда комментарии разбиты на несколько страниц, и пользователю нужно предоставить возможность навигации между ними.

previous_comments_link( string $label = 'Previous Comments' );

previous_comments_link() отображает ссылку, ведущую на предыдущую страницу комментариев. Если предыдущая страница отсутствует (то есть это первая страница), функция не выводит ничего.

Параметры

  • $label
    (строка, необязательный) – Текст ссылки. По умолчанию это 'Previous Comments'. Если параметр не задан, будет использоваться этот стандартный текст.

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

  • Функция не возвращает никаких значений, но выводит HTML-ссылку. Если предыдущих страниц комментариев нет, функция ничего не выведет.

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

Предположим, у вас есть пост с большим количеством комментариев, и они разбиты на несколько страниц. В этом случае для навигации по страницам комментариев можно использовать функцию previous_comments_link() вместе с функцией next_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( '&larr; Предыдущие комментарии' ); ?></div>
        <div class="nav-next"><?php next_comments_link( 'Следующие комментарии &rarr;' ); ?></div>
    </nav>
<?php endif; ?>

В этом примере проверяется, разбиты ли комментарии на несколько страниц с помощью функции get_comment_pages_count(). Если условие истинно, отображаются ссылки для навигации между страницами комментариев. Ссылка на предыдущие комментарии создается с помощью функции previous_comments_link(), а на следующие — с помощью next_comments_link().

Примечания

  • Функция работает только при включенной разбивке комментариев на страницы. Для этого в настройках WordPress нужно включить опцию «Разбить комментарии на страницы».
  • previous_comments_link() должна быть использована в цикле комментариев или в шаблонах, связанных с комментариями.

Заключение

Функция previous_comments_link() удобна для реализации навигации по страницам комментариев в WordPress. С её помощью вы можете легко предоставить пользователям доступ к предыдущим страницам комментариев, улучшив навигацию и удобство

Стартовая премиум тема для WordPress
Демо импорт тестового контента в 1 клик.
SEO оптимизированный и валидный код.
Множество готовых стартовых сайтов.
Лучшая документация и поддержка.
Опции персонализации контента.
Креативный и современный дизайн.
Тема для WordPress

Дополнительно по: Комментарии