【WordPress】記事のカテゴリーを取得する方法｜get_the_category・the_category・WP_Query・カスタムタクソノミー完全ガイド

この記事で学べること

• get_the_category() でカテゴリーオブジェクトを取得する基本
• the_category() でHTMLリンクを直接出力する方法
• get_categories() で全カテゴリー一覧を取得する方法
• カテゴリーオブジェクトのプロパティ一覧と活用法
• 親子カテゴリーの階層を辿る方法
• カスタムタクソノミー対応（get_the_terms / wp_get_post_terms）
• WP_Query でカテゴリー条件を指定して記事を取得する方法
• カテゴリーに応じた条件分岐・スタイル変更の実践テクニック

<?php
// 現在の記事のカテゴリーを取得
$categories = get_the_category();

if ( $categories ) {
    foreach ( $categories as $category ) {
        echo '<a href="' . esc_url( get_category_link( $category->term_id ) ) . '">' . esc_html( $category->name ) . '</a>';
    }
}
?>

<?php
// 投稿ID: 123 のカテゴリーを取得
$categories = get_the_category( 123 );

// 最初のカテゴリー名だけ取得する
if ( ! empty( $categories ) ) {
    $first_cat = $categories[0];
    echo esc_html( $first_cat->name );  // 例: "WordPress"
}
?>

<?php
$categories = get_the_category();

if ( $categories ) {
    $cat = $categories[0];

    echo $cat->name;         // カテゴリー名: "WordPress"
    echo $cat->slug;         // スラッグ: "wordpress"
    echo $cat->term_id;      // ID: 5
    echo $cat->count;        // 記事数: 42
    echo $cat->parent;       // 親ID: 0（親なし）
    echo $cat->description;  // 説明文
}
?>

<?php
// カテゴリーID: 5 の情報を取得
$cat = get_category( 5 );
echo $cat->name;   // "WordPress"
echo $cat->count;  // 42

// スラッグからカテゴリーを取得
$cat = get_category_by_slug( 'wordpress' );
echo $cat->term_id;  // 5

// IDからカテゴリー名だけ取得（文字列で返る）
$name = get_the_category_by_ID( 5 );
echo $name;  // "WordPress"
?>

<?php
// デフォルト（各カテゴリーを <li> タグで出力）
the_category();
// 出力: <ul><li><a href="...">WordPress</a></li></ul>

// 区切り文字を指定（カンマ区切り）
the_category( ', ' );
// 出力: <a href="...">WordPress</a>, <a href="...">PHP</a>

// パイプ区切り
the_category( ' | ' );
// 出力: <a href="...">WordPress</a> | <a href="...">PHP</a>
?>

<?php
$args = array(
    'orderby'    => 'name',
    'order'      => 'ASC',
    'hide_empty' => true,  // 記事のないカテゴリーを除外
);

$categories = get_categories( $args );

foreach ( $categories as $category ) {
    $link = get_category_link( $category->term_id );
    printf(
        '<a href="%s">%s（%d件）</a>',
        esc_url( $link ),
        esc_html( $category->name ),
        $category->count
    );
}
?>

$args = array(
    'taxonomy'   => 'category',   // タクソノミー（デフォルト: category）
    'orderby'    => 'name',       // 並び順: name / count / id / slug
    'order'      => 'ASC',        // ASC / DESC
    'hide_empty' => true,         // 空カテゴリーを除外するか
    'exclude'    => '1',          // 除外するカテゴリーID（未分類を除外）
    'include'    => '',           // 含めるカテゴリーIDのみ
    'parent'     => 0,            // 親カテゴリーID（0=トップレベルのみ）
    'child_of'   => 0,            // 指定IDの子孫をすべて取得
    'number'     => '',           // 取得件数（空=無制限）
);

<?php
// 基本（<li> タグのリストを出力）
wp_list_categories( array(
    'title_li'     => '',       // デフォルトの「カテゴリー」タイトルを非表示
    'show_count'    => true,    // 記事数を表示
    'hierarchical'  => true,    // 階層構造で表示
    'hide_empty'    => true,    // 空カテゴリーを非表示
    'exclude'       => '1',     // 未分類を除外
    'depth'         => 2,       // 2階層目まで表示（0=全階層）
) );
?>

<!-- 出力例 -->
<li class="cat-item cat-item-5">
    <a href="...category/wordpress/">WordPress (42)</a>
    <ul class="children">
        <li><a href="...">テーマ (15)</a></li>
    </ul>
</li>

? 使い分け：get_categories() はデータを配列で取得して自由に加工したい場合に、wp_list_categories() はHTMLをそのまま出力して済ませたい場合に使います。

<?php
// デフォルト: IDの配列を返す
$cat_ids = wp_get_post_categories( get_the_ID() );
// 結果: array( 5, 12, 23 )

// オブジェクトとして取得することも可能
$cats = wp_get_post_categories( get_the_ID(), array( 'fields' => 'all' ) );
// 結果: array( WP_Term オブジェクト, ... )

