Функция single_post_title() в WordPress используется для отображения заголовка текущего поста или записи. Эта функция особенно полезна, когда нужно вывести заголовок записи вне основного цикла WordPress.
single_post_title( string $prefix = '', bool $echo = true )Параметры:
$prefix(строка) (необязательный): Текст, который будет добавлен перед заголовком поста. По умолчанию пустая строка.$echo(логический) (необязательный): Если установлено вtrue, функция выводит заголовок на экран. Если установлено вfalse, функция возвращает заголовок в виде строки. По умолчаниюtrue.
Возвращаемое значение
Функция возвращает строку с заголовком текущего поста, если параметр $echo установлен в false. Если $echo установлен в true, функция выводит заголовок на экран и ничего не возвращает.
Примечания
- Функция
single_post_title()предназначена для использования на страницах одиночных записей и может быть полезна для отображения заголовка записи вне стандартного цикла WordPress. - Эта функция является основой для работы с функцией
wp_get_document_title(), которая позволяет получать заголовок документа.
Хуки из функции
Функция single_post_title() не имеет встроенных хуков, но её использование часто сочетается с другими функциями и хуками для динамического отображения контента.
Примеры использования
- Вывод заголовка записи с префиксом:
Для отображения заголовка записи с дополнительным текстом перед ним, например, «Текущий пост: «, используйте следующий код:
<h2><?php single_post_title('Текущий пост: '); ?></h2>- Получение заголовка записи без его вывода:
Если вам нужно получить заголовок поста для дальнейшего использования или обработки, можно установить параметр $echo в false и сохранить результат в переменной:
<?php
// Получение заголовка записи в переменной
$post_title = single_post_title('', false);
// Использование заголовка записи
echo '<h1>' . esc_html($post_title) . '</h1>';
?>
Рекомендации по SEO
Для улучшения SEO-оптимизации вашей страницы, убедитесь, что заголовок, выводимый с помощью single_post_title(), правильно структурирован и включает ключевые слова. Использование семантических HTML-тегов, таких как <h1>, <h2>, помогает поисковым системам лучше понять структуру вашего контента.
Заключение
Функция single_post_title() позволяет легко адаптировать заголовки записей под конкретные условия, обеспечивая гибкость в отображении информации на вашем сайте.