wordpress 如何實現自定義表單？

調用 comment_form()

如果你要在主題中調用評論表單，只需要在使用下面簡單的代碼即可：

1	<?php comment_form(); ?>

就像我們在官方的主題 twentyfourteen 的 comments.php 文件的倒數第2行看到一樣：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55

<?php /** * The template for displaying Comments * * The area of the page that contains comments and the comment form. * * @package WordPress * @subpackage Twenty_Fourteen * @since Twenty Fourteen 1.0 */ /* * If the current post is protected by a password and the visitor has not yet * entered the password we will return early without loading the comments. */ if ( post_password_required() ) { return; } ?> <div id="comments" class="comments-area"> <?php if ( have_comments() ) : ?> <h2 class="comments-title"> <?php printf( _n( 'One thought on “%2$s”', '%1$s thoughts on “%2$s”', get_comments_number(), 'twentyfourteen' ), number_format_i18n( get_comments_number() ), get_the_title() ); ?> </h2> <?php if ( get_comment_pages_count() > 1 && get_option( 'page_comments' ) ) : ?> <nav id="comment-nav-above" class="navigation comment-navigation" role="navigation"> <h1 class="screen-reader-text"><?php _e( 'Comment navigation', 'twentyfourteen' ); ?></h1> <div class="nav-previous"><?php previous_comments_link( __( '← Older Comments', 'twentyfourteen' ) ); ?></div> <div class="nav-next"><?php next_comments_link( __( 'Newer Comments →', 'twentyfourteen' ) ); ?></div> </nav><!-- #comment-nav-above --> <?php endif; // Check for comment navigation. ?> <ol class="comment-list"> <?php wp_list_comments( array( 'style' => 'ol', 'short_ping' => true, 'avatar_size'=> 34, ) ); ?> </ol><!-- .comment-list --> <?php if ( get_comment_pages_count() > 1 && get_option( 'page_comments' ) ) : ?> <nav id="comment-nav-below" class="navigation comment-navigation" role="navigation"> <h1 class="screen-reader-text"><?php _e( 'Comment navigation', 'twentyfourteen' ); ?></h1> <div class="nav-previous"><?php previous_comments_link( __( '← Older Comments', 'twentyfourteen' ) ); ?></div> <div class="nav-next"><?php next_comments_link( __( 'Newer Comments →', 'twentyfourteen' ) ); ?></div> </nav><!-- #comment-nav-below --> <?php endif; // Check for comment navigation. ?> <?php if ( ! comments_open() ) : ?> <p class="no-comments"><?php _e( 'Comments are closed.', 'twentyfourteen' ); ?></p> <?php endif; ?> <?php endif; // have_comments() ?> <?php comment_form(); ?> </div><!-- #comments -->

comment_form() 參數

1	<?php comment_form($args, $post_id); ?>

• $args：comment_form() 的輸出配置參數，為一個關聯數組，配置項非常豐富，下面我們會詳細說明。
• $post_id：文章id，默認為空，即當前id
• $args的默認配置：

1 2 3 4 5 6 7 8 9 10 11 12 13 14

$defaults = array( 'fields' => apply_filters( 'comment_form_default_fields', $fields ), 'comment_field' => '<p class="comment-form-comment"><label for="comment">' . _x( 'Comment', 'noun' ) . '</label><textarea id="comment" name="comment" cols="45" rows="8" aria-required="true"></textarea></p>', 'must_log_in' => '<p class="must-log-in">' . sprintf( __( 'You must be <a href="%s">logged in</a> to post a comment.' ), wp_login_url( apply_filters( 'the_permalink', get_permalink( $post_id ) ) ) ) . '</p>', 'logged_in_as' => '<p class="logged-in-as">' . sprintf( __( 'Logged in as <a href="%1$s">%2$s</a>. <a href="%3$s" title="Log out of this account">Log out?</a>' ), admin_url( 'profile.php' ), $user_identity, wp_logout_url( apply_filters( 'the_permalink', get_permalink( $post_id ) ) ) ) . '</p>', 'comment_notes_before' => '<p class="comment-notes">' . __( 'Your email address will not be published.' ) . ( $req ? $required_text : '' ) . '</p>', 'comment_notes_after' => '<p class="form-allowed-tags">' . sprintf( __( 'You may use these <abbr title="HyperText Markup Language">HTML</abbr> tags and attributes: %s' ), ' <code>' . allowed_tags() . '</code>' ) . '</p>', 'id_form' => 'commentform', 'id_submit' => 'submit', 'title_reply' => __( 'Leave a Reply' ), 'title_reply_to' => __( 'Leave a Reply to %s' ), 'cancel_reply_link' => __( 'Cancel reply' ), 'label_submit' => __( 'Post Comment' ), );

