Функция get_blog_details() в WordPress: получение информации о блоге в мультисайтовой сети

Функция get_blog_details() предназначена для получения информации о сайте (блоге) в мультисайтовой сети WordPress. Она позволяет извлекать данные как из основной таблицы блогов, так и из таблицы настроек блога.

get_blog_details( int|string|array $fields = null, bool $get_all = true ): WP_Site|false

Параметры:

• $fields (int|string|array, необязательный) — уникальный идентификатор блога (ID), или его домен и путь в виде массива. По умолчанию используется ID текущего блога.
• $get_all (bool, необязательный) — определяет, будут ли возвращены все детали блога (true) или только данные из таблицы wp_blogs (false). По умолчанию — true.

Возвращаемое значение:

• WP_Site|false — объект WP_Site с полными деталями блога при успешном выполнении или false, если блог не найден.

Пример 1. Получение информации о текущем блоге

В этом примере get_blog_details() используется без параметров, чтобы получить сведения о текущем блоге сети.

// Получаем информацию о текущем блоге
$blog_details = get_blog_details();

// Выводим название блога
echo $blog_details->blogname;

// Выводим URL блога
echo $blog_details->siteurl;

Пример 2. Получение информации о блоге по ID

В следующем примере информация получается для блога с определенным идентификатором (например, 3).

// Получаем информацию о блоге с ID 3
$blog_details = get_blog_details(3);

if ($blog_details) {
    echo 'Название блога: ' . $blog_details->blogname;
    echo 'Домашняя страница: ' . $blog_details->home;
}

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

Также можно использовать массив с доменом и путем для получения информации о блоге.

// Получаем данные блога по домену и пути
$blog_details = get_blog_details(array(
    'domain' => 'example.com',
    'path'   => '/fr/'
));

if ($blog_details) {
    echo 'Название блога: ' . $blog_details->blogname;
    echo 'URL сайта: ' . $blog_details->siteurl;
}

Пример 4. Получение только основных данных из таблицы wp_blogs

При установке $get_all в false функция вернет данные только из таблицы wp_blogs, что может быть полезно, если требуется минимальная информация.

// Получаем основные данные о блоге с ID 5
$blog_details = get_blog_details(5, false);

if ($blog_details) {
    echo 'ID блога: ' . $blog_details->blog_id;
    echo 'Домен: ' . $blog_details->domain;
    echo 'Путь: ' . $blog_details->path;
}

Пример 5. Использование get_blog_details() для получения количества постов

Функция также возвращает значение post_count, показывающее общее количество записей в блоге.

// Получаем количество записей в блоге с ID 2
$blog_details = get_blog_details(2);

if ($blog_details) {
    echo 'Количество записей: ' . $blog_details->post_count;
}

Заключение

Функция get_blog_details() позволяет гибко получать данные о любом блоге в сети WordPress, используя различные параметры. Она помогает разработчикам легко извлекать как общие, так и детальные сведения о блогах, от имени до количества записей, что полезно при работе с мультисайтовыми сетями.