wp_get_post_categories() — описание функции WordPress на русском

Сигнатура

wp_get_post_categories( int $post_id, array $args = array() ): array|WP_Error

Описание

Слой совместимости для тем и плагинов. Также удобный уровень абстракции, скрывающий сложность слоя таксономий.
См. alsowp_get_object_terms()

Оригинал (английский)

Compatibility layer for themes and plugins. Also an easy layer of abstraction away from the complexity of the taxonomy layer.

Параметры

$post_id int необязательный

ID записи. Не принимает по умолчанию ID глобального объекта $post. Значение по умолчанию 0.

$args array необязательный = array()

Category query parameters.
See WP_Term_Query::__construct() for supported arguments.

Возвращаемое значение

array|WP_Error

$fields $args 'all' 'all_with_object_id' WP_Term $fields 'ids' $fields 'names' WP_Error 'category'

Исходный код

wp-includes/post.php:4325

function wp_get_post_categories( $post_id = 0, $args = array() ) {
	$post_id = (int) $post_id;

	$defaults = array( 'fields' => 'ids' );
	$args     = wp_parse_args( $args, $defaults );

	$cats = wp_get_object_terms( $post_id, 'category', $args );
	return $cats;
}

История изменений

Версия	Описание
2.1.0	Introduced.