WordPress函数:comment_form() 让你的 WordPress 评论表单随心所愿

1、添加表单字段
2、接收表单字段并写入数据库
3、在后台显示自定义字段
4、前台的留言列表中调用
5、移除字段
本文中,使用twentysixteen 这个官方主题作为演示我们首先看看默认的评论表单:

twentysixteen

一、WordPress 表单

在 WordPress 主题中,使用 comment_form() 函数来生成一个评论表单,WordPress 3.0 新增了comment_form() 函数来构建评论表单,如果你要在主题中调用评论表单,只需要在使用下面简单的代码即可:

  1. <?php comment_form(); ?>

二、自定义字段的添加

comment_form 是可以传递一些参数,我们可以通过编写对应的参数实现表单自定义。你可以打开官方文档看一下:http://codex.wordpress.org/Function_Reference/comment_form
这里比较常用的有下面几个参数:
fields – 控制显示哪几个表单,默认的是三个:网名(name)、邮箱(email)、网址(url)。
comment_notes_before – 在评论表单前面显示提示信息。
comment_notes_after – 在评论表单后面显示提示信息。
title_reply – 这个参数改变评论表单标题,默认是:Leave a Reply。
label_submit – 这个参数改变评论表单提交按钮文字,默认是:Post Comment。
我们下面就通过修改这几个参数来实现自定义表单。

  1. add_filter('comment_form_default_fields','comment_form_add_ewai');
  2. function comment_form_add_ewai($fields) {
  3.     $label1 = __( '国家/地区' );
  4.     $label2 = __( 'Skype账号' );
  5.     $label3 = __( '电话' );
  6.     $label4 = __( '传真' );
  7.     $label5 = __( '地址' );
  8.     $value1 = isset($_POST['guojia']) ? $_POST['guojia'] : false;
  9.     $value2 = isset($_POST['skype']) ? $_POST['skype'] : false;
  10.     $value3 = isset($_POST['tel']) ? $_POST['tel'] : false;
  11.     $value4 = isset($_POST['fax']) ? $_POST['fax'] : false;
  12.     $value5 = isset($_POST['address']) ? $_POST['address'] : false;
  13.     $fields['guojia'] =<<<HTML
  14.     <p>
  15.     <label for="guojia">{$label1}</label>
  16.     <input id="guojia" name="guojia" type="text" value="{$value1}" size="30" />
  17.     </p>
  18.     HTML;
  19.     return $fields;
  20. }

今天我们以添加电话字段为例子,在functions.php添加以下代码

  1. /**
  2.  *添加评论自定义评论字段
  3.  *
  4.  */
  5. add_filter('comment_form_default_fields','comment_form_add_tel');
  6. function comment_form_add_tel($fields) {
  7.   $label = __( '电话' ); 
  8.   $value = isset($_POST['tel']) ? $_POST['tel'] : false;
  9.  
  10.   $fields['tel'] =<<<HTML
  11. <p class="comment-form-tel">
  12. <label for="tel">{$label}</label>
  13. <input id="tel" name="tel" type="text" value="{$value}" size="30" />
  14. </p>
  15. HTML;
  16.   return $fields;
  17. }

现在我们看看评论样式

twentysixteen

三、接收表单字段并写入数据库在主题目录的 functions.php添加以下代码

要想把表单提交的tel字段的数据写入后头数据库,需要在主题目录的 functions.php添加以下代码

  1. /**
  2.  *添加评论自定义评论字段写入数据库
  3.  *
  4.  */
  5. add_action('wp_insert_comment','wp_insert_tel',10,2);
  6. function wp_insert_tel($comment_ID,$commmentdata) {
  7.   $tel = isset($_POST['tel']) ? $_POST['tel'] : false;
  8.   update_comment_meta($comment_ID,'_tel',$tel);
  9. }

add_action()参数中的10和2分别表示该函数执行的优先级是10(默认值,值越小优先级越高),该函数接受2个参数。

四、在后台评论管理页面显示自定义字段

前面两步只是接收和写入到数据库,那么要怎么在后台评论列表中显示呢?将以下代码复制到主题目录的functions.php 中:

  1. /**
  2.  *后台管理页面显示自定义字段
  3.  *
  4.  */
  5. add_filter( 'manage_edit-comments_columns', 'my_comments_columns' );
  6. add_action( 'manage_comments_custom_column', 'output_my_comments_columns', 10, 2 );
  7. function my_comments_columns( $columns ){
  8.     $columns[ '_tel' ] = __( '电话' );        
  9.     return $columns;
  10. }
  11. function  output_my_comments_columns( $column_name, $comment_id ){
  12.     switch( $column_name ){
  13.     case '_tel';
  14.     echo get_comment_meta( $comment_id, '_tel', true );
  15.     break;
  16. }}

五、前台调用

如果要在前台的留言列表中调用,就用以下代码,_tel就是你在数据库中存储的字段名字

  1. <?php
  2. $tel = get_comment_meta($comment->comment_ID,'_tel',true);
  3. if( !empty($tel)){
  4.     echo "电话".$tel;
  5. }
  6. ?>

六、后台效果

twentysixteen

六、移除字段

将以下代码复制到主题目录的functions.php 中

  1. /**
  2.  *移除自定义字段
  3.  *
  4.  */
  5. function tel_filtered($fields){
  6.     if(isset($fields['tel']))
  7.     unset($fields['tel']);
  8.     return $fields;
  9. }
  10. add_filter('comment_form_default_fields', 'tel_filtered');

以上只是以添加电话为例子,你可以参考以上代码修改添加你希望的字段,让你的主题评论更加个性化。


发布日期:

所属分类: Wordpress, WordPress 函数 标签:     


没有相关文章!