get_comment_link()
Получает ссылку на указанный комментарий. Ссылка генерируется с учетом древовидности. Ссылка возвращается в хэшем на конце #comment-23.
Не путайте с get_comments_link(), которая возвращает ссылку (с якорем) на все комментарии к определенному посту.
-
Использует: get_comment() чтобы получить данные переданного коммента $comment.
- Использует глобальные переменные: $wp_rewrite и $in_comment_loop.
Хуки из функции
Возвращает
Строку
. Строку, УРЛ на указанный комментарий. Значение возвращается, а не выводиться на экран.
Использование
$link = get_comment_link( $comment, $args );
- $comment(число/объект)
- ID/объект комментария, ссылку на который нужно получить.
По умолчанию: null (текущий в цикле комментарий) - $args(массив)
Аргументы. По умолчанию используются:
-
cpage(число/строка)
Номер страницы пагинации на которой находится комментарий.Если указать это значение, то номер текущей страницы коммента вычисляться не будет. C версии 4.4.
Если указать тут 0, то в URL не будет части:
/comment-page-1
.
По умолчанию: '' -
page
Номер страницы пагинации на которой находится комментарий. Используется как предварительное значение для параметра cpage, перед тем как будет вычислена страница комментария. Нужен для обратной совместимости и по идее этот параметр можно совсем не использовать.
По умолчанию: 0 -
type
Тип комментария (на прямую не используется).
По умолчанию: 'all' -
per_page
Количество комментариев на странице пагинации.
По умолчанию: 0 - max_depth
Максимальная глубина у древовидных комментариев (напрямую не используется).
По умолчанию: ''
По умолчанию: array()
-
Примеры
#1 Пример того, что получает функция
echo get_comment_link(17); // http://example.com/frontend-15-hukov/comment-page-1#comment-17
#2 Пример использования в HTML конструкции
<a href="<?php echo get_comments_link( $comment ); ?>"> комментарии к посту </a>
#3 Удалим часть страницы пагинации комментария из URL
Допустим мы заранее знаем, что коммент находится на первой странице и чтобы в URL не добавлялось лишнее /comment-page-1
, укажем параметр cpage=0 (при этом страница пагинации вычисляться не будет):
echo get_comment_link($comm, [ 'cpage'=>0 ]); // https://wp-kama.ru/question/vyvod-postov#comment-234
Заметки
- Смотрите: get_page_of_comment()
- Global. WP_Rewrite. $wp_rewrite WordPress rewrite component.
- Global. true|false. $in_comment_loop
Список изменений
С версии 1.5.0 | Введена. |
С версии 4.4.0 | Added the ability for $comment to also accept a WP_Comment object. Added $cpage argument. |