2024年06月13日
WP関数:the_category()
この関数の説明
WP関数の the_category() は、現在の投稿に設定されているカテゴリをリンク付きで表示する関数です。
関数
the_category( $separator, $parents, $post_id )
パラメータ
$separator(文字列) (オプション)
複数のカテゴリが選択されている場合、個々のカテゴリを区切る文字列を指定します。
' | 'の場合は、カテゴリA | カテゴリB で表示されます。
省略か ''(空白)を指定した場合は、<ul><li>のリスト表示になります。
$parents(文字列) (オプション)
選択されたカテゴリに親がある場合、親カテゴリの出力の仕方を決めます。
指定値 | 挙動 |
省略又は '' | 親は表示しません |
'single' | 親子を$separatorで区切って表示し、リンクは全体で子供にリンクします |
'multiple' | 親子を$separatorで区切って表示し、リンクは親と子で別々にリンクします |
$post_id(整数) (オプション)
カテゴリを取得する投稿のIDを指定します。
事例
①設定されているカテゴリを表示する
下記は投稿文書に設定されているカテゴリを表示するサンプルです。
<?php the_category(' | ' );?>
■カテゴリの[WordPress関数]と[WPアクション]にチェックが付いている場合は、下図の様に表示されます。
■どちらかのカテゴリに親があっても無視されます。
②カテゴリの親を含めて表示する
下記はパンくずの様な形で表示させたサンプルです。
<?php the_category(' / ','multiple' ); // カテゴリを表示 echo ' / ' ; // 区切り文字の出力 the_title(); // 文書タイトルを表示 ?>
■投稿のカテゴリにWordPress関数にチェックが付いており、このカテゴリに親がある場合は下図の様に表示されます。
関連情報
関連関数は カテゴリ関連関数 を参照してください。