WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

get_category() WP 1.5.1

Получает данные указанной категории.

Если передать в параметр $category объект содержащий информацию о категории, эти данные будут закешированны.

Если передать в параметр $category ID категории, данные категории будут получены из базы данных или из кеша, если он есть.

Данные категории будут преобразованы для поддержки обратной совместимости (в массив будут встроены аналогичные параметры term).

Обратите внимание на функцию get_term(), которая идентична get_category. С её помощью можно получить данные другой, отличной от category, таксономии.

Работает на основе: get_term()
✈ 1 раз = 0.000443с = быстро | 50000 раз = 0.92с = очень быстро | PHP 7.0.5, WP 4.5.1

Хуков нет.

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

$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
)

Заметки

  • Использует функцию get_term()

Список изменений

С версии 1.5.1 Введена.

Код get category: wp-includes/category.php WP 5.4.2

<?php
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;
}

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

Из раздела: Рубрики

3 коммента
  • Чем отличаются свойства объекта категории count и category_count?

    Кусок дампа get_category() в моей теме

      public 'count' => int 124
      public 'category_count' => int 124

    пошерстил документацию, не нашел ничего

    Ответить24.Авг.2018 14:31 #
    • Mm

      С этим же вопросом сюда пришел)
      Похоже просто для совместимости оставили.

      Ответить20.Май.2020 14:40 #
      • @ campusboy3542 www.youtube.com/c/wpplus

        Здравствуйте. Да, Вы правы, для совместимости, за это отвечает функция _make_cat_compat. По коду функции понятно, какие свойства старые (слева) и какие новые (справа). Ну как новые... сложно сейчас будет найти сайт с такой версией WP, где использовалось бы старое наименование свойств.

        1
        Ответить20.Май.2020 17:31 #