wordpress主题制作教程(十一):评论模板comments.php

前面我们制作了文章单页模板，我们可以发现单页模板的代码跟index.php差不多，不过今天我们让它们的差别大一点，我们给文章模板加入评论表单，让访客可以发表评论。

首先在主题文件夹下面新建一个文件comments.php，然后打开single.php文件，将里面的评论代码剪切出来，粘贴到comments.php文件中，要剪切的代码如下：

<!– Comment’s List –>
<h3>Comments</h3>
<div =“hr dotted clearfix”> </div>
<ol =“commentlist”>
<li =“comment”>
<div =“gravatar”> <img alt=“” src=’images/gravatar.png’ height=’48′ width=’48′ /> <a =“comment-reply-link” href=">Reply</a> </div>
<div =“comment_content”>
<div =“clearfix”> <cite =“author_name”><a href=“”>Joe Bloggs</a></cite>
<div =“comment-meta commentmetadata”>January 6, 2010 at 6:26 am</div>
</div>
<div =“comment_text”>
<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>
</div>
</div>
</li>
</ol>
<div =“hr clearfix”> </div>
<!– Comment Form –>
<form id=“comment_form” action=“” method=“post”>
<h3>Add a comment</h3>
<div =“hr dotted clearfix”> </div>
<ul>
<li =“clearfix”>
<label =“name”>Your Name</label>
<input id=“name” name=“name” type=“text” />
</li>
<li =“clearfix”>
<label =“email”>Your Email</label>
<input id=“email” name=“email” type=“text” />
</li>
<li =“clearfix”>
<label =“email”>Your Website</label>
<input id=“website” name=“website” type=“text” />
</li>
<li =“clearfix”>
<label =“message”>Comment</label>
<textarea id=“message” name=“message” rows=“3” cols=“40”></textarea>
</li>
<li =“clearfix”>
<!– Add Comment Button –>
<a type=“submit” =“button medium black right”>Add comment</a> </li>
</ul>
</form>

然后在single.php文件原来的位置添加代码：

<?php comments_template(); ?>

comments_template()函数默认的就是加载主题文件夹下面的comments.php文件，这个函数也是可以带参数的，以便让你可以加载别的文件，比如某些页面你需要加载一个不一样的评论表单，你就需要使用comments_template()带上参数，这里不细说。
为了防止某些恶意用户直接打开评论文件，我们在comments.php的头部添加代码：

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

修改评论列表

wordpress有自动输出评论列表的函数wp_list_comments()，所以我们将原来的评论列表代码删除，换上这个函数，但是我们还需要加一些判断功能，比如评论需要密码才能查看、评论已经关闭、还没有评论这几个情况都要有不同的输出，所以将原来的评论代码：

<li =“comment”>
<div =“gravatar”> <img alt=“” src=’images/gravatar.png’ height=’48′ width=’48′ /> <a =“comment-reply-link” href=">Reply</a> </div>
<div =“comment_content”>
<div =“clearfix”> <cite =“author_name”><a href=“”>Joe Bloggs</a></cite>
<div =“comment-meta commentmetadata”>January 6, 2010 at 6:26 am</div>
</div>
<div =“comment_text”>
<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>
</div>
</div>
</li>

替换成：

<?php
(!($post->post_password) && $_COOKIE[‘wp-postpass_’ . COOKIEHASH] != $post->post_password) {
// if there’s a password
// and it doesn’t match the cookie
?>
<li =“decmt-box”>
<p><a href=“#addcomment”>请输入密码再查看评论内容.</a></p>
</li>
<?php
} ( !comments_open() ) {
?>
<li =“decmt-box”>
<p><a href=“#addcomment”>评论功能已经关闭!</a></p>
</li>
<?php
} ( !have_comments() ) {
?>
<li =“decmt-box”>
<p><a href=“#addcomment”>还没有任何评论，你来说两句吧</a></p>
</li>
<?php
} {
wp_list_comments(‘type=comment&callback=aurelius_comment’);
}
?>

