カテゴリー別の記事一覧ページ(category.phpやarchive.phpなど)にて、現在のカテゴリー名を表示します。
single_cat_title($prefix,$display);| 引数 | 必須/任意 | 引数に指定するもの |
|---|---|---|
| 第1引数 $prefix | 任意 | カテゴリー名の前に表示する文字列初期値: ''(空の文字列) |
| 第2引数 $display | 任意 | 表示するならtrue、取得するならfalse初期値: true |
カテゴリー名を表示します(echoする)。
※第2引数次第では取得します(戻り値を返す)
下記の例では、カテゴリー名の前に「カテゴリー:」を表示します。
<?php single_cat_title('カテゴリー:'); ?>結果例:カテゴリー:WordPressについて
※「WordPressについて」というカテゴリー名の場合
下記の例では、カテゴリー名を取得して変数に渡しています。以降の処理でカテゴリー名を使った処理をしたい場合に使うことができます。(例では単純にechoしているだけです)
<?php
$term_name = single_cat_title('', false);
echo $term_name;
?>【引数とは】
テンプレートタグ(=関数)を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。
【引数について】
category.phpやarchive.phpなど、カテゴリー別の記事一覧ページで現在のカテゴリー名を表示したい際によく使います。
また、カスタムタクソノミーを作成してターム別記事一覧ページ(taxonomy.php)を作成する場合は、single_term_title()を使います。なお、category.phpはsingle_term_title()のラッパー関数で、内部でsingle_term_title()を実行しています。single_term_title()でカテゴリー名を取得することもできます。
※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。