<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /><style type="text/css"><!--
#msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt;  }
#msg dl a { font-weight: bold}
#msg dl a:link    { color:#fc3; }
#msg dl a:active  { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding: 6px; }
#msg ul, pre { overflow: auto; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff  {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<title>[12810] trunk/wp-includes/comment-template.php: comment_form(), first pass.</title>
</head>
<body>

<div id="msg">
<dl>
<dt>Revision</dt> <dd><a href="http://trac.wordpress.org/changeset/12810">12810</a></dd>
<dt>Author</dt> <dd>ryan</dd>
<dt>Date</dt> <dd>2010-01-23 18:06:37 +0000 (Sat, 23 Jan 2010)</dd>
</dl>

<h3>Log Message</h3>
<pre>comment_form(), first pass. Props beaulebens. see <a href="http://trac.wordpress.org/ticket/10910">#10910</a></pre>

<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkwpincludescommenttemplatephp">trunk/wp-includes/comment-template.php</a></li>
</ul>

</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkwpincludescommenttemplatephp"></a>
<div class="modfile"><h4>Modified: trunk/wp-includes/comment-template.php (12809 => 12810)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-includes/comment-template.php        2010-01-23 17:59:06 UTC (rev 12809)
+++ trunk/wp-includes/comment-template.php        2010-01-23 18:06:37 UTC (rev 12810)
</span><span class="lines">@@ -833,7 +833,7 @@
</span><span class="cx"> 
</span><span class="cx">         if ( empty($file) )
</span><span class="cx">                 $file = '/comments.php';
</span><del>-
</del><ins>+        
</ins><span class="cx">         $req = get_option('require_name_email');
</span><span class="cx"> 
</span><span class="cx">         /**
</span><span class="lines">@@ -1416,4 +1416,88 @@
</span><span class="cx">         $in_comment_loop = false;
</span><span class="cx"> }
</span><span class="cx"> 
</span><ins>+/**
+ * Outputs a complete commenting form for use within a template.
+ * Most strings and form fields may be controlled through the $args array passed
+ * into the function, while you may also choose to use the comments_form_default_fields
+ * filter to modify the array of default fields if you'd just like to add a new
+ * one or remove a single field. All fields are also individually passed through
+ * a filter of the form comments_form_field_$name where $name is the key used
+ * in the array of fields.
+ *
+ * @since x.x
+ * @param array $args Options for strings, fields etc in the form
+ * @param mixed $post_id Post ID to generate the form for, uses the current post if null
+ * @return void
+ */
+function comment_form( $args = array(), $post_id = null ) {
+        global $user_identity, $id;
+                
+        if ( null === $post_id )
+                $post_id = $id;
+        else
+                $id = $post_id;
+        
+        $commenter = wp_get_current_commenter();
+        
+        $req = get_option( 'require_name_email' );
+        $aria_req = ( $req ? &quot; aria-required='true'&quot; : '' );
+        $req_str  = ( $req ? __( ' (required)' ) : '' );
+        $defaults = array( 'fields' =&gt; apply_filters( 'comment_form_default_fields', array( 'author' =&gt; '&lt;p&gt;&lt;input type=&quot;text&quot; name=&quot;author&quot; id=&quot;author&quot; value=&quot;' . esc_attr( $commenter['comment_author'] ) . '&quot; size=&quot;22&quot; tabindex=&quot;1&quot;' . $aria_req . ' /&gt; &lt;label for=&quot;author&quot;&gt;&lt;small&gt;' . __( 'Name' ) . $req_str . '&lt;/small&gt;&lt;/label&gt;&lt;/p&gt;', 
+                                                                                                                                                                            'email'  =&gt; '&lt;p&gt;&lt;input type=&quot;text&quot; name=&quot;email&quot; id=&quot;email&quot; value=&quot;' . esc_attr( $commenter['comment_author_email'] ) . '&quot; size=&quot;22&quot; tabindex=&quot;2&quot;' . $aria_req . ' /&gt; &lt;label for=&quot;email&quot;&gt;&lt;small&gt;' . __( 'Mail (will not be published)' ) . $req_str . '&lt;/small&gt;&lt;/label&gt;&lt;/p&gt;', 
+                                                                                                                                                                            'url'    =&gt; '&lt;p&gt;&lt;input type=&quot;text&quot; name=&quot;url&quot; id=&quot;url&quot; value=&quot;' . esc_attr( $commenter['comment_author_url'] ) . '&quot; size=&quot;22&quot; tabindex=&quot;3&quot; /&gt; &lt;label for=&quot;url&quot;&gt;&lt;small&gt;' . __( 'Website' ) . '&lt;/small&gt;&lt;/label&gt;&lt;/p&gt;' ) ),
+                                                'comment_field' =&gt; '&lt;p&gt;&lt;textarea name=&quot;comment&quot; id=&quot;comment&quot; cols=&quot;58&quot; rows=&quot;10&quot; tabindex=&quot;4&quot;&gt;&lt;/textarea&gt;&lt;/p&gt;', 
+                                                'must_log_in' =&gt; '&lt;p&gt;' .  sprintf( __( 'You must be &lt;a href=&quot;%s&quot;&gt;logged in&lt;/a&gt; to post a comment.' ), wp_login_url( apply_filters( 'the_permalink', get_permalink( $post_id ) ) ) ) . '&lt;/p&gt;', 
+                                                'logged_in_as' =&gt; '&lt;p&gt;' . sprintf( __( 'Logged in as &lt;a href=&quot;%s&quot;&gt;%s&lt;/a&gt;. &lt;a href=&quot;%s&quot; title=&quot;Log out of this account&quot;&gt;Log out &amp;raquo;&lt;/a&gt;&lt;/p&gt;' ), admin_url( 'profile.php' ), $user_identity, wp_logout_url( apply_filters( 'the_permalink', get_permalink( $post_id ) ) ) ), 
+                                                'id_form' =&gt; 'commentform', 
+                                                'id_submit' =&gt; 'submit', 
+                                                'title_reply' =&gt; __( 'Leave a Reply' ), 
+                                                'title_reply_to' =&gt; __( 'Leave a Reply to %s'), 
+                                                'cancel_reply_link' =&gt; '', 
+                                                'label_submit' =&gt; __( 'Submit Comment' ), 
+                                );
+        $args = wp_parse_args( $args, apply_filters( 'comment_form_defaults', $defaults ) );
+        
+        ?&gt;
+                &lt;?php if ( comments_open() ) : ?&gt;
+                        &lt;?php do_action( 'comment_form_before' ); ?&gt;
+                        &lt;div id=&quot;respond&quot;&gt;
+                                &lt;h3&gt;&lt;?php comment_form_title( $args['title_reply'], $args['title_reply_to'] ); ?&gt;&lt;/h3&gt;
+                                &lt;div class=&quot;cancel-comment-reply&quot;&gt;
+                                        &lt;small&gt;&lt;?php cancel_comment_reply_link( $args['cancel_comment_reply_link'] ); ?&gt;&lt;/small&gt;
+                                &lt;/div&gt;
+                                &lt;?php if ( get_option( 'comment_registration' ) &amp;&amp; !is_user_logged_in() ) : ?&gt;
+                                        &lt;?php echo $args['must_log_in']; ?&gt;
+                                        &lt;?php do_action( 'comment_form_must_log_in_after' ); ?&gt;
+                                &lt;?php else : ?&gt;
+                                        &lt;form action=&quot;&lt;?php echo site_url( '/wp-comments-post.php' ); ?&gt;&quot; method=&quot;post&quot; id=&quot;&lt;?php echo esc_attr( $args['id_form'] ); ?&gt;&quot;&gt;
+                                                &lt;?php do_action( 'comment_form_top' ); ?&gt;
+                                                &lt;?php if ( is_user_logged_in() ) : ?&gt;
+                                                        &lt;?php echo apply_filters( 'comment_form_logged_in', $args['logged_in_as'], $commenter, $user_identity ); ?&gt;
+                                                        &lt;?php do_action( 'comment_form_logged_in_after', $commenter, $user_identity ); ?&gt;
+                                                &lt;?php else : ?&gt;
+                                                        &lt;?php
+                                                        do_action( 'comment_form_before_fields' );
+                                                        foreach ( (array) $args['fields'] as $name =&gt; $field ) {
+                                                                echo apply_filters( &quot;comment_form_field_{$name}&quot;, $field ) . &quot;\n&quot;;
+                                                        }
+                                                        do_action( 'comment_form_after_fields' );
+                                                        ?&gt;
+                                                &lt;?php endif; ?&gt;
+                                                &lt;?php echo apply_filters( 'comment_form_field_comment', $args['comment_field'] ); ?&gt;
+                                                &lt;p&gt;
+                                                        &lt;input name=&quot;submit&quot; type=&quot;submit&quot; id=&quot;&lt;?php echo esc_attr( $args['id_submit'] ); ?&gt;&quot; tabindex=&quot;&lt;?php echo ( count( $args['fields'] ) + 2 ); ?&gt;&quot; value=&quot;&lt;?php echo esc_attr( $args['label_submit'] ); ?&gt;&quot; /&gt;
+                                                        &lt;?php comment_id_fields(); ?&gt;
+                                                &lt;/p&gt;
+                                                &lt;?php do_action( 'comments_form', $post_id ); ?&gt;
+                                        &lt;/form&gt;
+                                &lt;?php endif; ?&gt;
+                        &lt;/div&gt;
+                        &lt;?php do_action( 'comment_form_after' ); ?&gt;
+                &lt;?php else : ?&gt;
+                        &lt;?php do_action( 'comment_form_comments_closed' ); ?&gt;
+                &lt;?php endif; ?&gt;
+        &lt;?php
+}
+
</ins><span class="cx"> ?&gt;
</span></span></pre>
</div>
</div>

</body>
</html>