Функция 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, обеспечивая гибкость в отображении информации пользователю. Используя параметры функции, можно настроить заголовки формы в зависимости от контекста, улучшая пользовательский интерфейс и взаимодействие на сайте.