Функция GET_BLOGINFO() │ WP 0.71

Функция get_bloginfo() возвращает информацию о текущем сайте.

Возможные параметры для $show:

• 'name' - Заголовок сайта (устанавливается в разделе Настройки > Основные).
• 'description' - Подзаголовок сайта (устанавливается в разделе Настройки > Основные).
• 'wpurl' - Адрес WordPress (URL) (устанавливается в разделе Настройки > Основные).
• 'url' - Адрес сайта (URL) (устанавливается в разделе Настройки > Основные).
• 'admin_email' - Электронная почта администратора (устанавливается в разделе Настройки > Основные).
• 'charset' - Кодировка для страниц и лент (устанавливается в разделе Настройки > Чтение).
• 'version' - Текущая версия WordPress.
• 'html_type' - Тип содержимого (по умолчанию: "text/html"). Темы и плагины могут переопределить это значение с помощью фильтра pre_option_html_type.
• 'text_direction' - Направление текста, определяемое языком сайта. Вместо этого следует использовать is_rtl().
• 'language' - Код языка для текущего сайта.
• 'stylesheet_url' - URL к таблице стилей для активной темы. Если используется дочерняя тема, она будет иметь приоритет.
• 'stylesheet_directory' - Путь к директории активной темы. Дочерняя тема также будет иметь приоритет.
• 'template_url' - URL директории активной темы. Дочерняя тема не будет иметь приоритет.
• 'pingback_url' - URL для pingback (файл xmlrpc.php).
• 'atom_url' - URL Atom ленты (/feed/atom).
• 'rdf_url' - URL RDF/RSS 1.0 ленты (/feed/rdf).
• '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).

Некоторые значения $show устарели и будут удалены в будущих версиях. Эти параметры вызовут функцию _deprecated_argument().

Устаревшие параметры:

• 'siteurl' - Используйте 'url' вместо.
• 'home' - Используйте 'url' вместо.

Использование функции

get_bloginfo( $show, $filter );

• $show (string) - Информация о сайте, которую необходимо получить. По умолчанию: пустая строка (название сайта).
• $filter (string) - Как обрабатывать полученные данные. По умолчанию: 'raw'.

Примеры использования

Пример 1: Получение имени сайта

$blog_title = get_bloginfo();
echo $blog_title;

Функция вернёт то же самое, если написать так:

$blog_title = get_bloginfo('name');

Возможный пример использования функции в шаблоне WordPress:

echo 'Краткое описание блога: ' . get_bloginfo('description', 'display');

Результат: На экране появится текст: "Краткое описание блога: <здесь описание>".

Пример 2: Получение всей информации о сайте

Существуют способы получить массив всей доступной информации. Хотя это может быть не самым эффективным с точки зрения производительности, это может помочь тем, кто хочет собрать всю информацию о сайте.

function bloginfo_array() {
    $fields = array(
        'name', 'description', 'wpurl', 'url', 'admin_email', 
        'charset', 'version', 'html_type', 'text_direction', 'language'
    );
    $data = array();

    foreach( $fields as $field ) {
        $data[ $field ] = get_bloginfo( $field );
    }

    return $data;
}

Обратите внимание, что я опустил некоторые поля, которые могут быть не столь важны.

Пример 3: Использование различных параметров

Можно передать следующие параметры в функцию $show и что они вернут:

Пример 4: Получение информации для сетевого заголовка

Используйте данный пример, чтобы получить имя и описание для главной страницы сети.

switch_to_blog(1);
$site_title = get_bloginfo('name');
$site_url = network_site_url('/');
$site_description = get_bloginfo('description');
restore_current_blog();

echo 'URL главной страницы сети: ' . $site_url;
echo 'Имя главной страницы сети: ' . $site_title;
echo 'Описание главной страницы сети: ' . $site_description;

Результат: На вашем блоге отобразится информация о главной странице сети.

Пример 5: Получение подзаголовка блога

Используя следующий пример:

printf(
    esc_html__('Ваше описание блога: %s', 'textdomain'), 
    get_bloginfo('description')
);

Результат: Отобразится текст: "Ваше описание блога: Все о WordPress".

Примечания

• Глобальная переменная string $wp_version хранит строку версии WordPress.

Изменения

С версии 0.71 функция была введена.