自定義評論表單

刪除表單字段

如果我們想要刪除網址字段，只需要打開主題的 functions.php 文件，添加以下代碼：

1 2 3 4 5 6

add_filter('comment_form_default_fields', 'mytheme_remove_url');   function mytheme_remove_url($arg) { $arg['url'] = ''; return $arg; }

保存后刷新頁面，你就會看到“url”輸入框已經不存在了。

新增表單字段

假設我們要添加一個 QQ 字段，同樣在主題的 functions.php 添加下面的代碼即可：

1 2 3 4 5 6

function my_fields($fields) { $fields['qq'] = '<p class="comment-form-qq">' . '<label for="qq">'.__('QQ').'</label> ' . '<input id="qq" name="qq" type="text" value="' . esc_attr( $commenter['comment_qq'] ) . '" size="30" /></p>'; return $fields; } add_filter('comment_form_default_fields','my_fields');

刷新頁面，即可看到新增的表單。

替換默認表單字段

代碼和上面的例子差不多，如果你設置的字段為（author、email、url）其中之一，即 $fields[‘author’]、$fields[’email’]、$fields[‘url’] ，就可以替換默認的字段的輸出內容。

默認的這三個字段如下：

1 2 3 4 5 6 7 8

$fields = array( 'author' => '<p class="comment-form-author">' . '<label for="author">' . __( 'Name' ) . '</label> ' . ( $req ? '<span class="required">*</span>' : '' ) . '<input id="author" name="author" type="text" value="' . esc_attr( $commenter['comment_author'] ) . '" size="30"' . $aria_req . ' /></p>', 'email' => '<p class="comment-form-email"><label for="email">' . __( 'Email' ) . '</label> ' . ( $req ? '<span class="required">*</span>' : '' ) . '<input id="email" name="email" type="text" value="' . esc_attr( $commenter['comment_author_email'] ) . '" size="30"' . $aria_req . ' /></p>', 'url' => '<p class="comment-form-url"><label for="url">' . __( 'Website' ) . '</label>' . '<input id="url" name="url" type="text" value="' . esc_attr( $commenter['comment_author_url'] ) . '" size="30" /></p>', );

comment_form() 鈎子

評論表單同時還帶了不少鈎子，讓你可以在喜歡的位置添加你想要的內容，具體鈎子如下：

• comment_form_before
• comment_form_must_log_in_after
• comment_form_top
• comment_form_logged_in_after
• comment_notes_before
• comment_form_before_fields
• comment_form_field_{$name}
• comment_form_after_fields
• comment_form_field_comment
• comment_form (action hook)
• comment_form_after
• comment_form_comments_closed

在這里，倡萌只簡單舉一個小例子，在默認字段后面顯示一句話，同樣添加到主題的 functions.php ：

1 2 3 4 5 6 7

function add_my_tips() { echo '歡迎踴躍發言！'; } // 在默認字段（前面說的姓名、郵箱和網址）的下面添加字段 add_filter('comment_form_after_fields', 'add_my_tips'); // 在已登錄下面添加字段（因為用戶登錄后，是沒有默認上面三個字段的），所以要使用這個鈎子插入內容 add_filter('comment_form_logged_in_after', 'add_my_tips');

其他的就靠大家多多實踐了。

更多信息，請參考官方文檔：http://codex.wordpress.org/Function_Reference/comment_form