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

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

テンプレートタグ/comments number

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

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

表示する代わりに値として取得するには get_comments_number() を使ってください。

使い方

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

パラメータ

$zero
文字列) (オプション) 合計数が 0 の場合に出力するテキスト。
初期値: 'No Comments'
$one
文字列) (オプション) 合計数が 1 つの場合に出力するテキスト。
初期値: '1 Comment'
$more
文字列) (オプション) 合計数が 2 つ以上の場合に出力するテキスト。% が実際の数に置き換えられる。5 つある場合、'合計 % 件' は "合計 5 件" と表示される。
初期値: '% Comments'

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

戻り値

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

用例

コメント数に応じたテキスト

この例は、コメント数に応じて次のようなテキストを表示します。

  • 0 なら - コメントなし
  • 1 なら - 一つだけコメントあり
  • 2 以上(例:42)なら - 42 件のコメントあり
<p>
  この投稿は
  <?php comments_number( 'コメントなし', '一つだけコメントあり', '% 件のコメントあり' ); ?>。
</p>

コメント節のタイトル

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

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


参考

  • 表示する前に apply_filters() を使って 'comments_number' フィルターフックを呼び出します。パラメータは、表示する文字列と実際の合計数です。

変更履歴

0.71 : 新規導入。

ソースファイル

comments_number()wp-includes/comment-template.php にあります。

コメント関数: cancel_comment_reply_link(), comment_author(), comment_author_email(), comment_author_email_link(), comment_author_IP(), comment_author_link(), comment_author_rss(), comment_author_url(), comment_author_url_link(), comment_class(), comment_date(), comment_excerpt(), comment_form_title(), comment_form(), comment_ID(), comment_id_fields() / en, comment_reply_link(), comment_text(), comment_text_rss(), comment_time(), comment_type(), comments_link, comments_number(), comments_open(), comments_popup_link(), comments_popup_script(), comments_rss_link(), get_avatar(), next_comments_link(), paginate_comments_links(), permalink_comments_rss(), previous_comments_link(), wp_list_comments()



関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Template Tags/comments_number最新版との差分