Функция comment_form_title()
в WordPress используется для вывода заголовка формы комментариев. Этот заголовок изменяется в зависимости от контекста: отображается ли форма для добавления нового комментария или для ответа на существующий комментарий.
Функция comment_form_title()
генерирует текст заголовка для формы комментариев, принимая во внимание, отвечает ли пользователь на существующий комментарий или просто оставляет новый. Эта функция полезна, когда JavaScript отключен или если скрипт comment-reply.js
не загружен.
comment_form_title( string|false $no_reply_text = false, string|false $reply_text = false, bool $link_to_parent = true, int|WP_Post|null $post = null );
Параметры
$no_reply_text
(string|false, optional): Текст заголовка формы, когда комментатор оставляет новый комментарий, а не отвечает на существующий. По умолчанию:false
.$reply_text
(string|false, optional): Текст заголовка формы, когда комментатор отвечает на другой комментарий. Использует%s
для имени автора комментария, на который происходит ответ. По умолчанию:false
.$link_to_parent
(bool, optional): Логическое значение, указывающее, следует ли делать имя автора комментария в параметре$reply_text
ссылкой на его комментарий. По умолчанию:true
.$post
(int|WP_Post|null, optional): Пост, для которого отображается форма комментария. По умолчанию используется текущий глобальный пост (global $post
). По умолчанию:null
.
Возвращаемое значение
Функция comment_form_title()
не возвращает значения.
Пример 1: Вывод стандартных заголовков
<h3><?php comment_form_title(); ?></h3>
Этот пример выведет заголовок формы по умолчанию. Если форма предназначена для нового комментария, заголовок будет «Leave a Comment». Если для ответа на комментарий, заголовок будет «Reply to [Имя автора комментария]».
Пример 2: Пользовательские заголовки
<h3><?php comment_form_title( 'Комментировать', 'Ответить комментатору: %s' ); ?></h3>
В этом примере заголовок формы для нового комментария будет «Комментировать», а заголовок для ответа на существующий комментарий будет «Ответить комментатору: [Имя автора комментария]».
Пример 3: Использование с параметрами
<?php
if ( comments_open() ) :
comment_form( array(
'title_reply' => comment_form_title( 'Ваше мнение', 'Ответить на комментарий от %s', true )
) );
endif;
?>
Этот пример использует функцию comment_form_title()
в контексте функции comment_form()
. Заголовок для нового комментария будет «Ваше мнение», а для ответа на комментарий — «Ответить на комментарий от [Имя автора комментария]». Имя автора комментария будет ссылкой на его комментарий.
Дополнительная информация
Функция comment_form_title()
обычно используется сразу после HTML-тега <div id="respond">
или перед самой формой комментария. Она влияет на пользователей с отключенным JavaScript или в случаях, когда скрипт comment-reply.js
не загружен.
Заключение
Функция comment_form_title()
позволяет легко управлять заголовками формы комментариев в WordPress, обеспечивая гибкость в отображении информации пользователю. Используя параметры функции, можно настроить заголовки формы в зависимости от контекста, улучшая пользовательский интерфейс и взаимодействие на сайте.