Функция get_bloginfo() в WordPress используется для получения информации о текущем сайте. Она возвращает различные данные, такие как название сайта, URL, описание, версия WordPress, и другие параметры, которые можно настроить через админку WordPress.
get_bloginfo( string $show = '', string $filter = 'raw' ): string
Параметры:
$show(строка, необязательный): Название параметра, информацию о котором нужно получить. Если параметр не указан, по умолчанию возвращается название сайта.Некоторые возможные значения:'name'— Название сайта (Настройки > Общие)'description'— Описание сайта (Настройки > Общие)'wpurl'— URL WordPress (Настройки > Общие)'url'— Адрес сайта (Настройки > Общие)'admin_email'— Email администратора (Настройки > Общие)'version'— Текущая версия WordPress- И другие (см. полный список ниже).
$filter(строка, необязательный): Как фильтровать выводимую информацию. По умолчанию используется'raw'(без фильтрации). Можно указать'display', если нужно отфильтровать через встроенные фильтры WordPress.
Возвращаемое значение:
string— Строка с запрошенной информацией о сайте.
Пример 1: Получение названия сайта
Простейший пример использования функции — получение названия сайта:
<?php
$site_title = get_bloginfo( 'name' );
echo 'Название сайта: ' . $site_title;
?>
Этот код выведет название вашего сайта, которое можно настроить в админке WordPress (Настройки > Общие).
Пример 2: Получение URL сайта и его описания
Функция также позволяет получить URL и описание сайта, которые также можно настроить в админке.
<?php
$site_url = get_bloginfo( 'url' );
$site_description = get_bloginfo( 'description' );
echo 'URL сайта: ' . $site_url . '<br>';
echo 'Описание сайта: ' . $site_description;
?>
Пример 3: Получение версии WordPress
Функция get_bloginfo() может быть полезна для получения информации о версии WordPress, что особенно актуально при проверке совместимости плагинов или тем.
<?php
$wp_version = get_bloginfo( 'version' );
echo 'Текущая версия WordPress: ' . $wp_version;
?>
Пример 4: Получение кодировки сайта
Получить кодировку сайта, которая используется для страниц и RSS-лент, также можно с помощью get_bloginfo():
<?php
$charset = get_bloginfo( 'charset' );
echo 'Кодировка сайта: ' . $charset;
?>
Пример 5: Получение информации о текущей теме
Функция позволяет получать информацию о директориях и файлах активной темы.
<?php
$stylesheet_url = get_bloginfo( 'stylesheet_url' );
$template_directory = get_bloginfo( 'template_directory' );
echo 'URL файла стилей темы: ' . $stylesheet_url . '<br>';
echo 'Директория темы: ' . $template_directory;
?>
Пример 6: Получение информации о сайте в виде массива
Можно собрать информацию о нескольких параметрах сайта в виде массива:
<?php
function get_site_info_array() {
$fields = array( 'name', 'description', 'url', 'admin_email', 'version', 'charset' );
$info = array();
foreach ( $fields as $field ) {
$info[$field] = get_bloginfo( $field );
}
return $info;
}
$site_info = get_site_info_array();
print_r( $site_info );
?>
Пример 7: Получение информации для сети сайтов
Если у вас настроена мультисайтовая сеть, вы можете использовать get_bloginfo() для получения информации о главном сайте сети.
<?php
switch_to_blog(1); // Переход на блог с ID 1
$network_name = get_bloginfo( 'name' );
$network_description = get_bloginfo( 'description' );
restore_current_blog(); // Возвращаемся к текущему блогу
echo 'Название сети: ' . $network_name . '<br>';
echo 'Описание сети: ' . $network_description;
?>
Полный список доступных параметров для $show
name— Название сайтаdescription— Описание сайтаwpurl— URL WordPress (админка)url— Главный URL сайтаadmin_email— Email администратораcharset— Кодировка сайтаversion— Версия WordPresshtml_type— Тип контента HTMLtext_direction— Направление текста (ltr или rtl)language— Язык сайтаstylesheet_url— URL файла стилей активной темыtemplate_directory— Директория активной темыpingback_url— URL для пингбэковrss_url— URL RSS лентыcomments_rss2_url— URL RSS ленты комментариев
Заключение
Функция get_bloginfo() — это мощный инструмент для получения информации о текущем сайте в WordPress. Она позволяет получить основные параметры, необходимые для отображения информации о сайте, а также используется при разработке тем и плагинов.