当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「テンプレートタグ/wp list comments」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(Mizunoさんが更新してくださった原文版番号の挿入。Tag Comments Tags も作っておきました。thanks!)
(原文のリンク先を翻訳時点の最新版に変更)
60行目: 60行目:
 
== パラメータ ==
 
== パラメータ ==
  
''拡張と説明が必要''
+
''拡張と説明が必要<!-- 原文自体が未完成? -->''
  
 
; avatar_size  
 
; avatar_size  
78行目: 78行目:
 
{{PHP Function Tag Footer}}
 
{{PHP Function Tag Footer}}
  
{{原文|Template Tags/wp_list_comments|65865}}<!-- 18:44, January 7, 2009 Jeremyclarke 版 -->
+
{{原文|Template Tags/wp_list_comments}}
  
 
{{DEFAULTSORT:Wp_list_comments}}
 
{{DEFAULTSORT:Wp_list_comments}}

2009年1月14日 (水) 18:42時点における版

このページ「テンプレートタグ/wp list comments」はまだ書きかけで、情報が不足しています。続きを書いて WordPress を手助けしましょう.


この項目「テンプレートタグ/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' => '');

関連

コメント関数: 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()



テンプレートタグへの PHP 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Template Tags/wp_list_comments