Codex

Function Reference/get the category

Languages: English • 日本語 • (Add your language)

Contents

Description

Returns an array of objects, one object for each category assigned to the post. This tag may be used outside The Loop by passing a post id as the parameter.

This function only returns results from the default "category" taxonomy. For custom taxonomies use get_the_terms.

Usage 

<?php get_the_category( $id ) ?>

Parameters

id
(integer) (optional) The post id.
Default: $post->ID (The current post ID)

Examples

Show Category Images

This outputs category images named after the cat_ID with the alt attribute set to cat_name. You can also use any of the other member variables instead. 

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

Show the First Category Name Only

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

(Echoes the first array ([0]) of $category.)

Make the first category link to the category page. 

<?php 
$category = get_the_category(); 
if($category[0]){
echo '<a href="'.get_category_link($category[0]->term_id ).'">'.$category[0]->cat_name.'</a>';
}
?>

Get the Post Categories From Outside the Loop

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

Member Variables in Returned Objects

cat_ID 
the category id (also stored as 'term_id')
cat_name 
the category name (also stored as 'name')
category_nicename 
a slug generated from the category name (also stored as 'slug')
category_description 
the category description (also stored as 'description')
category_parent 
the category id of the current category's parent. '0' for no parents. (also stored as 'parent')
category_count 
the number of uses of this category (also stored as 'count')

Changelog

Source Code

Related

Categories: the_category(), the_category_rss(), single_cat_title(), category_description(), wp_dropdown_categories(), wp_list_categories(), get_the_category(), get_the_category_by_ID(), get_category_by_slug(), get_the_category_list(), get_category_parents(), get_category_link(), is_category(), in_category()

See also index of Function Reference and index of Template Tags.
Retrieved from "http://codex.wordpress.org/Function_Reference/get_the_category"

Codex Resources