Получение метаданных сайта с помощью функции GET_SITE_META()

Функция GET_SITE_META() используется для получения метаданных сайта в WordPress. Метаданные — это дополнительная информация о сайте, которая может хранить различные значения, такие как название, описание и другие настройки.

Без хуков

Эта функция не использует хуки, поэтому вызывается напрямую.

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

Функция может возвращать разные значения в зависимости от переданных аргументов:

• Массив значений — если параметр $single установлен в false.
• Одно значение — если параметр $single установлен в true.
• false — если передан неверный ID сайта (например, нечисловое значение, ноль или отрицательное число).
• Пустой массив — если передан корректный, но несуществующий ID сайта и $single установлен в false.
• Пустая строка — если передан корректный, но несуществующий ID сайта и $single установлен в true.

Использование

Синтаксис функции:

get_site_meta( $site_id, $key, $single );

Параметры:

• $site_id (int) (обязательный) — ID сайта.
• $key (string) — ключ метаданных для получения. По умолчанию возвращает данные для всех ключей.
  • По умолчанию: ''
• $single (true|false) — указывает, нужно ли возвращать одно значение или массив. Этот параметр не влияет, если $key не задан.
  • По умолчанию: false

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

Пример 1: Получение метаданных сайта по ID

// Получаем метаданные сайта с ID 17 и сохраняем в переменной
$blog_meta = get_site_meta( 17, 'mykey', true );

Пример 2: Получение всех значений метаданных

// Получаем все значения метаданных (с тем же ключом) в виде массива
$blog_meta = get_site_meta( 14, 'mykey' );

Пример 3: Получение всех метаданных сайта

// Получаем все метаданные сайта с ID 115 в виде массива
$blog_metas = get_site_meta( 115 );

Изменения

С версии 5.1.0 добавлена возможность использования данной функции.

Код функции

Вот как выглядит код функции get_site_meta():

function get_site_meta( $site_id, $key = '', $single = false ) {
return get_metadata( 'blog', $site_id, $key, $single );
}

Связанные функции

Если вы хотите работать с метаданными, могут быть полезны следующие функции:

• add_comment_meta()
• add_metadata()
• add_post_meta()
• delete_comment_meta()
• get_comment_meta()
• get_post_meta()
• и многие другие.

Заключение

Функция GET_SITE_META() полезна для работы с метаданными вашего WordPress-сайта. С помощью этой функции вы сможете извлекать различную информацию о сайте, что может помочь вам настраивать его под свои нужды.