WordPress主题制作全过程（十）：制作comments.php

摘要: 今天我们来制作评论主题的评论模块。在主题目录Aurelius下新建comments.php，在single.php剪切以下代码，粘贴到comments.php：     <!– Comment’s List –>     <h3>...

今天我们来制作评论主题的评论模块。在主题目录Aurelius下新建comments.php，在single.php剪切以下代码，粘贴到comments.php：

1.     <!– Comment’s List –>
2.     <h3>Comments</h3>
3.     <div class=“hr dotted clearfix”>&nbsp;</div>
4.     <ol class=“commentlist”>
5.         <li class=“comment”>
6.             <div class=“gravatar”> <img alt=“” src=’images/gravatar.png’ height=’48′ width=’48′ /> <a class=“comment-reply-link” href=&quot;>Reply</a> </div>
7.             <div class=“comment_content”>
8.                 <div class=“clearfix”> <cite class=“author_name”><a href=“”>Joe Bloggs</a></cite>
9.                     <div class=“comment-meta commentmetadata”>January 6, 2010 at 6:26 am</div>
10.                 </div>
11.                 <div class=“comment_text”>
12.                     <p>Donec leo. Aliquam risus elit, luctus vel, interdum vitae, malesuada eget, elit. Nulla vitae ipsum. Donec ligula ante, bibendum sit amet, elementum quis, viverra eu, ante. Fusce tincidunt. Mauris pellentesque, arcu eget feugiat accumsan, ipsum mi molestie orci, ut pulvinar sapien lorem nec dui.</p>
13.                 </div>
14.             </div>
15.         </li>
16.     </ol>
17.     <div class=“hr clearfix”>&nbsp;</div>
18.     <!– Comment Form –>
19.     <form id=“comment_form” action=“” method=“post”>
20.         <h3>Add a comment</h3>
21.         <div class=“hr dotted clearfix”>&nbsp;</div>
22.         <ul>
23.             <li class=“clearfix”>
24.                 <label for=“name”>Your Name</label>
25.                 <input id=“name” name=“name” type=“text” />
26.             </li>
27.             <li class=“clearfix”>
28.                 <label for=“email”>Your Email</label>
29.                 <input id=“email” name=“email” type=“text” />
30.             </li>
31.             <li class=“clearfix”>
32.                 <label for=“email”>Your Website</label>
33.                 <input id=“website” name=“website” type=“text” />
34.             </li>
35.             <li class=“clearfix”>
36.                 <label for=“message”>Comment</label>
37.                 <textarea id=“message” name=“message” rows=“3” cols=“40”></textarea>
38.             </li>
39.             <li class=“clearfix”>
40.             <!– Add Comment Button –>
41.             <a type=“submit” class=“button medium black right”>Add comment</a> </li>
42.         </ul>
43.     </form>

     在single.php原位置添加代码：

1. <?php comments_template(); ?>

     以上语句的作用就是将comments.php里的所有内容导入到single.php中，与直接在single.php写comments.php中的代码效果是一样的。

     为了安全起见，不让恶意用户直接打开评论文件，请在comments.php头部添加以下代码：

1. <?php
2.     if (isset($_SERVER[‘SCRIPT_FILENAME’]) && ‘comments.php’ == basename($_SERVER[‘SCRIPT_FILENAME’]))
3.         die (‘Please do not load this page directly. Thanks!’);
4. ?>

     因为WordPress的输出评论函数wp_list_comments()输出的评论代码与我们主题的评论代码不一样的，我们得自定义我们的评论列表，将comments.php中的以下代码删除（以下代码用于列出文章的所有评论）：

