get_category()
Отримує дані вказаної категорії.
Якщо передати $categoryоб’єкт, який містить інформацію про категорію, параметр буде закешований.
Якщо передати до параметра $categoryID категорії, дані категорії будуть отримані з бази даних або з кешу, якщо вона є.
Дані категорії будуть перетворені для підтримки зворотної сумісності (в масив буде вбудовано аналогічні параметри term).
Зверніть увагу на функцію get_term() , яка ідентична get_category. З її допомогою можна отримати дані іншої, відмінної від categoryтаксономії.
Працює на основі:
get_term()
get_term()
1 раз – 0.000443 сек
(швидко) | 50000 разів – 0.92 сек
(дуже швидко) |
PHP 7.0.5, WP 4.5.1
(швидко) | 50000 разів – 0.92 сек
(дуже швидко) |
PHP 7.0.5, WP 4.5.1
Хуків немає.
Повертає
Объект|Массив|WP_Error|null.
- Дані категорії у вигляді зазначений у параметрі $output .
WP_Error– Якщо категорія порожня.null– якщо категорії немає.
Використання
$ cat = get_category ($ category, $ output, $ filter);
- $category
(число) (обов’язковий) - ID категорії або об’єкт, що містить дані про категорію.
- $output
(константа) Яким видом масиву повертати дані:
OBJECT– Об’єкт;ARRAY_A– Асоціативний масив;ARRAY_N– Індексований масив.
Типово: OBJECT
- $filter
(рядок) - Фільтр (що за фільтр я точно не зрозумів).
За замовчуванням: ‘raw’
Приклади
#1 Виведемо на екран дані категорії, на сторінці якої ми знаходимося (поточної):
$thisCat = get_category( get_query_var('cat') );
print_r($thisCat);В результаті ми побачимо щось подібне:
stdClass Object ( [term_id] => 85 [name] => Category Name [slug] => category-name [term_group] => 0 [term_taxonomy_id] => 85 [taxonomy] => category [description] => [parent] => 70 [count] => 0 [cat_ID] => 85 [category_count] => 0 [category_description] => [cat_name] => Category Name [category_nicename] => category-name [category_parent] => 70 )
список змін
| З версії 1.5.1 | Введено. |
Код get_category() get category WP 6.0.2
function get_category( $category, $output = OBJECT, $filter = 'raw' ) {
$category = get_term( $category, 'category', $output, $filter);
if ( is_wp_error( $category ) ) {
return $category;
}
_make_cat_compat( $category );
return $category;
}