Функция COMMENT_EXCERPT() в WordPress

Функция COMMENT_EXCERPT() используется для отображения краткого содержания текущего комментария. Давайте разберемся, как она работает и как ее использовать.

Как использовать функцию

Для получения краткого содержания комментария, просто вызовите функцию следующими параметрами:

comment_excerpt( $comment_id );

Параметры

• $comment_id (int|WP_Comment) — ID комментария или объект WP_Comment, для которого необходимо вывести краткое содержание.
  • По умолчанию: текущий комментарий.

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

Чтобы вывести краткое содержание последнего комментария, воспользуйтесь следующим кодом:

Последний комментарий: 

Что отобразится:

Последний комментарий: Можете рассказать, как правильно использовать этот плагин для подсчета кликов по внешним ссылкам...

Важные моменты

• Возврат: Функция ничего не возвращает (null).
• Р��бота функции: Функция выполняется довольно быстро — 0,000975 секунды при одном вызове. Однако, если вы вызовите ее 50,000 раз, то время выполнения увеличится до 5.40 секунд.

Содержимое функции

Вот как выглядит код функции comment_excerpt() в файле wp-includes/comment-template.php:

function comment_excerpt( $comment_id = 0 ) {
$comment = get_comment( $comment_id );

$comment_excerpt = get_comment_excerpt( $comment );

/**
 * Фильтрует текст краткого содержания комментария для отображения.
 *
 * @since 1.2.0
 * @since 4.1.0 Параметр $comment_id был добавлен.
 *
 * @param string $comment_excerpt Текст краткого содержания комментария.
 * @param string $comment_id      ID комментария в виде строкового числа.
 */
echo apply_filters( 'comment_excerpt', $comment_excerpt, $comment->comment_ID );

}

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

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

• comment_author() — возвращает автора комментария.
• comment_date() — выводит дату комментария.
• comments_number() — показывает количество комментариев.
• get_comment_excerpt() — получает краткое содержание комментария.
• wp_list_comments() — выводит список комментариев в формате HTML.

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

• С версии 1.2.0 — функция была представлена.
• С версии 4.4.0 — добавлена возможность использовать объект WP_Comment в качестве параметра $comment_id.

Эта информация должна помочь вам лучше понять, как использовать функцию COMMENT_EXCERPT() в WordPress. Если у вас возникнут вопросы, не стесняйтесь их задавать!