// 名前だけ取得
$cat_names = wp_get_post_categories( get_the_ID(), array( 'fields' => 'names' ) );
// 結果: array( "WordPress", "PHP", "開発" )
?>

<?php
// 現在のカテゴリーの祖先一覧を取得（最上位が先頭）
$categories = get_the_category();

if ( $categories ) {
    $cat = $categories[0];

    // get_ancestors(): 子→親→祖父の順でIDを返す
    $ancestors = get_ancestors( $cat->term_id, 'category' );
    // 例: array( 12, 3 )  ← 親ID=12, 祖父ID=3

    // 最上位カテゴリーを取得
    if ( ! empty( $ancestors ) ) {
        $root_id  = end( $ancestors );  // 最上位のID
        $root_cat = get_category( $root_id );
        echo $root_cat->name;  // "Web開発"
    } else {
        // 親がない = 自身が最上位
        echo $cat->name;
    }
}
?>

<?php
$categories = get_the_category();

if ( $categories ) {
    // リンク付きで親カテゴリーを辿って表示
    $parents = get_category_parents(
        $categories[0]->term_id,
        true,   // リンクを付けるか
        ' > ' // 区切り文字
    );
    // 出力: <a href="...">Web開発</a> > <a href="...">WordPress</a> >

    if ( ! is_wp_error( $parents ) ) {
        echo rtrim( $parents, ' > ' );
    }
}
?>

<?php
// カスタムタクソノミー "genre" のタームを取得
$terms = get_the_terms( get_the_ID(), 'genre' );

if ( $terms && ! is_wp_error( $terms ) ) {
    foreach ( $terms as $term ) {
        $link = get_term_link( $term );
        printf(
            '<a href="%s">%s</a> ',
            esc_url( $link ),
            esc_html( $term->name )
        );
    }
}
?>

<?php
// より細かい条件を指定できる
$terms = wp_get_post_terms( get_the_ID(), 'genre', array(
    'fields'  => 'names',    // ids / names / all / slugs
    'orderby' => 'name',
    'order'   => 'ASC',
) );
// 結果: array( "SF", "ファンタジー", "ミステリー" )

// 標準カテゴリーにも使える
$cat_slugs = wp_get_post_terms( get_the_ID(), 'category', array(
    'fields' => 'slugs',
) );
?>

? ポイント：get_the_terms() と wp_get_post_terms() はどちらもカスタムタクソノミーに対応していますが、wp_get_post_terms() の方が fields パラメータで取得形式を柔軟に指定できます。標準カテゴリー（taxonomy: category）にも使えるので、汎用的に使いたい場合はこちらがおすすめです。

<?php
// single_cat_title(): カテゴリーページのタイトルを取得・表示
if ( is_category() ) {
    // 直接出力
    single_cat_title( 'カテゴリー: ' );
    // 出力: "カテゴリー: WordPress"

    // 変数に取得（第2引数を false に）
    $title = single_cat_title( '', false );
    echo '<h1>' . esc_html( $title ) . ' の記事一覧</h1>';
}

// category_description(): カテゴリーの説明文を取得
if ( is_category() ) {
    $desc = category_description();
    if ( $desc ) {
        echo '<div class="cat-description">' . $desc . '</div>';
    }

    // 特定カテゴリーIDの説明を取得（アーカイブ以外でも使える）
    $desc = category_description( 5 );
}
?>

<?php
// カテゴリーID、名前、スラッグのいずれでも指定可能
if ( in_category( 'wordpress' ) ) {
    echo 'WordPressの記事です';
}

// 複数カテゴリーのいずれかに属しているか
if ( in_category( array( 'wordpress', 'php', 'javascript' ) ) ) {
    echo 'プログラミング系の記事です';
}

// 投稿IDを指定して判定
if ( in_category( 5, 123 ) ) {
    // 投稿ID: 123 がカテゴリーID: 5 に属しているか
}
?>

<?php
// has_category(): 投稿が特定のカテゴリーを「持っている」か
// → in_category() と同等（投稿ページで使用）
if ( has_category( 'wordpress' ) ) {
    // この投稿は "wordpress" カテゴリーを持っている
}

// is_category(): 現在のページがカテゴリーアーカイブか
// → カテゴリーページ（archive）の判定に使用
if ( is_category( 'wordpress' ) ) {
    // 現在表示中のページが "wordpress" カテゴリーアーカイブ
}

// has_term(): カスタムタクソノミーにも使える汎用版
if ( has_term( 'sf', 'genre' ) ) {
    // この投稿は "genre" タクソノミーの "sf" タームを持っている
}
?>

<?php
// パターン1: カテゴリーIDで指定（子カテゴリー含む）
$query = new WP_Query( array(
    'cat' => 5,
) );

// パターン2: スラッグで指定
$query = new WP_Query( array(
    'category_name' => 'wordpress',
) );

