テンプレートタグ/comments numberのソースを表示

<div id="Description">
== 説明 ==
</div>

現在の投稿に対するコメント、[[用語集#Trackback|トラックバック]]、[[用語集#Pingback|ピンバック]]の合計数を表示します。このテンプレートタグは[[The Loop|ループ]]の中で使わなければなりません。

表示する代わりに値として取得するには [[関数リファレンス/get_comments_number|get_comments_number()]] を使ってください。

<div id="Usage">
== 使い方 ==
</div>

 <?php comments_number( $zero, $one, $more ); ?>

<div id="Parameters">
== パラメータ ==
</div>

{{Parameter|$zero|文字列|合計数が 0 の場合に出力するテキスト。|オプション|<code>'No Comments'</code>}}

{{Parameter|$one|文字列|合計数が 1 つの場合に出力するテキスト。|オプション|<code>'1 Comment'</code>}}

{{Parameter|$more|文字列|合計数が 2 つ以上の場合に出力するテキスト。<code>%</code> が実際の数に置き換えられる。5 つある場合、<code>'合計 % 件'</code> は "合計 5 件" と表示される。|オプション|<code>'% Comments'</code>}}

'''参考：'''日本語版のデフォルトは、それぞれ <code>"コメントはまだありません", "1件のコメント", "%件のコメント"</code> です。

<div id="Return_Values">
== 戻り値 ==
</div>

この関数は値を返しません。

<div id="Examples">
== 用例 ==
</div>

<div id="Text Response to Number of Comments">
=== コメント数に応じたテキスト ===
</div>

この例は、コメント数に応じて次のようなテキストを表示します。
:* 0 なら - '''コメントなし'''
:* 1 なら - '''一つだけコメントあり'''
:* 2 以上（例：42）なら - '''42 件のコメントあり'''

<pre>
<p>
  この投稿は
  <?php comments_number( 'コメントなし', '一つだけコメントあり', '% 件のコメントあり' ); ?>。
</p>
</pre>

<div id="Title For Comments Section">
===コメント節のタイトル===
</div>

コメント欄の上に、コメントの数を含むタイトルを表示する場合があります。
以下の例では、実行するとすべての文字列にて変換可能となる方法を示します。

<pre>
<h3>
printf( _nx( 'One Comment', '%1$s Comments', get_comments_number(), 'comments title', 'textdomain' ), number_format_i18n( get_comments_number() ) );
</h3>
</pre>


<div id="Notes">
== 参考 ==
</div>

* 表示する前に [[関数リファレンス/apply_filters|apply_filters()]] を使って <code>'comments_number'</code> フィルターフックを呼び出します。パラメータは、表示する文字列と実際の合計数です。

<div id="Change_Log">
== 変更履歴 ==
</div>

[[Version 0.71|0.71]] : 新規導入。

<div id="Source_File">
== ソースファイル ==
</div>

<code>comments_number()</code> は {{Trac|wp-includes/comment-template.php}} にあります。

<div id="Related">
== 関連資料 ==
</div>
{{Tag Comments Tags}}

{{Tag Footer}}

{{原文|Template Tags/comments_number|151719}} <!-- 03:55, 20 May 2015‎ Downstairsdev 版 -->

{{DEFAULTSORT:Comments_number}}
[[Category:テンプレートタグ]]

[[en:Template Tags/comments_number]]