1. <li class=“comment”>
2.     <div class=“gravatar”> <img alt=“” src=’images/gravatar.png’ height=’48′ width=’48′ /> <a class=“comment-reply-link” href=&quot;>Reply</a> </div>
3.     <div class=“comment_content”>
4.         <div class=“clearfix”> <cite class=“author_name”><a href=“”>Joe Bloggs</a></cite>
5.             <div class=“comment-meta commentmetadata”>January 6, 2010 at 6:26 am</div>
6.         </div>
7.         <div class=“comment_text”>
8.         <p>Donec leo. Aliquam risus elit, luctus vel, interdum vitae, malesuada eget, elit. Nulla vitae ipsum. Donec ligul  a ante, bibendum sit amet, elementum quis, viverra eu, ante. Fusce tincidunt. Mauris pellentesque, arcu eget feugiat accumsan, ipsum mi molestie orci, ut pulvinar sapien lorem nec dui.</p>
9.         </div>
10.     </div>
11. </li>

改成：

1.     <?php
2.     if (!empty($post->post_password) && $_COOKIE[‘wp-postpass_’ . COOKIEHASH] != $post->post_password) {
3.         // if there’s a password
4.         // and it doesn’t match the cookie
5.     ?>
6.     <li class=”decmt-box”>
7.         <p><a href=”#addcomment”>请输入密码再查看评论内容.</a></p>
8.     </li>
9.     <?php
10.         } else if ( !comments_open() ) {
11.     ?>
12.     <li class=”decmt-box”>
13.         <p><a href=”#addcomment”>评论功能已经关闭!</a></p>
14.     </li>
15.     <?php
16.         } else if ( !have_comments() ) {
17.     ?>
18.     <li class=”decmt-box”>
19.         <p><a href=”#addcomment”>还没有任何评论，你来说两句吧</a></p>
20.     </li>
21.     <?php
22.         } else {
23.             wp_list_comments(‘type=comment&callback=aurelius_comment’);
24.         }
25.     ?>

     以上代码的意思大致也可以看得出来了，就是一大堆 如果…就….，如果以上条件都不满足就列出所有评论。现在将主题文件夹Aurelius中的functions.php中的 ?> ，改成以下代码，如果你之前从本博客下载到的functions.php已经有以下代码则不用再添加：

1. function aurelius_comment($comment, $args, $depth)
2. {
3.    $GLOBALS[‘comment’] = $comment; ?>
4.    <li class=”comment” id=”li-comment-<?php comment_ID(); ?>“>
5.         <div class=”gravatar”> <?php if (function_exists(‘get_avatar’) && get_option(‘show_avatars’)) { echo get_avatar($comment, 48); } ?>
6.  <?php comment_reply_link(array_merge( $args, array(‘reply_text’ => ‘回复’,‘depth’ => $depth, ‘max_depth’ => $args[‘max_depth’]))) ?> </div>
7.         <div class=”comment_content” id=”comment-<?php comment_ID(); ?>“>
8.             <div class=”clearfix”>
9.                     <?php printf(__(‘<cite class=”author_name”>%s</cite>’), get_comment_author_link()); ?>
10.                     <div class=”comment-meta commentmetadata”>发表于：<?php echo get_comment_time(‘Y-m-d H:i’); ?></div>
11.                     &nbsp;&nbsp;&nbsp;<?php edit_comment_link(‘修改’); ?>
12.             </div>
14.             <div class=”comment_text”>
15.                 <?php if ($comment->comment_approved == ‘0’) : ?>
16.                     <em>你的评论正在审核，稍后会显示出来！</em><br />
17.         <?php endif; ?>
18.         <?php comment_text(); ?>
19.             </div>
20.         </div>
21. <?php } ?>

以上代码所用到的WordPress函数及相应的说明：

函数名称	函数功能
get_avatar($comment, 48)	获取评论者的gravatar头像，尺寸为48 * 48
comment_reply_link()	回复留言的链接
get_comment_author_link	用于获取评论者博客地址
get_comment_time	获取评论发布时间
edit_comment_link	管理员修改评论的链接
comment_text()	输出评论内容

     好，现在在你的文章页面底部就可以正常地显示评论了！现在我们继续来制作提交评论的表单，将以下代码删除（也就是评论表单的代码）：