上面的wp_list_comments函数中我们家里两个参数，其中type=comment意思只输出评论，除了评论还有pingstrackback pingback等等什么的，callback=aurelius_comment意思是调用一个自定义的函数函数aurelius_comment来显示评论。
自定义的函数我们需要添加在主题的functions.php文件中，所以请在functions.php中的“?>”前面加上下面的代码，如果你的functions.php文件中已经存在了下面的代码，就不要再添加了：

aurelius_comment($comment, $args, $depth)
{
$GLOBALS[‘comment’] = $comment; ?>
<li =“comment” id=“li-comment-<?php comment_ID(); ?>”>
<div =“gravatar”> <?php (function_exists(‘get_avatar’) && get_option(‘show_avatars’)) { echo get_avatar($comment, 48); } ?>
<?php comment_reply_link(array_merge( $args, (‘reply_text’ => ‘回复’,’depth’ => $depth, ‘max_depth’ => $args[‘max_depth’]))) ?> </div>
<div =“comment_content” id=“comment-<?php comment_ID(); ?>”>
<div =“clearfix”>
<?php printf(__(‘<cite =“author_name”>%s</cite>’), get_comment_author_link()); ?>
<div =“comment-meta commentmetadata”>发表于：<?php echo get_comment_time(‘Y-m-d H:i’); ?></div>
<?php edit_comment_link(‘修改’); ?>
</div>
<div =“comment_text”>
<?php ($comment->comment_approved == ‘0’) : ?>
<em>你的评论正在审核，稍后会显示出来！</em><br />
<?php ; ?>
<?php comment_text(); ?>
</div>
</div>
</li>
<?php } ?>

上面的自定义函数中用到的几个函数的说明如下：

<?php
get_avatar($id_or_email,$size,$default, $alt);
//$id_or_email这个参数必须，可以使一个用户ID、一个email,或者直接一个comment对象，上面代码就是直接将评论对象作为参数
//$size，这个参数就是头像大小，默认是96，上面代码设为32
//$default 一个图片地址，就是用户没有头像是显示的图片，默认是后台设置的那个
//$alt 就是图片的$alt信息了，我觉得alt信息应该用评论者名字
?>

<?php comment_reply_link();
//回复链接
?>

<?php
get_comment_author_link();
//获取评论者的链接
?>

<?php
get_comment_time();
//获取评论时间
edit_comment_link();
//编辑评论的链接
comment_text();
//输出评论内容
?>

添加了上面的代码评论已经能正确显示了，接下来添加提交评论的表单。
评论表单
将原来comments.php中的评论表单代码删除：

<!– Comment Form –>
<form id=“comment_form” action=“” method=“post”>
<h3>Add a comment</h3>
<div =“hr dotted clearfix”> </div>
<ul>
<li =“clearfix”>
<label =“name”>Your Name</label>
<input id=“name” name=“name” type=“text” />
</li>
<li =“clearfix”>
<label =“email”>Your Email</label>
<input id=“email” name=“email” type=“text” />
</li>
<li =“clearfix”>
<label =“email”>Your Website</label>
<input id=“website” name=“website” type=“text” />
</li>
<li =“clearfix”>
<label =“message”>Comment</label>
<textarea id=“message” name=“message” rows=“3” cols=“40”></textarea>
</li>
<li =“clearfix”>
<!– Add Comment Button –>
<a type=“submit” =“button medium black right”>Add comment</a> </li>
</ul>
</form>

实际上你不需要再手动输入每个表单项了，新版的wordprss提供了一个非常方便的函数：comment_form(),添加代码如下：

<?php ( comments_open() ) : ?>
<?php ( get_option(‘comment_registration’) && !$user_ID ) : ?>
<p><?php printf(__(‘你需要先 <a href=“%s”>登录</a> 才能发表评论.’), get_option(‘siteurl’).“/wp-login.php?redirect_to=”.urlencode(get_permalink()));?></p>
<?php : ?>
<?php $defaults = (
‘comment_notes_before’ => ”,
‘label_submit’ => __( ‘提交评论’ ),
‘comment_notes_after’ =>”
);
comment_form($defaults);
;
: ?>
<p><?php _e(‘对不起评论已经关闭.’); ?></p>
<?php ; ?>