WordPress.org

Codex

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

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

Описание

Возвращает информацию о вашем сайте, которая может быть использована в любом месте php-кода. Эта функция, так же, как и bloginfo(), может быть использована для отображения информации о сайте в любом шаблоне.

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

 <?php $bloginfo get_bloginfo$show$filter ); ?> 

Параметры

$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').
$filter
(string) (Необязательный) Ключевое слово, определяющее способ фильтрации полученных данных.
Default: raw
  • 'display' - Пропускает значение $show через функцию wptexturize() перед возвращением.
  • 'raw' - Возвращает значение $show как есть.

Примеры

Использование по умолчанию

При использовании по умолчанию возвращается название сайта, сохраним его в переменной $blog_title.

 <?php $blog_title = get_bloginfo(); ?>

Название сайта

В этом примере название сайта сохраняется в переменную $blog_title. Результат тот же самый, что и при использовании по умолчанию.

 <?php $blog_title = get_bloginfo('name'); ?>

Описание сайта

Использование следующего примера:

 <?php echo 'Your Blog Tagline is: ' . get_bloginfo ( 'description' );  ?><br />

приведет к тому, что в вашем блоге будет показано:

 Your Blog Tagline is: All things WordPress

Описание сети

Используя этот пример, вы можете получить название и описание домашней сети:

 <?php
 switch_to_blog(1);
 $site_title = get_bloginfo( 'name' );
 $site_url = network_site_url( '/' );
 $site_description = get_bloginfo( 'description' );
 restore_current_blog();
 echo 'The Network Home URL is: ' . $site_url;
 echo 'The Network Home Name is: ' . $site_title;
 echo 'The Network Home Tagline is: ' . $site_description;  
?>

В результате на вашем сайте будет выведено:

 The Network Home URL is: http://example.com/
 The Network Home Name is: Example
 The Network Home Tagline is: The example site

Директория шаблонов

Возвращает URL директории шаблонов для активной темы.

Вывод

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

Заметьте, URLs директорий не имеют на конце слешей.

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

Исходный код

Файл с кодом get_bloginfo() расположен в wp-includes/general-template.php.

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