1. <!– Comment Form –>
2. <form id=“comment_form” action=“” method=“post”>
3.     <h3>Add a comment</h3>
4.     <div class=“hr dotted clearfix”>&nbsp;</div>
5.     <ul>
6.         <li class=“clearfix”>
7.             <label for=“name”>Your Name</label>
8.             <input id=“name” name=“name” type=“text” />
9.         </li>
10.         <li class=“clearfix”>
11.             <label for=“email”>Your Email</label>
12.             <input id=“email” name=“email” type=“text” />
13.         </li>
14.         <li class=“clearfix”>
15.             <label for=“email”>Your Website</label>
16.             <input id=“website” name=“website” type=“text” />
17.         </li>
18.         <li class=“clearfix”>
19.             <label for=“message”>Comment</label>
20.             <textarea id=“message” name=“message” rows=“3” cols=“40”></textarea>
21.         </li>
22.         <li class=“clearfix”>
23.             <!– Add Comment Button –>
24.             <a type=“submit” class=“button medium black right”>Add comment</a> </li>
25.     </ul>
26. </form>

改成：

1. <?php
2. if ( !comments_open() ) :
3. // If registration required and not logged in.
4. elseif ( get_option(‘comment_registration’) && !is_user_logged_in() ) :
5. ?>
6. <p>你必须 <a href=”<?php echo wp_login_url( get_permalink() ); ?>“>登录</a> 才能发表评论.</p>
7. <?php else  : ?>
8. <!– Comment Form –>
9. <form id=”commentform” name=”commentform” action=”<?php echo get_option(‘siteurl’); ?>/wp-comments-post.php” method=”post”>
10.     <h3>发表评论</h3>
11.     <div class=”hr dotted clearfix”>&nbsp;</div>
12.     <ul>
13.         <?php if ( !is_user_logged_in() ) : ?>
14.         <li class=”clearfix”>
15.             <label for=”name”>昵称</label>
16.             <input type=”text” name=”author” id=”author” value=”<?php echo $comment_author; ?>” size=”23″ tabindex=”1″ />
17.         </li>
18.         <li class=”clearfix”>
19.             <label for=”email”>电子邮件</label>
20.             <input type=”text” name=”email” id=”email” value=”<?php echo $comment_author_email; ?>” size=”23″ tabindex=”2″ />
21.         </li>
22.         <li class=”clearfix”>
23.             <label for=”email”>网址(选填)</label>
24.             <input type=”text” name=”url” id=”url” value=”<?php echo $comment_author_url; ?>” size=”23″ tabindex=”3″ />
25.         </li>
26.         <?php else : ?>
27.         <li class=”clearfix”>您已登录:<a href=”<?php echo get_option(‘siteurl’); ?>/wp-admin/profile.php”><?php echo $user_identity; ?></a>. <a href=”<?php echo wp_logout_url(get_permalink()); ?>” title=”退出登录”>退出 &raquo;</a></li>
28.         <?php endif; ?>
29.         <li class=”clearfix”>
30.             <label for=”message”>评论内容</label>
31.             <textarea id=”message comment” name=”comment” tabindex=”4″ rows=”3″ cols=”40″></textarea>
32.         </li>
33.         <li class=”clearfix”>
34.             <!– Add Comment Button –>
35.             <a href=”javascript:void(0);” onClick=”Javascript:document.forms[‘commentform’].submit()” class=”button medium black right”>发表评论</a> </li>
36.     </ul>
37.     <?php comment_id_fields(); ?>
38.     <?php do_action(‘comment_form’, $post->ID); ?>
39. </form>
40. <?php endif; ?>

函数名称	函数功能
is_user_logged_in	判断用户是否登录
wp_login_url	博客登录地址
get_comment_author_link	用于获取评论者博客地址
$comment_author	读取cookie，如果该用户之前已经发表过评论则自动帮助用户填写用户名
$comment_author_email	读取cookie，如果该用户之前已经发表过评论则自动帮助用户填写Email
$comment_author_url	读取cookie，如果该用户之前已经发表过评论则自动帮助用户填写博客地址
do_action(‘comment_form’, $post->ID);	该函数为某些插件预留
wp_logout_url	退出登录的链接

好了，评论模板comments.php制作完毕！最后本次修改后的主题文件下载：