Функция: get_bloginfo
Функция get_bloginfo возвращает информацию о блоге для дальнейшего использования в PHP. Ее также можно использовать аналогично функции bloginfo для отображения информации о блоге в браузере.
<?php $bloginfo = get_bloginfo($show, $filter); ?> |
<?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(); ?> |
<?php $blog_title = get_bloginfo(); ?>
Данный код эквивалентен вышеприведенному и тоже присваивает переменной $blog_title заголовок блога.
<?php $blog_title = get_bloginfo('name'); ?> |
<?php $blog_title = get_bloginfo('name'); ?>
2. Описание блога
Данный код выведет краткую информацию о блоге ("Параметры\Общие\Краткое описание").
<?php echo 'Краткое описание: ' . get_bloginfo ('description'); ?><br /> |
<?php echo 'Краткое описание: ' . get_bloginfo ('description'); ?><br />
3. Использование параметра $filter
Предположим, что краткое описание блога будет таким:
Это --- описание блога. |
Это --- описание блога.
Данный код:
<?php echo get_bloginfo ('description'); ?> |
<?php echo get_bloginfo ('description'); ?>
Выведет описание блога в неизменном виде, то есть:
Это --- описание блога. |
Это --- описание блога.
Если же задать параметр $filter как display:
<?php echo get_bloginfo ('description', 'display'); ?> |
<?php echo get_bloginfo ('description', 'display'); ?>
То функция вернет обработанное значение в виде:
Это — описание блога. |
Это — описание блога.
То есть символы "---" будут заменены на символ "—" (—).
Различные результаты возвращаемых значений функции (блог установлен в корневую папку сайта и поэтому '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 |
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
Теги информации о блоге: bloginfo, get_bloginfo, bloginfo_rss, get_bloginfo_rss
Понравился пост? Подпишись на обновления по RSS или Twitter !
#1,
Очень помог материал для вывода картинок в материалах.
теперь url формируется
Теперь не нужно парится, работаю я на localhos'е или на домене. Очень полезная информация. Спс.