// パターン3: 複数カテゴリー（OR条件）
$query = new WP_Query( array(
    'category__in' => array( 5, 12, 23 ),  // いずれかに属する
) );

// パターン4: 複数カテゴリー（AND条件）
$query = new WP_Query( array(
    'category__and' => array( 5, 12 ),     // 両方に属する
) );
?>

<?php
// 特定カテゴリーを除外
$query = new WP_Query( array(
    'category__not_in' => array( 1 ),  // 未分類を除外
) );

// tax_query: カスタムタクソノミーで条件指定
$query = new WP_Query( array(
    'tax_query' => array(
        array(
            'taxonomy' => 'genre',
            'field'    => 'slug',        // term_id / slug / name
            'terms'    => array( 'sf', 'fantasy' ),
            'operator' => 'IN',         // IN / NOT IN / AND / EXISTS
        ),
    ),
) );
?>

<?php
function exclude_category_from_home( $query ) {
    // 管理画面・サブクエリは対象外
    if ( is_admin() || ! $query->is_main_query() ) {
        return;
    }

    // トップページから「お知らせ」カテゴリー（ID: 10）を除外
    if ( $query->is_home() ) {
        $query->set( 'category__not_in', array( 10 ) );
    }

    // 検索結果を特定カテゴリーに限定
    if ( $query->is_search() ) {
        $query->set( 'cat', '5,12,23' );
    }
}
add_action( 'pre_get_posts', 'exclude_category_from_home' );
?>

⚠ 注意：is_admin() と is_main_query() のチェックを必ず入れてください。これを忘れると管理画面やウィジェットなど、すべてのクエリに影響します。

<?php
// 方法1: body_class() を利用（自動的にカテゴリークラスが付く）
// <body class="single category-wordpress category-5">

// 方法2: 手動でカテゴリースラッグをクラスに追加
$categories = get_the_category();
$cat_classes = '';

if ( $categories ) {
    $slugs = array_map( function( $cat ) {
        return 'cat-' . esc_attr( $cat->slug );
    }, $categories );
    $cat_classes = implode( ' ', $slugs );
}
?>

<!-- テンプレートでの使用 -->
<article class="post-card <?php echo $cat_classes; ?>">
    ...
</article>

/* カテゴリーごとのアクセントカラー */
.cat-wordpress .post-title { color: #21759b; }
.cat-javascript .post-title { color: #f7df1e; }
.cat-php .post-title { color: #777bb4; }

/* カテゴリーラベルのバッジスタイル */
.category-badge {
    display: inline-block;
    padding: 2px 10px;
    border-radius: 12px;
    font-size: 12px;
    font-weight: 600;
    color: #fff;
}

<?php
/**
 * カテゴリーをバッジ風に表示するヘルパー関数
 */
function display_category_badges( $post_id = null ) {
    $categories = get_the_category( $post_id );

    if ( empty( $categories ) ) return;

    echo '<div class="category-badges">';
    foreach ( $categories as $cat ) {
        printf(
            '<a href="%s" class="category-badge cat-%s">%s</a>',
            esc_url( get_category_link( $cat->term_id ) ),
            esc_attr( $cat->slug ),
            esc_html( $cat->name )
        );
    }
    echo '</div>';
}
?>

<?php
$categories = get_the_category();

if ( $categories ) {
    $related = new WP_Query( array(
        'category__in'   => array( $categories[0]->term_id ),
        'post__not_in'   => array( get_the_ID() ),  // 現在の記事を除外
        'posts_per_page' => 5,
        'orderby'        => 'rand',
    ) );

    if ( $related->have_posts() ) {
        echo '<h3>関連記事</h3><ul>';
        while ( $related->have_posts() ) {
            $related->the_post();
            printf(
                '<li><a href="%s">%s</a></li>',
                get_permalink(),
                get_the_title()
            );
        }
        echo '</ul>';
        wp_reset_postdata();
    }
}
?>

<?php
function simple_breadcrumb() {
    if ( ! is_single() ) return;

    $categories = get_the_category();
    if ( empty( $categories ) ) return;

    $cat = $categories[0];
    $ancestors = array_reverse( get_ancestors( $cat->term_id, 'category' ) );

    echo '<nav class="breadcrumb">';
    echo '<a href="' . home_url() . '">ホーム</a> > ';

    // 祖先カテゴリーを表示
    foreach ( $ancestors as $ancestor_id ) {
        $ancestor = get_category( $ancestor_id );
        printf(
            '<a href="%s">%s</a> > ',
            esc_url( get_category_link( $ancestor_id ) ),
            esc_html( $ancestor->name )
        );
    }

    // 現在のカテゴリー
    printf(
        '<a href="%s">%s</a> > ',
        esc_url( get_category_link( $cat->term_id ) ),
        esc_html( $cat->name )
    );

    // 記事タイトル
    echo '<span>' . get_the_title() . '</span>';
    echo '</nav>';
}
?>