Описание функции comment_form_title()
Функция comment_form_title() генерирует заголовок для формы комментариев, основываясь на контексте (например, запись или страница). Она используется для отображения заголовка формы, позволяя разработчикам адаптировать текст в зависимости от контекста.
Функция может быть полезна как для стандартных комментариев, так и для форм комментариев в рамках кастомных тем и плагинов.
Параметры
$id
Тип: int
Обязательный: Нет
Описание: ID поста или комментария, к которому относится форма
Возможные значения:
Возвращаемое значение
Тип: string
Описание: Строка, представляющая заголовок формы комментариев
Возможные значения:
• Заголовок ‘Оставьте комментарий’ для постов, если ID не указан
• Заголовок ‘Ответить на комментарий’ для ответов на комментарии
• Пустая строка, если не удалось получить заголовок
Примеры использования
$title = comment_form_title('', true);
// Вывод заголовка формы комментариев
echo $title; // 'Оставьте комментарий'
$title = comment_form_title('', true);
// Изменяем заголовок для конкретного поста
if ( is_single() ) {
$post_id = get_the_ID();
$title = comment_form_title($post_id, true);
}
// Вывод заголовка
echo $title;
$title = comment_form_title('', true);
if ( empty($title) ) {
echo 'Ошибка получения заголовка';
} else {
echo $title;
}
Отображение заголовка формы комментариев в теме
if (comments_open()) {
echo '<h3>' . comment_form_title('', true) . '</h3>';
comment_form();
}
Безопасность
Валидация входных данных: ID поста проверяется внутри функции
Санитизация: Функция возвращает уже очищенные данные
Рекомендации: Используйте esc_html() для вывода заголовка на странице
— Связанные функции
Выводит форму для отправки комментариев
Получает количество комментариев к посту
— Хуки
Фильтрует заголовок формы комментариев перед выводом
— Примечания
– Ограничения
Не работает вне контекста постов или комментариев
– Частые проблемы
- Пустой заголовок при неправильном ID
- Не отображается в контексте страниц без комментариев
