Функция GET_COMMENT_REPLY_LINK(): использование, хуки, возвращаемое значение, примеры

# Функция GET_COMMENT_REPLY_LINK() │ WP 2.7.0

Функция GET_COMMENT_REPLY_LINK() позволяет получить HTML-код для ссылки "Ответить на комментарий".

## Использование функции

Эту функцию чаще всего используют в сочетании с функцией comment_reply_link(). 

**Производительность:**
- Вызов функции 1 раз: 0.000774 сек (медленно)
- Вызов функции 50000 раз: 19.68 сек (медленно)

## Хуки функции

- comment_reply_link_args
- comment_reply_link

## Возвращаемое значение

Функция возвращает:
- **Строка** - ссылка на форму комментария (если успешно)
- **false** - если комментарии закрыты
- **null** - если комментарий не найден

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

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

```php
$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-код

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

Параметры функции

get_comment_reply_link( $args, $comment, $post )

• $args (массив): Параметры, которые переопределяют значения по умолчанию.

  Стандартные параметры:

  • add_below (строка): Селектор для идентификации комментария, на который отвечают. По умолчанию comment.
  • respond_id (строка): Идентификатор реагирующего комментария. По умолчанию respond.
  • reply_text (строка): Текст ссылки "Ответить". По умолчанию Ответить.
  • reply_to_text (строка): Доступное имя ссылки, где %s будет заменен на имя автора комментария. По умолчанию Ответить на %s.
  • show_reply_to_text (true|false): Использовать текст reply_to_text как видимый текст ссылки. По умолчанию false.
  • login_text (строка): Текст ссылки для ответа, если пользователь не вошел в систему. По умолчанию Войти для ответа.
  • max_depth (число): Максимальная глубина дерева комментариев.
  • depth (число): Глубина нового комментария. Должна быть больше 0 и меньше значения параметра thread_comments_depth, установленного в Настройки > Обсуждение.
  • before (строка): Текст или HTML, добавляемый перед ссылкой на ответ. По умолчанию пусто.
  • after (строка): Текст или HTML, добавляемый после ссылки на ответ. По умолчанию пусто.

• $comment (int|WP_Comment): Комментарий, на который отвечают. По умолчанию текущий комментарий.

• $post (int|WP_Post): ID поста или объект WP_Post, на котором будет отображаться комментарий. По умолчанию текущий пост.

Примечания

Функция проверяет, открыты ли комментарии для данного поста, а также соблюдается ли максимальная и текущая глубина комментариев. Если все условия выполнены, сгенерируется ссылка для ответа на комментарий.

Изменения

• С версии 2.7.0: Впервые введена.
• С версии 4.4.0: Добавлена возможность использования объекта WP_Comment для параметра $comment.

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

• cancel_comment_reply_link()
• comment_author_email_link()
• comment_form()
• comment_text()
• get_comment()
• get_comments()
• и другие функции работы с комментариями.

Эта статья теперь понятна для начинающих пользователей WordPress и содержит необходимую информацию о функции GET_COMMENT_REPLY_LINK() с объяснениями и примерами.