Функция PREVIOUS_COMMENTS_LINK() в WordPress 2.7.0: описание и примеры

Функция PREVIOUS_COMMENTS_LINK() │ WP 2.7.0

Функция PREVIOUS_COMMENTS_LINK() выводит ссылку на предыдущую страницу комментариев.

Как она работает

Под капотом используется функция get_previous_comments_link().

Время выполнения:

  • 1 раз: 0.00019 сек (быстро)
  • 50000 раз: 2.7 сек (быстро)

Хуки: Нет.

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

Функция возвращает null, что означает отсутствие значения.

Использование

Чтобы использовать эту функцию, вызывайте её так:

previous_comments_link( $label );

Параметры:

  • $label (тип: string) — текст ссылки для комментариев.
  • По умолчанию: пустая строка ''.

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

Пример 1: Вывод ссылки на предыдущую страницу комментариев текущего поста

Предположим, у поста 44 комментария, и мы находимся на второй странице комментариев. В этом случае:

previous_comments_link();

Результат:

← Предыдущие комментарии

Добавьте свой пример

Журнал изменений

  • С версии 2.7.0 функция была введена.

Реализация

Функция PREVIOUS_COMMENTS_LINK() доступна в файле wp-includes/link-template.php.

function previous_comments_link( $label = '' ) {
    echo get_previous_comments_link( $label );
}

Связанные функции

Навигация по комментариям

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

  • get_comment_pages_count() — Получить количество страниц с комментариями.
  • get_comments_pagenum_link() — Получить ссылку на страницу с комментариями по номеру.
  • get_next_comments_link() — Получить ссылку на следующую страницу комментариев.
  • get_page_of_comment() — Получить номер страницы, на которой находится комментарий.
  • get_previous_comments_link() — Получить ссылку на предыдущую страницу комментариев.
  • get_the_comments_navigation() — Получить навигацию по комментариям.
  • next_comments_link() — Вывести ссылку на следующую страницу комментариев.
  • paginate_comments_links() — Вывести ссылки на страницы комментариев.
  • the_comments_navigation() — Вывести навигацию по комментариям.
  • the_comments_pagination() — Вывести пагинацию комментариев.

Комментарии

Некоторые другие функции, относящиеся к комментариям:

  • cancel_comment_reply_link() — Ссылка для отмены ответа на комментарий.
  • comment_author_email_link() — Ссылка на адрес электронной почты автора комментария.
  • comment_form() — Форму для добавления комментария.
  • comment_form_title() — Заголовок формы комментариев.
  • get_avatar() — Получить аватар автора комментария.
  • wp_notify_postauthor() — Уведомить автора поста о новом комментарии.

Эти функции помогут вам лучше управлять и выводить комментарии на вашем сайте WordPress.

Leave a Reply

Ваш адрес email не будет опубликован. Обязательные поля помечены *