comment_form

説明

void comment_form( [ array $args = array() [ , mixed $post_id = null ] ] )
コメント投稿フォームを表示する。

パラメータ

  • $args
    オプションパラメータを連想配列で指定(省略時はarray())。連想配列の内容は次の通り。
    キー名意味
    'fields'コメント投稿者情報の入力フィールド(HTML)を連想配列(通常はキーが'author'、'email'、'url')。
    'comment_field'コメント内容の入力フィールド(HTML)。
    'must_log_in'ログイン済みユーザーのみコメントが許諾されている場合の未ログイン時に表示されるメッセージ。
    'logged_in_as'ログイン済みユーザーの場合に投稿者情報フィールドの代わりに表示されるメッセージ。
    'comment_notes_before'コメント内容の入力フィールドの直前に表示されるメッセージ。
    'comment_notes_after'コメント内容の入力フィールドの直後に表示されるメッセージ。
    'id_form'formタグのid要素の値(省略時は'commentform')。
    'title_reply'コメントタイトル1(省略時は'Leave a Reply'の翻訳テキスト)。
    'title_reply_to'コメントタイトル2(省略時は'Leave a Reply to %s'の翻訳テキスト)。
    'cancel_reply_link'コメントキャンセル時のテキスト(省略時は'Cancel reply'の翻訳テキスト)。
    'id_submit'送信ボタンのid要素の値(省略時は'submit')。
    'name_submit'送信ボタンのname要素の値(省略時は'submit')。
    'label_submit'送信ボタンのラベル(省略時は'Post Comment'の翻訳テキスト)。
    'format'HTMLフォーマットとして'html5'または'xhtml'(省略時はテーマに依存)。
  • $post_id
    コメント対象の投稿IDまたは投稿情報(WP_postオブジェクト)を指定(省略時はnull)。

返り値

返り値はありません。

注意

ディスカッション設定の「名前とメールアドレスの入力を必須にする(オプション名'require_name_email)」のチェック状態など、各種設定内容が反映される。


使用例

  • 現在の投稿情報のコメント投稿フォームを表示する。
    <?php comment_form(); ?>
  • 現在の投稿情報のコメント投稿フォームを表示する。
    <?php comment_form( array() ); ?>
  • 投稿ID$post_idを指定してコメント投稿フォームを表示する。
    <?php comment_form( array(), $post_id ); ?>

フィルター

[3.0.0]formatオプションの確認後、'comment_form_default_fields'フィルターを呼び出す。パラメータ$fieldsにはデフォルトのコメント投稿者情報入力フィールドの連想配列となる。
$fields = apply_filters( 'comment_form_default_fields', $fields );
[3.0.0]'comment_form_default_fields'フィルターの後、'comment_form_defaults'フィルターを呼び出す。パラメータ$defaultsにはデフォルトのオプション設定の連想配列となる。
$args = wp_parse_args( $args, apply_filters( 'comment_form_defaults', $defaults ) );
[3.0.0]ログイン済みメッセージを表示する前に'comment_form_logged_in'フィルターを呼び出す。パラメータ$logged_in_asにはログイン済みユーザーの場合に投稿者情報フィールドの代わりに表示されるメッセージ、$commenterにはコメント投稿者情報、$user_identityにはログイン済みユーザー名となる。
echo apply_filters( 'comment_form_logged_in', $logged_in_as, $commenter, $user_identity );
[3.0.0]各コメント投稿者情報入力フィールドを表示する直前に"comment_form_field_{$name}"フィルターを呼び出す($nameは'author'、'email'、'url'など)。パラメータ$fieldは各入力フィールドのHTMLとなる。
echo apply_filters( "comment_form_field_{$name}", $field ) . "\n";
[3.0.0]コメント内容入力フィールドを表示する直前、'comment_form_field_comment'フィルターを呼び出す。パラメータ$comment_fieldはコメント内容入力フィールドとなる。
echo apply_filters( 'comment_form_field_comment', $comment_field );

アクション

[3.0.0]タイトルを含むコメントフォームを表示する前に'comment_form_before'アクションを呼び出す。
do_action( 'comment_form_before' );
[3.0.0]ログイン済みメッセージの表示後に'comment_form_must_log_in_after'アクションを呼び出す。
do_action( 'comment_form_must_log_in_after' );
[3.0.0]form開始タグの表示直後に'comment_form_top'アクションを呼び出す。
do_action( 'comment_form_top' );
[3.0.0]ログイン済みメッセージの表示直後に'comment_form_logged_in_after'アクションを呼び出す。
do_action( 'comment_form_logged_in_after', $commenter, $user_identity );
[3.0.0]コメント投稿者情報入力フィールドを表示する直前に'comment_form_before_fields'アクションを呼び出す。
do_action( 'comment_form_before_fields' );
[3.0.0]コメント投稿者情報入力フィールドの表示直後に'comment_form_after_fields'アクションを呼び出す。
do_action( 'comment_form_after_fields' );
[3.0.0]form終了タグを表示する直前に'comment_form'アクションを呼び出す。パラメータ$post_idは投稿IDとなる。
do_action( 'comment_form', $post_id );
[3.0.0]コメントフォームの表示後に'comment_form_after'アクションを呼び出す。
do_action( 'comment_form_after' );
[3.0.0]コメント投稿が許可されていない場合に'comment_form_comments_closed'アクションを呼び出す。
do_action( 'comment_form_comments_closed' );

ソースファイル

/wp-includes/comment-template.php

最終更新 : 2014年10月05日 18:12



お勧め

JavaScriptテンプレートを使ってみた(2018年8月21日 更新)

前回の記事」で取り上げた「WordPress Events and News」ウィジェットでは入力された地名のAJAX処理してその地名近隣のイベント情報を表示している。特に表示部分では「JavaScriptテンプレート」が採用されており、今更ながら調べてみた。

子カテゴリのアーカイブページを親カテゴリ用のテンプレートファイルで表示しよう(2011年12月8日 更新)

少し前に投稿した「適切なテンプレートファイルを用意してテンプレート内の振り分け処理を無くす」で説明した通り、特定のカテゴリ専用のテンプレートとしてcategory-○○.phpを用意することで、category.phpやarchive.php内で振り分けを行う必要がなくなる。ただ、すべてのカテゴリ分を用意するのは効率的ではないし、特に子カテゴリについては親カテゴリと共通内容になるケースが多いのではないだろうか。ここでは、子カテゴリの個別テンプレートファイルを作らず、親カテゴリのテンプレートを利用する方法を紹介する。

5.3の新機能:日付とタイムゾーン(2019年10月2日 更新)

WordPress 5.3 Beta 1」に記載されていた「Time/Date component fixes」という見出し。開発者向として新しい関数の追加や多くのバグが修正されたとなっており、チェックせざるを得ない。

Login rebuilderのログ表示機能を紹介(2018年5月27日 更新)

プラグイン「Login rebuilder」には、バージョン1.2.0からログ情報を保存・確認する機能が備わっています。このログ情報では直近のログインページへの不正アクセスやログイン試行を確認できます。ここでは保存しているログ情報の見方について簡単に説明します。

さくらのVPSでKUSANAGI#3(2018年5月27日 更新)

今回は「前回」の続き。http(80番)をクローズ、そのほかに行った調整作業について整理する。