「テンプレートタグ/single cat title」の版間の差分

2014年8月25日 (月) 21:39時点における最新版

カテゴリーまたはタグアーカイブがクエリされているときに使用すると、ページタイトル（カテゴリー名またはタグ名）を表示または返します。 従って、この関数が使えるのはループの外側においてのみです。

<?php single_cat_title( $prefix, $display ); ?>

<p><?php single_cat_title( '', true ); ?></p>

$prefix

（文字列） （オプション） タイトルの前に出力するテキスト。

初期値： なし

参考：現在、$prefix 引数は $display 引数が false のときには無視されます。trac チケット #16632 を参照してください。

$display

（真偽値） （オプション） ページタイトルを表示するか（true）、それとも PHP で使えるように返すか（false）。

初期値： true

(文字列|void) 

カテゴリーまたはタグアーカイブがクエリされており、かつ $display が false のとき、ページタイトルを返す。

下記の例はテキスト "Currently browsing " に続けてカテゴリータイトルを表示します。

<p><?php single_cat_title('Currently browsing '); ?>.</p>

下記の例は変数 $current_category に現在のカテゴリータイトルをセットして PHP で使えるようにします。

<?php $current_category = single_cat_title("", false); ?>

• バージョン 3.1 以降、この関数は single_term_title() のエイリアスです。
• バージョン 3.1 より前は、この関数は single_tag_title() を使っていました。

バージョン 0.71 にて導入されました。

single_cat_title() は wp-includes/general-template.php にあります。

カテゴリータグ： the_category(), the_category_rss(), single_cat_title(), category_description(), wp_dropdown_categories(), wp_list_categories(), get_the_category(), get_the_category_by_ID(), get_category_by_slug(), get_the_category_list(), get_category_parents(), get_category_link(), is_category(), in_category()

最新英語版： WordPress Codex » Template Tags/single_cat_title （最新版との差分）