Функция: get_bloginfo

07.04.2012
Описание

Функция get_bloginfo возвращает информацию о блоге для дальнейшего использования в PHP. Ее также можно использовать аналогично функции bloginfo для отображения информации о блоге в браузере.

Использование
<?php $bloginfo = get_bloginfo($show, $filter); ?>
Параметры

$show

(строка) (необязательный) определяет какую именно информацию должна вернуть функция get_bloginfo. Значения могут быть:

'name' - название блога, берется из "Параметры\Общие\Заголовок сайта".

'description' - описание блога, берется из "Параметры\Общие\Краткое описание".

'url' - адрес блога, берется из "Параметры\Общие\Адрес сайта (URL)". параметр 'url' заменил устаревший и не рекомендуемый больше к использованию параметр 'siteurl'.

'wpurl' - адрес WordPress (папка, в которую установлен блог), берется из "Параметры\Общие\Адрес WordPress (URL)". параметр 'wpurl' заменил устаревший и не рекомендуемый больше к использованию параметр 'home'.

'charset' - кодировка блога, берется из "Параметры\Чтение\Кодировка страниц и лент".

'html_type' - контент-тип HTML страниц, создаваемых WordPress. по умолчанию имеет значение text/html. шаблоны и плагины могут заменить значение по умолчанию при использовании фильтра pre_option_html_type.

'language' - язык блога, берется из файла wp-config.php.

'admin_email' - имейл администратора блога, берется из "Параметры\Общие\Адрес e-mail".

'version' - версия WordPress, значение берется из переменной $wp_version в файле wp-includes/version.php.

'text_direction' - направление текста, ltr - слева направо и rtr - справа налево.

'stylesheet_directory' - урл папки в блоге, где находится файл стилей текущего шаблона.

'stylesheet_url' - урл файла стилей текущего шаблона в блоге.

'template_directory' и 'template_url' - урл папки текущего шаблона в блоге ('template_directory' до версии 2.6 возвращал локальный путь до папки).

'rdf_url' - ссылка на RDF/RSS 1.0 ленту.

'pingback_url' - ссылка на файл XML-RPC.

'rss2_url' - ссылка на RSS 2.0 ленту.

'rss_url' - ссылка на RSS 0.92 ленту.

'atom_url' - ссылка на Atom ленту.

'comments_rss2_url' - ссылка на RSS 2.0 ленту комментариев.

'comments_atom_url' - ссылка на Atom ленту комментариев.

При использовании некорректного (или незаданного) значения параметра $show функция get_bloginfo всегда будет возвращать заголовок блога.

$filter

(строка) (необязательный) определяет фильтр, через который должны проходить возвращаемые функцией значения. raw выдаст результат неизменным, а display обработает возвращаемые значения функцией [[wptexturize]] (будут вырезаны или заменены все спец-символы).

  • display
  • raw - по умолчанию
Примеры

1. Заголовок блога

Следующий код присваивает переменной $blog_title заголовок блога.

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

Данный код эквивалентен вышеприведенному и тоже присваивает переменной $blog_title заголовок блога.

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

2. Описание блога

Данный код выведет краткую информацию о блоге ("Параметры\Общие\Краткое описание").

<?php echo 'Краткое описание: ' . get_bloginfo ('description'); ?><br />

3. Использование параметра $filter

Предположим, что краткое описание блога будет таким:

Это --- описание блога.

Данный код:

<?php echo get_bloginfo ('description');  ?>

Выведет описание блога в неизменном виде, то есть:

Это --- описание блога.

Если же задать параметр $filter как display:

<?php echo get_bloginfo ('description', 'display');  ?>

То функция вернет обработанное значение в виде:

Это — описание блога.

То есть символы "---" будут заменены на символ "—" (&#8212;).

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

Различные результаты возвращаемых значений функции (блог установлен в корневую папку сайта и поэтому 'url' и 'wpurl' совпадают):

name = TestBlog.Ru
description = Тестовый блог
url = http://www.testblog.ru
wpurl = http://www.testblog.ru
 
charset = UTF-8
html_type = text/html
language = ru-RU
admin_email = admin@testblog.ru
version = 3.3.1
text_direction = ltr
 
stylesheet_directory = http://www.testblog.ru/wp-content/themes/default
stylesheet_url = http://www.testblog.ru/wp-content/themes/default/style.css
template_directory = http://www.testblog.ru/wp-content/themes/default
template_url = http://www.testblog.ru/wp-content/themes/default
 
rdf_url = http://www.testblog.ru/feed/rdf
pingback_url = http://www.testblog.ru/xmlrpc.php
 
rss2_url = http://www.testblog.ru/feed
rss_url = http://www.testblog.ru/feed/rss
atom_url = http://www.testblog.ru/feed/atom
comments_rss2_url = http://www.testblog.ru/comments/feed
comments_atom_url = http://www.testblog.ru/comments/feed/atom

Ссылки на RSS ленты различны при разной структуре постоянных ссылок ("Параметры\Постоянные ссылки\"), в данном случае результаты получены при произвольной структуре ссылок: /%category%/%postname%.html.

Лог изменений

Функция добавлена в версии 0.71

Исходный файл

Функция get_bloginfo() находится в wp-includes/general-template.php

Связанные теги|функции
Рубрики: Теги шаблоновФункции WordPressУсловные теги

Понравился пост? Подпишись на обновления по Обновления блога по RSSRSS или Обновления блога на TwitterTwitter !

Комментарии (всего 1 комментарий)
Написать комментарий

(обязательно)

(обязательно, не публикуется)

Для вставки кода используйте кнопку "Код", по умолчанию используется синтаксис подсветки языка "php", вы можете поменять его на любой другой поддерживаемый GeSHi язык, например "javascript", "css", "html4strict", "sql" и тд. Используйте предпросмотр!
 


Подписаться на уведомления без комментирования.