single_cat_title()


WordPressのsingle_cat_title()関数は、現在表示されているカテゴリーのタイトルを取得または表示するために使用されます。この関数は、カテゴリーページやアーカイブページで特に役立ちます。

構文

single_cat_title( string $prefix = '', bool $display = true );

引数の説明:

  • $prefix (string) — カテゴリータイトルの前に表示するテキスト。デフォルトは空文字列。
  • $display (bool) — タイトルを直接表示するかどうか。trueの場合、表示し、falseの場合、タイトルを返します。

例1: カテゴリータイトルの表示

現在のカテゴリーページでカテゴリータイトルを表示します。

<?php single_cat_title(); ?>

例2: カテゴリータイトルの前にテキストを追加

カテゴリータイトルの前に「カテゴリー: 」というテキストを追加します。

<?php single_cat_title('カテゴリー: '); ?>

例3: カテゴリータイトルを変数に格納

カテゴリータイトルを表示せずに変数に格納します。

<?php $cat_title = single_cat_title('', false); ?>

例4: カテゴリータイトルを条件付きで表示

特定のカテゴリータイトルの場合にのみ表示します。

<?php if (single_cat_title('', false) == 'ニュース') { echo 'ニュースカテゴリーです'; } ?>

例5: カテゴリータイトルをリンク付きで表示

カテゴリータイトルをリンク付きで表示します。

<?php echo '<a href="' . get_category_link(get_cat_ID(single_cat_title('', false))) . '">' . single_cat_title('', false) . '</a>'; ?>

例6: カテゴリータイトルをカスタムクラス付きで表示

カテゴリータイトルをカスタムクラス付きで表示します。

<?php echo '<span class="custom-class">' . single_cat_title('', false) . '</span>'; ?>

注意点

  • この関数はカテゴリーページやアーカイブページでのみ使用することを推奨します。
  • $display引数をfalseに設定した場合、関数はタイトルを返すため、適切に変数に格納する必要があります。

関連機能：