Функция COMMENTS_LINK() │ WP 0.71

Функция comments_link() позволяет отобразить ссылку на комментарии текущего поста.

Использует

• Функция: get_comments_link()
• Используется в: comments_popup_link()

Производительность

• 1 раз — 0.001856 сек (очень медленно)
• 50000 раз — 3.18 сек (быстро)
• PHP: 7.1.5, WP: 4.8.2

Хуки

Хуков нет.

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

Функция возвращает null, т.е. ничего (null).

Применение

comments_link( $deprecated, $deprecated_2 );

• $deprecated (string) — не используется. По умолчанию: ''
• $deprecated_2 (string) — не используется. По умолчанию: ''

Примеры

Пример 1: Подключение функции

comments_link();

На экране будет отображено:

• Если у поста нет комментариев: http://example.com/postname#respond
• Если у поста есть комментарии: http://example.com/postname#comments

Пример 2: Отображение ссылки на форму комментариев в цикле WordPress

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

При использовании этого кода на странице категории, вы получите ссылку "оставить комментарий" для каждого поста, которая приведет пользователя непосредственно к форме комментариев на странице поста.

Изменения в функции

• С версии 0.71 — впервые добавлена.

Исходный код функции

Функция расположена в файле wp-includes/comment-template.php:

function comments_link( $deprecated = '', $deprecated_2 = '' ) {
    if ( ! empty( $deprecated ) ) {
        _deprecated_argument( __FUNCTION__, '0.72' );
    }
    if ( ! empty( $deprecated_2 ) ) {
        _deprecated_argument( __FUNCTION__, '1.3.0' );
    }
    echo esc_url( get_comments_link() );
}

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

• cancel_comment_reply_link()
• comment_author_email_link()
• comment_form()
• comment_form_title()
• comment_id_fields()
• comment_text()
• comment_type()
• comments_popup_link()
• get_avatar()
• get_avatar_data()
• get_avatar_url()
• get_cancel_comment_reply_link()
• 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()

Эта статья поможет вам лучше понять, как использовать функцию comments_link() в WordPress и какие возможности она открывает для отображения комментариев на ваших постах.