Функция bloginfo() используется для вывода различной информации о текущем сайте в WordPress. Это шаблонный тег, который можно использовать в любом месте темы для отображения параметров сайта, таких как название, описание, URL и другие параметры.
Основные данные берутся из настроек WordPress (вкладка «Общие» в панели администратора) или из информации о сайте, хранящейся в базе данных WordPress. Эта функция всегда выводит результат непосредственно в HTML-код. Если вам нужно получить данные для обработки в PHP, используйте функцию get_bloginfo(), которая возвращает значения в виде строки.
bloginfo( string $show = '' );Параметры
$show(string, необязательный): Указывает, какую именно информацию о сайте вывести. Возможные значения параметра описаны ниже. По умолчанию выводится название сайта (значение'name').
Возможные значения для параметра $show
'name'— название сайта (устанавливается в настройках WordPress: Настройки > Общие).'description'— краткое описание (слоган) сайта.'wpurl'— URL-адрес WordPress (URL, где установлена CMS).'url'— основной URL-адрес сайта (домашняя страница).'admin_email'— E-mail администратора сайта.'charset'— кодировка сайта (по умолчанию UTF-8).'version'— текущая версия WordPress.'html_type'— тип контента страниц (например,text/html).'text_direction'— направление текста (LTR или RTL).'language'— язык сайта (например,ru-RU).'stylesheet_url'— URL на файл стилей (обычноstyle.cssтекущей темы).'stylesheet_directory'— URL директории с файлами текущей темы.'template_url'/'template_directory'— URL директории с шаблонами (для родительской темы).'pingback_url'— URL для pingback (файлxmlrpc.php).'atom_url'— URL Atom-фида сайта.'rdf_url'— URL RDF/RSS 1.0 фида сайта.'rss_url'— URL RSS 0.92 фида сайта.'rss2_url'— URL RSS 2.0 фида сайта.'comments_atom_url'— URL Atom-фида комментариев.'comments_rss2_url'— URL RSS 2.0 фида комментариев.
Устаревшие значения:
'siteurl'— устарело, используйте'url'. (илиsite_url())'home'— устарело, используйте'url'. (илиhome_url())
Примечание
Если в качестве значения параметра $show передать неизвестное значение или не передать его вовсе, то будет выведено название сайта.
Пример 1: Вывод названия сайта
Этот код выводит название сайта, которое задано в настройках WordPress.
<h1><?php bloginfo('name'); ?></h1>
Пример 2: Вывод описания сайта (слогана)
Отобразит описание сайта, заданное в настройках.
<p><?php bloginfo('description'); ?></p>
Пример 3: Вывод названия сайта в ссылке
Отобразит название сайта в виде кликабельной ссылки, которая ведет на главную страницу.
<a href="<?php bloginfo('url'); ?>" title="<?php bloginfo('name'); ?>">
<?php bloginfo('name'); ?>
</a>
Пример 4: Условный вывод описания сайта
Если описание сайта задано, оно будет выведено в виде ссылки с классом site-description. Если описания нет, код ничего не выведет.
<?php if ( get_bloginfo('description') !== '' ) { ?>
<a class="site-description"><?php bloginfo('description'); ?></a>
<?php } ?>
Пример 5: Вывод кодировки сайта
Этот код выводит текущую кодировку сайта, как правило, это UTF-8.
<p>Кодировка: <?php bloginfo('charset'); ?></p>
Дополнительная информация
- get_bloginfo(): Если вам нужно использовать результат функции в качестве переменной для дальнейшей обработки, используйте
get_bloginfo()вместоbloginfo(), так какbloginfo()только выводит результат на экран, а не возвращает его.
<?php
$url = get_bloginfo('url');
echo $url;
?>Этот код сохранит URL сайта в переменную $url и выведет его на экран.
Заключение
Функция bloginfo() — это мощный инструмент для получения информации о сайте в WordPress. Она проста в использовании и позволяет выводить различные параметры сайта в любом месте темы.