get_site_meta()
Отримує значення метаполя сайту у мережі мультисайт. Дозволяє також отримати всі метаполі.
Працює з таблицею wp_blogmeta, що з’явилася у версії 5.1.
Це обгортка для функції get_metadata() .
Хуків немає.
Повертає
Разное.
Якщо у значенні метаполя зберігається число воно буде повернено у вигляді рядка, наприклад, "54"…
- Поверне
false, якщо неправильно передано $site_id . - При $single = true
строка/массивколи метаполі є.''коли метаполя немає.
- $ single = false
массив значений метаполейколи метаполі є.array()коли метаполя немає.
Використання
get_site_meta ($ site_id, $ key, $ single);
-
$site_id
(число) (обов’язковий) - ID сайту/блогу.
-
$key
(рядок) -
Назва метаполя. Якщо не вказати цей параметр, буде повернуто всі значення всіх метаполів об’єкта.
За замовчуванням: ” -
$single
(true/false) Чи повернути єдине значення чи ні?
true– Поверне значення метаполя у вигляді рядка або масиву (якщо у значенні метаполя знаходиться серіалізований масив). За наявності кількох метаполів з однаковим ключем повернеться значення першого метаполя.false– Поверне масив зі значеннями всіх метаполів зазначеного ключа. В цьому випадку всі значення буде рядками, навіть коли в значенні знаходиться серіалізований масив (перетворювати його на масив потрібно вручну).Типово: false
Приклади
#1 Як використовувати
// отримаємо мета поле сайту з ID 17, відразу змінну $ blog_meta = get_site_meta (17, 'mykey', true); // Отримаємо всі значення метаполя (з однаковим ключем) як масиву $blog_meta = get_site_meta(14, 'mykey'); // Отримаємо всі метадані сайту з ID 115, як масиву $blog_metas = get_site_meta(115);
#2 Ще приклади
Дивіться опис get_post_meta() .
список змін
| З версії 5.1.0 | Введено. |
Код get_site_meta() get site meta WP 6.0.2
function get_site_meta( $site_id, $key = '', $single = false ) {
return get_metadata( 'blog', $site_id, $key, $single);
}