Функция GET_CANCEL_COMMENT_REPLY_LINK() Использование и Примеры

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

Функция get_cancel_comment_reply_link() используется для получения HTML-кода ссылки, которая позволяет отменить ответ на комментарий. Это особенно полезно, если пользователь решил не отвечать на комментарий, а хочет вернуться к первоначальному виду страницы.

## Используемые функции

Данная функция используется в функции cancel_comment_reply_link().

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

Функция возвращает строку.

## Применение

Чтобы использовать эту функцию, можно написать следующее:

```php
$link = get_cancel_comment_reply_link( $link_text, $post );

Параметры

• $link_text (string) — текст, который будет отображаться для ссылки «отменить ответ». Если параметр пустой, по умолчанию будет использовано значение 'Нажмите здесь, чтобы отменить ответ'.

• $post (int|WP_Post|null) — пост, для которого отображается поток комментариев. По умолчанию используется текущий глобальный пост.

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

Пример 1: Отобразить ссылку для отмены ответа на комментарий

$cancel_link = get_cancel_comment_reply_link();
echo $cancel_link;

Этот код создаст ссылку, которая отменяет ответ на конкретный комментарий.

История изменений

• С версии 2.7.0 — функция была введена.
• С версии 6.2.0 — добавлен параметр $post.

Код функции

Вот код функции get_cancel_comment_reply_link():

function get_cancel_comment_reply_link( $link_text = '', $post = null ) {
if ( empty( $link_text ) ) {
$link_text = __( 'Click here to cancel reply.' );
}

$post        = get_post( $post );
$reply_to_id = $post ? _get_comment_reply_id( $post->ID ) : 0;
$link_style  = 0 !== $reply_to_id ? '' : ' style="display:none;"';
$link_url    = esc_url( remove_query_arg( array( 'replytocom', 'unapproved', 'moderation-hash' ) ) ) . '#respond';

$cancel_comment_reply_link = sprintf(
    '%3$s',
    $link_url,
    $link_style,
    $link_text
);

/**
 * Фильтрует HTML-код ссылки для отмены ответа на комментарий.
 *
 * @since 2.7.0
 *
 * @param string $cancel_comment_reply_link HTML-код ссылки.
 * @param string $link_url                  URL ссылки.
 * @param string $link_text                 Текст ссылки.
 */
return apply_filters( 'cancel_comment_reply_link', $cancel_comment_reply_link, $link_url, $link_text );

}

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

• cancel_comment_reply_link()
• comment_author_email_link()
• comment_form()
• comment_form_title()
• comment_id_fields()
• comment_text()
• comment_type()
• comments_link()
• comments_popup_link()
• get_avatar()
• get_avatar_data()
• get_avatar_url()
• get_comment()
• get_comment_author_email()
• get_comment_pages_count()
• get_comment_reply_link()
• get_comment_text()
• get_comment_type()
• get_comments()
• get_comments_link()
• get_comments_number()
• get_comments_pagenum_link()
• get_edit_comment_link()
• get_next_comments_link()
• get_page_of_comment()
• get_previous_comments_link()
• get_the_comments_navigation()
• get_the_comments_pagination()
• is_comment_feed()
• is_trackback()
• next_comments_link()
• paginate_comments_links()
• previous_comments_link()
• sanitize_comment_cookies()
• the_comments_navigation()
• the_comments_pagination()
• wp_allow_comment()
• wp_count_comments()
• wp_delete_comment()
• wp_get_current_commenter()
• wp_handle_comment_submission()
• wp_insert_comment()
• wp_list_comments()
• wp_new_comment()
• wp_notify_moderator()
• wp_notify_postauthor()
• wp_set_comment_cookies()
• wp_set_comment_status()
• wp_spam_comment()
• wp_transition_comment_status()
• wp_update_comment()
• wp_update_comment_count()