comment_text() – выводит текст комментария

Наглядный пример использования этой функции вы можете найти в моём видеоуроке.

comment_text( $comment_ID = 0, $args = array() )
$comment_ID
(целое число|WP_Comment) По умолчанию функция выводит текст текущего комментария – пример, но если вы хотите вывести текст какого-то определённого коммента, то в этот параметр можете передать его ID или, с версии WordPress 4.4 его объект WP_Comment.
$args
(массив) Массив аргументов, которые используются только для хука comment_text внутри функции, а также для хука get_comment_text, соответственно внутри функции get_comment_text(), на основе которой и работает comment_text().

Примеры

Вообще очень хороший пример использования я уже упомянул выше – это когда мы используем comment_text() внутри кастомной функции вывода комментария, вот ссылка на пример.

<div class="comment-content">
	<?php comment_text() ?>
</div>

Но конечно у вас также есть возможность вывести текст определённого комментария, для этого передаём в функцию первый параметр, например так:

$comment_id = 41;
comment_text( $comment_id );

Хук comment_text внутри функции

Вот мы и подошли к интересненькому.

Дело в том, что если вас спросят, в чём главное отличие между функциями get_comment_text() и comment_text() – что вы скажете? То, что одна функция выводит результат, а вторая – возвращает?

Неверно!

Главное отличие именно в этом фильтр-хуке, через который пропускаеттся результат действия функции перед выводом.

...
 
	echo apply_filters( 'comment_text', $comment_text, $comment, $args );
}

Если вам кажется, что в нём нет ничего такого особенного, то вот вам список того, что вешает на него ядро WordPress:

  • Функцию capital_P_dangit() с приоритетом 31, это нужно для любителей писать название движка неправильно, происходит автозамена «Wоrdpress», «wоrdpress», «вротпресс» и прочих ошибочных написаний на WordPress.
  • Функцию wptexturize() – делает замену некоторых символов, разных кавычек, например с » на “ и так далее.
  • convert_chars() – заменяет & на &
  • make_clickable() с приоритетом 9, которая автоматически создаёт ссылки <a> из урлов в тексте комментария.
  • force_balance_tags() с приоритетом 25, которая попробуем закрыть незакрытые HTML-теги в комментарии пользователя.
  • convert_smilies() с приоритетом 20 – преобразует символы типо 🙂 в 🙂
  • а также функцию wpautop() с приоритетом 20, которая превращает переносы строк в абзацы, именно поэтому никогда не надо помещать функцию comment_text() внутри тегов <p>.

Кстати говоря, любое из этого можно отключить следующим образом:

remove_filter( 'comment_text', 'convert_smilies', 20 );
// remove_filter( 'comment_text', ФУНКЦИЯ, ПРИОРИТЕТ ЕСЛИ ЕСТЬ );

Код для functions.php, если вы вдруг затерялись, куда его вставлять.

Миша

Недавно я осознал, что моя миссия – способствовать распространению WordPress. Ведь WordPress – это лучший движок для разработки сайтов – как для тех, кто готов использовать заложенную структуру этой CMS, так и для тех, кто предпочитает headless решения.

Сам же я впервые познакомился с WordPress в 2009 году. Организатор WordCamp. Преподаватель в школах Epic Skills и LoftSchool.

Если вам нужна помощь с вашим сайтом или может даже разработка с нуля на WordPress / WooCommerce — пишите. Я и моя команда сделаем вам всё на лучшем уровне.

Оставить комментарий

Если вы хотите добавить код, не забудьте обернуть его в <pre lang="php"></pre>, если же код – меньше одной строчки, то можно и в <code></code>.