get_the_category()


WordPressの関数get_the_category()は、特定の投稿が属しているカテゴリを取得するために使用されます。

構文

get_the_category( int|string|WP_Post $post = null );
  • $post (int|string|WP_Post) — カテゴリを取得する投稿ID、投稿スラッグ、またはWP_Postオブジェクトを指定します。省略時は現在の投稿が対象になります。

例1: 現在の投稿のカテゴリを取得する

現在の投稿に関連付けられているすべてのカテゴリを取得する基本的な例です。

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

例2: 特定の投稿IDのカテゴリを取得する

投稿IDを指定してカテゴリを取得します。

<?php
$categories = get_the_category( 42 );
foreach ( $categories as $category ) {
    echo $category->name . '<br>';
}
?>

例3: 投稿スラッグを使用してカテゴリを取得する

投稿スラッグを指定してカテゴリを取得します。

<?php
$categories = get_the_category( 'example-slug' );
if ( ! empty( $categories ) ) {
    foreach ( $categories as $category ) {
        echo $category->name . '<br>';
    }
}
?>

例4: カテゴリ名のリストをカンマ区切りで表示する

カテゴリ名をカンマで区切ったリストとして表示します。

<?php
$categories = get_the_category();
$category_names = wp_list_pluck( $categories, 'name' );
echo implode( ', ', $category_names );
?>

例5: カテゴリリンクをリスト形式で表示する

カテゴリ名とリンクをリスト形式で表示します。

<?php
$categories = get_the_category();
echo '<ul>';
foreach ( $categories as $category ) {
    echo '<li><a href="' . get_category_link( $category->term_id ) . '">' . $category->name . '</a></li>';
}
echo '</ul>';
?>

注意事項

  • 投稿がカテゴリに属していない場合、get_the_category()は空の配列を返します。
  • この関数はカテゴリ情報を取得するだけで、HTMLやスタイルの生成は行いません。

関連機能: