get_term_meta()
Отримує значення зазначеного мета поля елемента таксономії (рубрики, мітки тощо). Можна отримати всі значення як масиву.
Функція працює аналогічно get_post_meta() , за винятком того, що отримує довільні поля елементів таксономії, а не постів.
Також, є різниця в тому, що для елемента таксономії немає адмін-інтерфейсу для додавання полів. Для цього потрібно використовувати функції: update_term_meta() .
get_metadata()
(швидко) | 50000 разів – 0.20 сек
(дуже швидко) |
PHP 7.1.2, WP 4.7.3
Хуків немає.
Повертає
Разное. – Якщо $ single = false , то масив значень зазначеного мета поля. Якщо значень немає, то порожній масив array().
- Якщо $single = true , то окреме значення зазначеного метаполя (перше в масиві), воно може бути будь-яким (рядком, числом, об’єктом, масивом).
Використання
get_term_meta ($ term_id, $ key, $ single);
- $term_id
(число) (обов’язковий) - ID елемент таксономії.
- $key
(рядок) - Ключ мета поля.
За замовчуванням: ” - $single
(логічний) Як повертати значення.
false– масив значеньtrue– єдине значення (перше з масиву, якщо значень кілька)
Типово: false
Приклади
#1 Отримаємо всі значення мета поляtest_meta_field
$fields = get_term_meta( 10 , 'test_meta_field', false );
if( $fields ){
print_r($fields);
/* виведе
Array
(
[0] => Привіт світ
[1] => Hello world
)
*/
}
else {
// метаданих немає...
}
#2 Отримуємо єдине значення мета поля на сторінці елемента таксономії
Допустимо у нас у метаполі test_meta_fieldрубрики 65 міститься рядок Какой хороший деньі нам потрібно вивести цей рядок на сторінці рубрики.
// поточна рубрика, припустимо ми зайшли до рубрики 65
$term_id = get_query_var('cat');
echo get_term_meta ($ term_id, 'test_meta_field', true);
// виведе: Який добрий деньІнший спосіб. Ми можемо використовувати функцію get_queried_object_id() , щоб отримати ідентифікатор поточної категорії.
// Usage in archive або category (taxonomy) template $term_id = get_queried_object_id(); echo get_term_meta ($ term_id, 'test_meta_field', true);
список змін
| З версії 4.4.0 | Введено. |
Код get_term_meta() get term meta WP 6.0.2
function get_term_meta( $term_id, $key = '', $single = false ) {
return get_metadata('term', $term_id, $key, $single);
}