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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Template Tags/single_cat_title 15:58, 29 April 2014 Hunterhogan 版を反映して訳を見直し。)
(参考)
 
(同じ利用者による、間の1版が非表示)
12行目: 12行目:
 
  <?php single_cat_title( $prefix, $display ); ?>
 
  <?php single_cat_title( $prefix, $display ); ?>
  
<div id="Default Usage">
+
<div id="Default_Usage">
 
=== デフォルトの使い方 ===
 
=== デフォルトの使い方 ===
 
</div>
 
</div>
  
  <nowiki><pre><?php single_cat_title( '', true ); ?></pre></nowiki>
+
  <nowiki><p><?php single_cat_title( '', true ); ?></p></nowiki>
  
 
<div id="Parameters">
 
<div id="Parameters">
23行目: 23行目:
  
 
{{Parameter|$prefix|文字列|タイトルの前に出力するテキスト。|オプション}}
 
{{Parameter|$prefix|文字列|タイトルの前に出力するテキスト。|オプション}}
参考:引数 $prefix は、引数 $display false のときには無視されます。<br />
+
: 参考:現在、$prefix 引数は $display 引数が false のときには無視されます。[http://core.trac.wordpress.org/ticket/16632 trac チケット #16632] を参照してください。
http://core.trac.wordpress.org/ticket/16632 を参照してください。
+
{{Parameter|$display|真偽値|ページタイトルを表示するか(<tt>true</tt>)、それとも PHP で使えるように返すか(<tt>false</tt>)。|オプション|<tt>true</tt>}}
{{Parameter|$display|真偽値|ページタイトルを表示する(''true'')か、それとも PHP で使うために返す(''false'')。|オプション|true}}
+
  
<div id="Return Values">
+
<div id="Return_Values">
 
== 戻り値 ==
 
== 戻り値 ==
 
</div>
 
</div>
42行目: 41行目:
  
 
<div style="border:1px solid blue; width:50%; padding:10px">Currently browsing WordPress.</div>
 
<div style="border:1px solid blue; width:50%; padding:10px">Currently browsing WordPress.</div>
 +
  
 
下記の例は変数 $current_category に現在のカテゴリータイトルをセットして PHP で使えるようにします。
 
下記の例は変数 $current_category に現在のカテゴリータイトルをセットして PHP で使えるようにします。
52行目: 52行目:
  
 
* [[Version 3.1|バージョン 3.1]] 以降、この関数は <tt>[[関数リファレンス/single_term_title|single_term_title()]]</tt> のエイリアスです。
 
* [[Version 3.1|バージョン 3.1]] 以降、この関数は <tt>[[関数リファレンス/single_term_title|single_term_title()]]</tt> のエイリアスです。
* [[Version 3.1|バージョン 3.1]] より前は、この関数は <tt>[[関数リファレンス/single_tag_title|single_tag_title()]]</tt> を使っていました。
+
* [[Version 3.1|バージョン 3.1]] より前は、この関数は <tt>[[テンプレートタグ/single_tag_title|single_tag_title()]]</tt> を使っていました。
 +
 
 +
<div id="Change_Log">
  
<div id="Change Log">
 
 
== 更新履歴 ==
 
== 更新履歴 ==
 
</div>
 
</div>
60行目: 61行目:
 
[[Version 0.71|バージョン 0.71]] にて導入されました。
 
[[Version 0.71|バージョン 0.71]] にて導入されました。
  
<div id="Source File">
+
<div id="Source_File">
 
== ソースファイル ==
 
== ソースファイル ==
 
</div>
 
</div>
75行目: 76行目:
 
{{原文|Template Tags/single_cat_title|143072}} <!-- 15:58, 29 April 2014 Hunterhogan 版 -->
 
{{原文|Template Tags/single_cat_title|143072}} <!-- 15:58, 29 April 2014 Hunterhogan 版 -->
  
{{DEFAULTSORT:single_cat_title}}
+
{{DEFAULTSORT:Single_cat_title}}
 
[[Category:テンプレートタグ]]
 
[[Category:テンプレートタグ]]
  
 
[[en:Template Tags/single_cat_title]]
 
[[en:Template Tags/single_cat_title]]
 
[[pt-br:Template Tags/single_cat_title]]
 
[[pt-br:Template Tags/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) 
カテゴリーまたはタグアーカイブがクエリされており、かつ $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最新版との差分