Функция bloginfo() в WordPress

Функция bloginfo() отображает информацию о текущем сайте. Эта информация в основном собирается из данных, которые вы указываете в вашем профиле пользователя и общих настройках сайта в вашей админке WordPress. Эту функцию можно использовать в любом месте внутри файлов шаблона. Она всегда выводит результат на экран. Если вам нужны значения для использования в PHP, используйте функцию get_bloginfo().

Для новичков

Если вы еще не знакомы с WordPress, развею миф о том, что использование этой функции создает высокую нагрузку на хостинг. На самом деле, это не так! Я тоже так думал до полного тестирования и убедился, что нагрузка будет незначительной даже при запросе около 5000 данных через эту функцию. Так что не верьте людям, которые говорят, что bloginfo() или get_bloginfo() перегружают сервер!

Если вы не укажете параметр $show, будет отображено название блога. Если указать неизвестные значения, то также будет отображено название блога.

Производительность:

• 1 раз — 0.00021 сек (быстро)
• 50000 раз — 6.78 сек (быстро)

Возвращаемое значение

Функция возвращает null (ничего).

Использование

Синтаксис функции:

bloginfo( $show );

Параметр $show (строка)

Это информация о сайте, которую вы хотите отобразить. Возможные значения:

• name — Название сайта.
• description — Описание сайта.
• template_url — URL директории активной темы.
• stylesheet_url — URL основного CSS файла (обычно style.css) активной темы.
• rss2_url — URL RSS-ленты версии 2.0 (/feed).
• comments_rss2_url — URL RSS-ленты комментариев версии 2.0 (/comments/feed).
• pingback_url — URL файла XML-RPC для обратных ссылок (xmlrpc.php).
• charset — Кодировка сайта. Важно! Этот параметр всегда возвращает UTF-8, который является стандартной кодировкой для WordPress.
• version — Версия WordPress, которую вы используете.
• html_type — Тип контента HTML-страниц WordPress (по умолчанию: "text/html").
• language — Язык WordPress, например, ru-RU.

Редко используемые параметры:

• stylesheet_directory — URL директории стилей активной темы. Лучше испо��ьзовать get_stylesheet_directory_uri().
• template_directory — URL директории шаблона активной темы. Лучше использовать get_template_directory().
• admin_email — Электронный адрес, заданный в Настройки > Общие.
• rdf_url — URL RDF/RSS 1.0 ленты (/feed/rdf).
• rss_url — URL RSS 0.92 ленты (/feed/rss).
• atom_url — URL Atom ленты (/feed/atom).
• url — URL сайта (адрес WordPress в Настройки > Общие). То же самое, что и home_url().
• wpurl — URL WordPress (адрес WordPress в Настройки > Общие). То же самое, что и site_url().

Устаревшие параметры:

• home — Устарел с версии 2.2. Используйте home_url() вместо него.
• siteurl — Устарел с версии 2.2. Используйте site_url() вместо него.

По умолчанию: ''

Примеры использования

Пример 1: Отображение названия сайта в теге <H1>

Пример 2: Отображение кодировки сайта

Charset: 

Пример 3: Отображение описания сайта

Пример 4: Различия между bloginfo() и get_bloginfo()

Если вы используете bloginfo() как переменную, например:

$url = bloginfo('url');

это вернет null, потому что bloginfo() выводит результат сразу. Чтобы использовать значение из bloginfo() как переменную, используйте get_bloginfo(). Эта функция возвращает результат в виде строки.

Пример 5: Примерный вывод значений

При использовании может выводиться информация, как в следующем примере:

admin_email          = email@example.com
atom_url             = http://www.example.com/home/feed/atom
charset              = UTF-8
description          = Просто еще один блог на WordPress
name                 = Тестовый блог
url                  = http://www.example.com/home
version              = 3.5

Пример 6: Скрытие описания, если оно пустое

Практический пример, который можно использовать в темах:

Заметки

• Для возможных значений параметра $show смотрите функцию get_bloginfo().

Изменения

• С версии 0.71 — введена в WordPress.

function bloginfo( $show = '' ) {
    echo get_bloginfo( $show, 'display' );
}

Теперь вы знаете, как использовать bloginfo() в WordPress для отображения различных данных о вашем сайте. Это мощный инструмент, который поможет вам настраивать и изменять ваш сайт так, как вы хотите.