WordPress.org

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Теги шаблонов/bloginfo

Описание

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

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

 <?php bloginfo$show ); ?> 

Параметры

$show
(string) (необязательный) Какую именно информацию вы хотите получить.
Default: name
  • 'name' - Показывает "Название сайта", установленное в Настройки > Общие настройки. Эти данные извлекаются из записи "blogname" в таблице wp_options.
  • 'description' - Показывает "Краткое описание", установленное в Настройки > Общие настройки. Эти данные извлекаются из записи "blogdescription" в таблице wp_options.
  • 'wpurl' - Показывает "Адрес WordPress (URL)", установленный в Настройки > Общие настройки. Эти данные извлекаются из записи "siteurl" в таблице wp_options. Обратите также внимание на site_url(), особенно для многосайтовых конфигураций (вернет корень сайта, а не текущего поддомена).
  • 'url' - Показывает "Адрес сайта (URL)", установленный в Настройки > Общие настройки. Эти данные извлекаются из записи "home" в таблице wp_options. Рассмотрите также использование home_url().
  • 'admin_email' - Показывает "E-mail", установленный в Настройки > Общие настройки. Эти данные извлекаются из записи "admin_email" таблицы wp_options.
  • 'charset' - Показывает кодировку, установленную в Настройки > Чтение. Эти данные извлекаются из записи "blog_charset" таблицы wp_options. Примечание: В версии 3.5.0 и более поздних кодировкой больше нельзя управлять из панели администрирования. Установлена "utf-8", которая является кодировкой WordPress по умолчанию.
  • 'version' - Показывает версию WordPress. Эти данные извлекаются из переменной $wp_version, установленной в wp-includes/version.php.
  • 'html_type' - Показывает Content-Type HTML-страниц (по умолчанию: "text/html"). Эти данные извлекаются из записи "html_type" в таблице wp_options. Темы и плагины могут изменять значение, установленное по умолчанию, используя фильтр pre_option_html_type.
  • 'text_direction' - Показывает направление текста на HTML-страницах. Рассмотрите также использование is_rtl().
  • 'language' - Показывает язык WordPress.
  • 'stylesheet_url' - Показывает URL основного CSS-файла активной темы (обычно style.css). Рассмотрите вызов get_stylesheet_uri() как альтернативу.
  • 'stylesheet_directory' - Показывает URL директории css-файлов активной темы. (В ранних версиях возвращался локальный путь.) Рассмотрите вызов get_stylesheet_directory_uri() как альтернативу.
  • 'template_url' / 'template_directory' - URL директории активной темы('template_directory' ранее был локальным путем - до версии 2.6). Рассмотрите get_theme_root() и get_template() как альтернативы. В дочерних темах как get_bloginfo('template_url'), так и get_template() вернет директорию родительской темы. Рассмотрите вызов get_template_directory_uri() как альтернативу (для директории родительских шаблонов) или get_stylesheet_directory_uri() (для директории дочерних шаблонов).
  • 'pingback_url' - Показывает URL XML-RPC файла уведомления о ссылке на блог(xmlrpc.php).
  • 'atom_url' - Показывает URL Atom-канала (/feed/atom).
  • 'rdf_url' - Показывает URL RDF/RSS 1.0-канала (/feed/rfd).
  • 'rss_url' - Показывает URL RSS 0.92 -канала (/feed/rss).
  • 'rss2_url' - Показывает URL RSS 2.0-канала (/feed).
  • 'comments_atom_url' - Показывает URL комментариев Atom-канала (/comments/feed).
  • 'comments_rss2_url' - Показывает URL комментариев RSS 2.0-канала (/comments/feed).
  • 'siteurl' - Устарел, начиная с версии 2.2. Используйте home_url() или bloginfo('url').
  • 'home' - Устарел, начиная с версии 2.2. Используйте home_url() или bloginfo('url').

Примеры

Показать название блога

Показывает название вашего блога в тегах <h1>.

<h1><?php bloginfo('name'); ?></h1>

Показать название блога как ссылку

Показывает название вашего блога в ссылке.

<a href="<?php bloginfo('url'); ?>" title="<?php bloginfo('name'); ?>"><?php bloginfo('name'); ?></a>

Показать кодировку

Показывает кодировку, которую использует ваш блог (например, "utf-8").

Примечание: В версии 3.5 и позже используется кодировка UTF-8 и ее нельзя изменить из панели администрирования.

<p>Кодировка: <?php bloginfo('charset'); ?> </p>

Показать описание блога

Показывает слоган вашего блога, как он установлен в Настройки > Общие настройки.

<p><?php bloginfo('description'); ?> </p>

Пример вывода

Начиная с версии 2.7, если имя хоста example.com, адрес сайта (URL) показывается как http://www.example.com/home и адрес WordPress (URL) как http://www.example.com/home/wp.

Пожалуйста, заметьте, что URL директорий не имеют на конце слешей.

admin_email          = admin@example.com
atom_url             = http://www.example.com/home/feed/atom
charset              = UTF-8
comments_atom_url    = http://www.example.com/home/comments/feed/atom
comments_rss2_url    = http://www.example.com/home/comments/feed
description          = Just another WordPress blog
home                 = http://www.example.com/home (DEPRECATED! use url option instead)
html_type            = text/html
language             = en-US
name                 = Testpilot
pingback_url         = http://www.example.com/home/wp/xmlrpc.php
rdf_url              = http://www.example.com/home/feed/rdf
rss2_url             = http://www.example.com/home/feed
rss_url              = http://www.example.com/home/feed/rss
siteurl              = http://www.example.com/home (DEPRECATED! use url option instead)
stylesheet_directory = http://www.example.com/home/wp/wp-content/themes/largo
stylesheet_url       = http://www.example.com/home/wp/wp-content/themes/largo/style.css
template_directory   = http://www.example.com/home/wp/wp-content/themes/largo
template_url         = http://www.example.com/home/wp/wp-content/themes/largo
text_direction       = ltr
url                  = http://www.example.com/home
version              = 3.5
wpurl                = http://www.example.com/home/wp

Примечания

История изменений

  • Появился начиная с версии: 0.71

Исходный код

Исходный код bloginfo() находится в wp-includes/general-template.php.

Связанные ссылки

Теги URL директорий

WordPress Directories:
home_url() Home URL http://www.example.com
site_url() Site directory URL http://www.example.com or http://www.example.com/wordpress
admin_url() Admin directory URL http://www.example.com/wp-admin
includes_url() Includes directory URL http://www.example.com/wp-includes
content_url() Content directory URL http://www.example.com/wp-content
plugins_url() Plugins directory URL http://www.example.com/wp-content/plugins
theme_url() Themes directory URL (#18302) http://www.example.com/wp-content/themes
wp_upload_dir() Upload directory URL (returns an array) http://www.example.com/wp-content/uploads