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

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

関数リファレンス/have comments

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


ループで処理するコメントがあるかどうか判定します。

使い方

この関数はグローバル $wp_query オブジェクトがセットされている前提で動作します。ループ内から呼び出すとふつうはそうなっています。

注意:comments_template() が呼び出されるまでは、この関数は "false" を返します。もし comments_template() を呼び出す前にコメントの有無をチェックするなら、代わりに get_comments_number() を使ってください。

<?php $have_comments = have_comments(); ?>

パラメータ

この関数にパラメータはありません。

戻り値

(真偽値) 
現在のクエリに利用可能なコメントがあれば true、そうでなければ false を返す。

用例

Twentyten テーマの comments.php テンプレートに基づいた例です。コメントがあるときだけ、コメントのタイトル(他にも)を表示します:

<?php if ( have_comments() ) : ?>
    <h3 id="comments-title"><?php
        printf(
            _n( 'One Response to %2$s', '%1$s Responses to %2$s', get_comments_number(), 'twentyten' ),
            number_format_i18n( get_comments_number() ),
            '<em>' . get_the_title() . '</em>' 
        );
    ?></h3>
// [and more, of course...]
<?php else : // コメントがなければ:
    if ( ! comments_open() ) : ?>
        <p class="nocomments"><?php _e( 'Comments are closed.', 'twentyten' ); ?></p>
    <?php endif; // おわり ! comments_open() ?>
<?php endif; // おわり have_comments() ?>

参考

  • グローバル (オブジェクト) $wp_query を使ってコメントが利用可能かどうか判定します(have_comments メソッドによります)。

変更履歴

新規導入: 2.2.0

ソースファイル

have_comments()wp-includes/query.php にあります。

wp-content/themes/twentyfifteen/comments.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 » Function_Reference/have_comments最新版との差分