Функция очень похожа на get_comment_author() и отличается от неё по сути двумя вещами:
- Она не возвращает результат, а выводит,
- Имеет дополнительный фильтр-хук
comment_author
.
А также, если вам лень переходить на документацию функции get_comment_author(), то хочу напомнить, что функция работает в таком порядке:
- Сначала она проверяет поле
comment_author
в базе данных и попытается вывести его. - Если вдруг оно пустое, то она проверит, существует ли на сайте пользователь с указанным email, если да, то выведет его «Отображаемое имя».
- Если ничего из верхнего не совпадает, то выводит «Анонимный», а точнее
__( 'Anonymous' )
.
comment_author( $comment_ID = 0 )
- $comment_ID
- (целое число|WP_Comment) Укажите ID комментария или объект WP_Comment (поддержка объекта появилась в WordPress 4.4), автора которого вам нужно вывести. По умолчанию выводится автор текущего комментария, это можно хорошо наблюдать в примере создания произвольной функции вывода комментария.
Пример
Использование функции очень лёгкое:
<span class="comment-author"><?php comment_author() ?></span>
Либо вы также можете вывести имя автора какого-то определённого комментария, например с ID = 5555, в таком случае:
<span class="comment-author"><?php comment_author( 5555 ) ?></span>
Хуки внутри функции
Хук comment_author
функции принимает в себя значение ID комментария и в коде выглядит так:
... echo apply_filters( 'comment_author', $author, $comment->comment_ID ); }
Напоследок добавлю только, что параметр хука $comment->comment_ID
был добавлен в WordPress 4.1.0
Источник: misha.blog