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