• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

テンプレートタグ/single cat title

提供: WordPress Codex 日本語版
移動先: 案内検索

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

使い方

<?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) 
カテゴリーまたはタグアーカイブがクエリされており、かつ $displayfalse のとき、ページタイトルを返す。

用例

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

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


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

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

参考

更新履歴

バージョン 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最新版との差分