get_the_category с версии 0.71

Описание

Получает массив данных о категориях, относящихся к посту.

Функцию можно использовать за пределами Цикла WordPress, если указать ID поста.

get_the_category() работает на базе get_the_terms().

Функция возвращает массив объектов с данными о каждой категории, которая относится к посту. Отдельный объект для каждой категории.

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

<?php get_the_category( $id ) ?>

Параметры

$id (число)

ID поста, категори
По умолчанию: $post->ID

Примеры

1. Выведем картинку для каждой категории.
Этот пример показывает как можно создать картинку к каждой категории, в атрибуте alt будет указано название категории. Картинки должны иметь названия такие же как и ID категорий (12.jpg) и лежать в корне сайта в папке images. Код нужно использовать внутри Цикла:

<?php
foreach((get_the_category()) as $category) {
    echo '<img src="http://example.com/images/' . $category->cat_ID . '.jpg" alt="' . $category->cat_name . '" />';
}
?>

2. Показать название только первой категории (если пост относится к нескольким категориям):

<?php
$category = get_the_category();
echo $category[0]->cat_name;
?>

3. Пример как получить категории поста за пределами Цикла WordPress:

<?php
global $post;
$categories = get_the_category($post->ID);
var_dump($categories);
?>

Данные, которые содержит каждый объект категории:

$cat = get_the_category($post->ID);
// ID категории
$cat->cat_ID
// Название категории
$cat->cat_name
// Альтернативное название категории
$cat->category_nicename
// Описание категории (задается на странице редактирования категории)
$cat->category_description
// ID родительской категории
$cat->category_parent
// Количество записей в категории
$cat->category_count

get_the_category()

function get_the_category( $id = false ) {
	$categories = get_the_terms( $id, 'category' );
	if ( ! $categories )
		$categories = array();

	$categories = array_values( $categories );

	foreach ( array_keys( $categories ) as $key ) {
		_make_cat_compat( $categories[$key] );
	}

	// Filter name is plural because we return alot of categories (possibly more than #13237) not just one
	return apply_filters( 'get_the_categories', $categories );
}

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.