Функция GET_COMMENTS_LINK() │ WP 1.5.0

Функция get_comments_link() возвращает ссылку на комментарии текущей записи.

Используется с

Функция get_permalink() возвращает ссылку на запись.

Вызов функций

Эта функция используется функцией comments_link().

Хуки функции

Фильтр get_comments_link позволяет изменять возвращаемую ссылку на комментарии.

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

Строка. Ссылка на комментарии.

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

get_comments_link( $post );

Параметры функции

• $post (int|WP_Post) — ID записи или объект WP_Post. По умолчанию используется глобальная переменная $post.

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

Пример 1: Получение ссылки на комментарии

Предположим, функция вызывается на странице с URL: http://example.com/page:

// если у записи нет комментариев:
echo get_comments_link(); //> http://example.com/page#respond

// если у записи есть комментарии:
echo get_comments_link(); //> http://example.com/page#comments

Обратите внимание

Эта функция автоматически добавляет к ссылке элемент #comments, если у записи есть комментарии. Если комментариев нет, она добавляет #respond, что позволяет пользователям оставлять новые комментарии.

Изменения в версии

• С версии 1.5.0 — Функция была введена в WordPress.

Код функции

function get_comments_link( $post = 0 ) {
    $hash          = get_comments_number( $post ) ? '#comments' : '#respond';
    $comments_link = get_permalink( $post ) . $hash;

    /**
     * Фильтрует возвращаемую ссылку на комментарии записи.
     *
     * @since 3.6.0
     *
     * @param string      $comments_link Ссылка на комментарии с добавленным '#comments'.
     * @param int|WP_Post $post          ID записи или объект WP_Post.
     */
    return apply_filters( 'get_comments_link', $comments_link, $post );
}

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

• add_comment_meta() — Добавление метаданных к комментариям.
• clean_comment_cache() — Очищает кэш комментариев.
• comment_link() — Получить ссылку на конкретный комментарий.
• comments_template() — Подключает шаблон комментариев.
• get_comment_author() — Получить автора комментария.
• have_comments() — Проверить, есть ли комментарии.

Полезные функции по работе с URL

• admin_url() — Получить URL к административной панели.
• home_url() — Получить URL главной страницы сайта.
• site_url() — Получить URL сайта.

Полезные функции по работе с комментариями

• comment_form() — Показать форму для добавления комментария.
• get_comments_number() — Получить количество комментариев для записи.
• wp_insert_comment() — Вставить новый комментарий в базу данных.

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