テンプレートタグ/wp list comments
出典: WordPress Codex 日本語版
この項目「テンプレートタグ/wp list comments」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。
目次 |
説明
Version 2.7 で導入されたこの関数は、様々なパラメータや管理画面で行う設定に基づいて、記事やページのコメントを表示します。
Migrating Plugins and Themes to 2.7 も参照してください。
使い方
<?php wp_list_comments('arguments'); ?>
用例
デフォルトでの使い方
コメントを番号付きリストで出力します。スレッド(入れ子) 形式や複数ページの分割は、管理パネル/ディスカッション設定 で有効にするか無効にします。
<ol class="commentlist"> <?php wp_list_comments(); ?> </ol>
コメントのみを、カスタム画面で表示する
コメントのみ（ピンバックやトラックバックを含まない）を表示し、コールバック関数を用いて見た目を整えます。
<ul class="commentlist">
<?php wp_list_comments('type=comment&callback=mytheme_comment'); ?>
</ul>
利用しているテーマの functions.php file でコールバック関数を定義しておく必要があります。コールバック関数の例を以下に示します。
function mytheme_comment($comment, $args, $depth) {
$GLOBALS['comment'] = $comment; ?>
<li <?php comment_class(); ?> id="li-comment-<?php comment_ID() ?>">
<div id="comment-<?php comment_ID(); ?>">
<div class="comment-author vcard">
<?php echo get_avatar($comment,$size='48',$default='<path_to_url>' ); ?>
<?php printf(__('<cite class="fn">%s</cite> <span class="says">says:</span>'), get_comment_author_link()) ?>
</div>
<?php if ($comment->comment_approved == '0') : ?>
<em><?php _e('Your comment is awaiting moderation.') ?></em>
<br />
<?php endif; ?>
<div class="comment-meta commentmetadata"><a href="<?php echo htmlspecialchars( get_comment_link( $comment->comment_ID ) ) ?>"><?php printf(__('%1$s at %2$s'), get_comment_date(), get_comment_time()) ?></a><?php edit_comment_link(__('(Edit)'),' ','') ?></div>
<?php comment_text() ?>
<div class="reply">
<?php comment_reply_link(array_merge( $args, array('depth' => $depth, 'max_depth' => $args['max_depth']))) ?>
</div>
</div>
<?php
}
追従する </li> が無いことに注意してください。WordPress は子要素を追加した後に、自動で追加します。
パラメータ
拡張と説明が必要
- avatar_size
- (整数) アバターが表示される大きさ（ピクセル）。初期値は32。
- style
- (文字列) コメントリストの表示形式。div または ul。初期値は ul。
- callback
- (文字列) 各コメントの表示に使用するカスタム関数名。初期値は「空」。カスタム関数を指定すると、コメントに関して WordPress 内部関数をすべて省略し、その関数を呼び出して表示する。コメントの HTML レイアウトを大きく変える場合に使用する。非推奨。
$defaults = array('walker' => null, 'max_depth' => '', 'style' => 'ul', 'callback' => null, 'end-callback' => null, 'type' => 'all',
'page' => '', 'per_page' => '', 'avatar_size' => 32, 'reverse_top_level' => null, 'reverse_children' => '');
関連
comments_number, comments_link, comments_rss_link, comments_popup_script, comments_popup_link, comment_ID, comment_author, comment_author_IP, comment_author_email, comment_author_url, comment_author_email_link, comment_author_url_link, comment_author_link, comment_type, comment_text, comment_excerpt, comment_date, comment_time, comment_author_rss, comment_text_rss, permalink_comments_rss, wp_list_comments, comment_reply_link, cancel_comment_reply_link, comment_form_title, comment_id_fields, previous_comments_link, next_comments_link, paginate_comments_links
最新英語版： WordPress Codex » Template Tags/wp_list_comments （最新版との差分）
