WordPress как на ладони
rgbcode is looking for WordPress developers.

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

Хуков нет.

Возвращает

Объект|Массив|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

#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() WP 6.4.3

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;
}
2 комментария
    Войти