get_comment_reply_link()
Получает ссылку <a>, которая позволяет отвечать на комментарий. Используется в цикле комментариев.
Если подключен JavaScript comment-reply.js, то этот клик по ссылке будет передвигать форму комментирования под комментарий на который пользователь хочет ответить.
Основа для: comment_reply_link()
1 раз — 0.000774 сек (медленно) | 50000 раз — 19.68 сек (медленно)
Хуки из функции
Возвращает
Строку|false|null
. Ничего/false/строку. Ссылка для показа формы комментирования, в случае успеха. False, если комментирование закрыто.
Использование
get_comment_reply_link( $args, $comment, $post );
- $args(массив)
- Параметры, влияющие на отображение ссылки. См. ниже.
По умолчанию: предустановки - $comment(число/WP_Comment)
- ID комментария на который нужно отвечать. По умолчанию текущий комментарий в цикле.
С версии 4.4. можно передавать объект комме комментария WP_Comment.
По умолчанию: null - $post(число/WP_Post)
- ID или объект записи к которой относится комментарий. По умолчанию, текущий пост.
По умолчанию: null
Аргументы параметра $args
- add_below(строка)
- Название префикса для контейнера комментария. По умолчанию
comment
, означает что форма будет передвигаться под контейнер с атрибутом id="comment-23" (23 ID комментария на который отвечаем).
По умолчанию: 'comment' - respond_id(строка)
- Значение атрибута id контейнера формы комментирования. Т.е. если указано
respond
, то по нажатию на ссылку блок с id="respond" будет передвигаться (это блок формы комментирования).
По умолчанию: 'respond' - reply_text(строка)
- Текст ссылки.
По умолчанию: __('Reply') - login_text(строка)
- Текст ссылки, который показывается когда для того чтобы оставить комментарий нужно авторизоваться.
По умолчанию: __('Log in to Reply') - depth(число)
- Глубина комментариев для которых ссылка будет показана. Для древовидных комментариев. Если указать, например 3, то для комментария с глубиной вложенности 4 ссылка уже не будет отображаться.
По умолчанию: 0 - before(строка)
- Текст или html, которые нужно добавить перед ссылкой.
- after(строка)
- Текст или html, которые нужно добавить после ссылкой.
По умолчанию: array()
Примеры
#1 Ссылка для ответа на комментарий
Выведем ссылку для ответа на комментарий максимального уровня вложенности - 5, и изменим текст ссылки на "ответить на комментарий":
$link = get_comment_reply_link( [ 'reply_text' => "ответить на комментарий", 'respond_id' => 'comment', 'depth' => 5, 'max_depth' => 10, ], 2881, 631 ); // тут можем обработать ссылку перед выводом на экран //$link = str_replace( 'foo', 'bar', $link ); echo $link;
Выведет такой html код:
<a rel='nofollow' class='comment-reply-link' href='/function/comment_reply_link?replytocom=2881#comment' onclick='return addComment.moveForm( "comment-2881", "2881", "comment", "631" )' aria-label='Комментарий к записи Владимир' > ответить на комментарий </a>
Список изменений
С версии 2.7.0 | Введена. |
С версии 4.4.0 | Added the ability for $comment to also accept a WP_Comment object. |