get_the_category_list()


WordPressのget_the_category_list()関数は、投稿に関連付けられたカテゴリをHTML形式でリストとして取得するために使用されます。

シンタックス

get_the_category_list( string $separator = '', int|false $post_id = false );

引数の説明:

  • $separator (string) — 各カテゴリ間に表示される区切り文字。
  • $post_id (int|false) — 特定の投稿のIDを指定。省略時は現在の投稿が使用されます。

例1: カテゴリをカンマで区切って表示

以下のコードは、カテゴリをカンマで区切って表示します。

<?php echo get_the_category_list( ', ' ); ?>

例2: カスタム区切り文字を使用

カスタムの区切り文字「 | 」を使用してカテゴリを表示します。

<?php echo get_the_category_list( ' | ' ); ?>

例3: 特定の投稿のカテゴリを取得

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

<?php echo get_the_category_list( ', ', false, get_the_ID() ); ?>

例4: リンクなしでカテゴリ名のみを表示

各カテゴリリンクを削除して名前のみを表示します。

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

例5: HTMLタグを含むカテゴリリストの出力

カテゴリリストをHTMLで装飾して出力します。

<?php echo '<ul><li>' . str_replace( ', ', '</li><li>', get_the_category_list( ', ' ) ) . '</li></ul>'; ?>

注意事項

  • get_the_category_list()関数を使用する場合、現在の投稿または指定された投稿がカテゴリに割り当てられていることを確認してください。
  • 区切り文字を指定する際、HTMLエンティティを正しくエスケープする必要があります。

関連機能：