Функции WordPress: bloginfo()

Этим постом я начинаю большую серию по функциям WordPress. Задумка получить в итоге подобие F.A.Q. в одном месте.
Начнем с функции bloginfo().

Показывает информацию о вашем сайте, в основном взятую из профиля пользователя и общих настроек в панели администрирования WordPress. Можно использовать в любом месте шаблона.
Параметр по умолчанию name – название сайта.
Возможные параметры функции bloginfo():

• ‘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).

Пример использования bloginfo():

<img src="<?php bloginfo('template_directory'); ?>/images/logo.png" alt="<?php bloginfo('name'); ?>" />

Здесь выводится логотип из папки images нашей темы c названием сайта в alt.