Функция COMMENT_FORM_TITLE() в WordPress: использование, параметры и примеры

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

Эта функция показывает текст в зависимости от того, отвечаете ли вы на комментарий или нет. Учтите, что она работает только для пользователей, у которых отключен JavaScript.

### Важные моменты

- **Хуки**: не используются.

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

- **null**: ничего (null).

## Использование

```php
comment_form_title( $no_reply_text, $reply_text, $link_to_parent, $post );

• $no_reply_text (string|false): Текст, который отображается, если вы не отвечаете на комментарий. По умолчанию: false.
• $reply_text (string|false): Текст, который отображается, если вы отвечаете на комментарий. Допустим "%s" для имени автора комментария, на который вы отвечаете. По умолчанию: false.
• $link_to_parent (true|false): Булевое значение, определяющее, будет ли имя автора ссылкой на его комментарий. По умолчанию: true.
• $post (int|WP_Post|null): Пост, для которого отображается форма комментариев. По умолчанию: текущий глобальный пост.

Примеры

Пример 1: Создание заголовка для формы комментариев

Пример 2: Использование собственных текстов

Вы можете заменить тексты по своему усмотрению.

Заметки

• Глобальный объект: WP_Comment. Доступен глобальный объект комментария $comment.

Изменения

• Версия 2.7.0: Функция была введена.
• Версия 6.2.0: Добавлен параметр $post.

Код функции COMMENT_FORM_TITLE()

Файл: wp-includes/comment-template.php

function comment_form_title( $no_reply_text = false, $reply_text = false, $link_to_parent = true, $post = null ) {
    global $comment;

    if ( false === $no_reply_text ) {
        $no_reply_text = __( 'Оставьте свой ответ' );
    }

    if ( false === $reply_text ) {
        /* translators: %s: Автор комментария, на который отвечают. */
        $reply_text = __( 'Ответить на %s' );
    }

    $post = get_post( $post );
    if ( ! $post ) {
        echo $no_reply_text;
        return;
    }

    $reply_to_id = _get_comment_reply_id( $post->ID );

    if ( 0 === $reply_to_id ) {
        echo $no_reply_text;
        return;
    }

    // Устанавливает глоба��ьный объект, чтобы можно было использовать теги шаблонов в форме комментария.
    $comment = get_comment( $reply_to_id );

    if ( $link_to_parent ) {
        $comment_author = sprintf(
            '%2$s',
            get_comment_ID(),
            get_comment_author( $reply_to_id )
        );
    } else {
        $comment_author = get_comment_author( $reply_to_id );
    }

    printf( $reply_text, $comment_author );
}

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

• cancel_comment_reply_link()
• comment_author_email_link()
• comment_form()
• get_comment()
• wp_insert_comment()
• Другие функции, связанные с комментариями.

Эти функции помогут вам лучше управлять комментариями на вашем сайте WordPress.