WordPress.org
Get WordPress

Make WordPress Core

Ticket #25396: 25396.diff

File 25396.diff, 21.6 KB (added by DrewAPicture, 11 years ago)

  • src/wp-includes/comment-template.php

     
    3131                $author = $comment->comment_author;
    3232        }
    3333
     34        /**
     35         * Filter the returned comment author name.
     36         *
     37         * @since 1.5.2
     38         *
     39         * @param string $author The comment author's username.
     40         */
    3441        return apply_filters( 'get_comment_author', $author );
    3542}
    3643
    … …  
    4249 * @param int $comment_ID Optional. The ID of the comment for which to print the author. Default current comment.
    4350 */
    4451function comment_author( $comment_ID = 0 ) {
    45         $author = apply_filters('comment_author', get_comment_author( $comment_ID ) );
     52        $author = get_comment_author( $comment_ID );
     53        /**
     54         * Filter the comment author's name for display.
     55         *
     56         * @since 1.2.1
     57         *
     58         * @param string $author The comment author's username.
     59         */
     60        $author = apply_filters( 'comment_author', $author );
    4661        echo $author;
    4762}
    4863
    … …  
    5671 */
    5772function get_comment_author_email( $comment_ID = 0 ) {
    5873        $comment = get_comment( $comment_ID );
    59         return apply_filters('get_comment_author_email', $comment->comment_author_email);
     74        /**
     75         * Filter the comment author's returned email address.
     76         *
     77         * @since 1.5.2
     78         *
     79         * @param string $comment->comment_author_email The comment author's email address.
     80         */
     81        return apply_filters( 'get_comment_author_email', $comment->comment_author_email );
    6082}
    6183
    6284/**
    … …  
    7395 * @param int $comment_ID Optional. The ID of the comment for which to print the author's email. Default current comment.
    7496 */
    7597function comment_author_email( $comment_ID = 0 ) {
    76         echo apply_filters('author_email', get_comment_author_email( $comment_ID ) );
     98        $author_email = get_comment_author_email( $comment_ID );
     99        /**
     100         * Filter the comment author's email for display.
     101         *
     102         * @since 1.2.1
     103         *
     104         * @param string $author_email The comment author's email address.
     105         */
     106        echo apply_filters( 'author_email', $author_email );
    77107}
    78108
    79109/**
    … …  
    117147 */
    118148function get_comment_author_email_link( $linktext = '', $before = '', $after = '' ) {
    119149        global $comment;
    120         $email = apply_filters('comment_email', $comment->comment_author_email);
     150        /**
     151         * Filter the comment author's email for display.
     152         *
     153         * Care should be taken to protect the email address and assure that email
     154         * harvesters do not capture your commentors' email address.
     155         *
     156         * @since 1.2.1
     157         *
     158         * @param string $comment->comment_author_email The comment author's email address.
     159         */
     160        $email = apply_filters( 'comment_email', $comment->comment_author_email );
    121161        if ((!empty($email)) && ($email != '@')) {
    122162        $display = ($linktext != '') ? $linktext : $email;
    123163                $return  = $before;
    … …  
    148188                $return = $author;
    149189        else
    150190                $return = "<a href='$url' rel='external nofollow' class='url'>$author</a>";
    151         return apply_filters('get_comment_author_link', $return);
     191
     192        /**
     193         * Filter the comment author's link for display.
     194         *
     195         * @since 1.5.2
     196         *
     197         * @param string $return The HTML-formatted comment author link. Empty for an invalid URL.
     198         */
     199        return apply_filters( 'get_comment_author_link', $return );
    152200}
    153201
    154202/**
    … …  
    173221 */
    174222function get_comment_author_IP( $comment_ID = 0 ) {
    175223        $comment = get_comment( $comment_ID );
    176         return apply_filters('get_comment_author_IP', $comment->comment_author_IP);
     224
     225        /**
     226         * Filter the comment author's IP returned address.
     227         *
     228         * @since 1.5.2
     229         *
     230         * @param string $comment->comment_author_IP The comment author's IP address.
     231         */
     232        return apply_filters( 'get_comment_author_IP', $comment->comment_author_IP );
    177233}
    178234
    179235/**
    … …  
    210266 * @param int $comment_ID Optional. The ID of the comment for which to print the author's URL. Default current comment.
    211267 */
    212268function comment_author_url( $comment_ID = 0 ) {
    213         echo apply_filters('comment_url', get_comment_author_url( $comment_ID ));
     269        $author_url = get_comment_author_url( $comment_ID );
     270        /**
     271         * Filter the comment author's URL for display.
     272         *
     273         * @since 1.2.1
     274         *
     275         * @param string $author_url The comment author's URL.
     276         */
     277        echo apply_filters( 'comment_url', $author_url );
    214278}
    215279
    216280/**
    … …  
    238302        if ( '/' == substr($display, -1) )
    239303                $display = substr($display, 0, -1);
    240304        $return = "$before<a href='$url' rel='external'>$display</a>$after";
    241         return apply_filters('get_comment_author_url_link', $return);
     305
     306        /**
     307         * Filter the comment author's returned URL link.
     308         *
     309         * @since 1.5.2
     310         *
     311         * @param string $return The HTML-formatted comment author URL link.
     312         */
     313        return apply_filters( 'get_comment_author_url_link', $return );
    242314}
    243315
    244316/**
    … …  
    342414
    343415        $classes = array_map('esc_attr', $classes);
    344416
    345         return apply_filters('comment_class', $classes, $class, $comment_id, $post_id);
     417        /**
     418         * Filter the returned CSS classes for the current comment.
     419         *
     420         * @since 2.7.0
     421         *
     422         * @param array       $classes    An array of comment classes.
     423         * @param string      $class      A comma-separated list of additional classes added to the list.
     424         * @param int         $comment_id The comment id.
     425         * @param int|WP_Post $post_id    The post ID or WP_Post object.
     426         */
     427        return apply_filters( 'comment_class', $classes, $class, $comment_id, $post_id );
    346428}
    347429
    348430/**
    … …  
    360442                $date = mysql2date(get_option('date_format'), $comment->comment_date);
    361443        else
    362444                $date = mysql2date($d, $comment->comment_date);
    363         return apply_filters('get_comment_date', $date, $d);
     445        /**
     446         * Filter the returned comment date.
     447         *
     448         * @since 1.5.2
     449         *
     450         * @param string|int $date Formatted date string or Unix timestamp.
     451         * @param string     $d    The format of the date.
     452         */
     453        return apply_filters( 'get_comment_date', $date, $d );
    364454}
    365455
    366456/**
    … …  
    414504 * @param int $comment_ID Optional. The ID of the comment for which to print the excerpt. Default current comment.
    415505 */
    416506function comment_excerpt( $comment_ID = 0 ) {
    417         echo apply_filters('comment_excerpt', get_comment_excerpt($comment_ID) );
     507        $comment_excerpt = get_comment_excerpt($comment_ID);
     508        /**
     509         * Filter the comment excerpt for display.
     510         *
     511         * @since 1.2.1
     512         *
     513         * @param string $comment_excerpt The comment excerpt text.
     514         */
     515        echo apply_filters( 'comment_excerpt', $comment_excerpt );
    418516}
    419517
    420518/**
    … …  
    426524 */
    427525function get_comment_ID() {
    428526        global $comment;
    429         return apply_filters('get_comment_ID', $comment->comment_ID);
     527        /**
     528         * Filter the returned comment ID.
     529         *
     530         * @since 1.5.2
     531         *
     532         * @param int $comment->comment_ID The current comment ID.
     533         */
     534        return apply_filters( 'get_comment_ID', $comment->comment_ID );
    430535}
    431536
    432537/**
    … …  
    482587                $link = get_permalink( $comment->comment_post_ID );
    483588        }
    484589
    485         return apply_filters( 'get_comment_link', $link . '#comment-' . $comment->comment_ID, $comment, $args );
     590        $link = $link . '#comment-' . $comment->comment_ID;
     591        /**
     592         * Filter the returned single comment permalink.
     593         *
     594         * @since 2.8.0
     595         *
     596         * @param string $link    The comment permalink with '#comment-$id' appended.
     597         * @param object $comment The current comment object.
     598         * @param array  $args    An array of arguments to override the defaults. @see get_page_of_comment()
     599         */
     600        return apply_filters( 'get_comment_link', $link, $comment, $args );
    486601}
    487602
    488603/**
    … …  
    494609 * @return string The link to the comments.
    495610 */
    496611function get_comments_link( $post_id = 0 ) {
    497         return apply_filters( 'get_comments_link', get_permalink( $post_id ) . '#comments', $post_id );
     612        $comments_link = get_permalink( $post_id ) . '#comments';
     613        /**
     614         * Filter the returned post comments permalink.
     615         *
     616         * @since
     617         *
     618         * @param string      $comments_link The post comments permalink with '#comments' appended.
     619         * @param int|WP_Post $post_id       The post ID or WP_Post object.
     620         */
     621        return apply_filters( 'get_comments_link', $comments_link, $post_id );
    498622}
    499623
    500624/**
    … …  
    533657        else
    534658                $count = $post->comment_count;
    535659
    536         return apply_filters('get_comments_number', $count, $post_id);
     660        /**
     661         * Filter the returned comment count for a post.
     662         *
     663         * @since 1.5.2
     664         *
     665         * @param int         $count   The number of comments a post has.
     666         * @param int|WP_Post $post_id The post ID or WP_Post object.
     667         */
     668        return apply_filters( 'get_comments_number', $count, $post_id );
    537669}
    538670
    539671/**
    … …  
    559691        else // must be one
    560692                $output = ( false === $one ) ? __('1 Comment') : $one;
    561693
    562         echo apply_filters('comments_number', $output, $number);
     694        /**
     695         * Filter the comments count for display.
     696         *
     697         * @since 1.5.2
     698         *
     699         * @param string $output A translatable string formatted based on whether the count is equal to 0, 1, or 1+. @see _n()
     700         * @param int    $number The number of post comments.
     701         */
     702        echo apply_filters( 'comments_number', $output, $number );
    563703}
    564704
    565705/**
    … …  
    629769                $date = mysql2date(get_option('time_format'), $comment_date, $translate);
    630770        else
    631771                $date = mysql2date($d, $comment_date, $translate);
    632         return apply_filters('get_comment_time', $date, $d, $gmt, $translate);
     772
     773        /**
     774         * Filter the returned comment time.
     775         *
     776         * @since 1.5.2
     777         *
     778         * @param string|int $date      Formatted date string or Unix timestamp.
     779         * @param string     $d         The date format.
     780         * @param bool       $gmt       Whether the GMT date is in use.
     781         * @param bool       $translate Whether the time is translated.
     782         */
     783        return apply_filters( 'get_comment_time', $date, $d, $gmt, $translate );
    633784}
    634785
    635786/**
    … …  
    656807        if ( '' == $comment->comment_type )
    657808                $comment->comment_type = 'comment';
    658809
    659         return apply_filters('get_comment_type', $comment->comment_type);
     810        /**
     811         * Filter the returned comment type.
     812         *
     813         * @since 1.5.2
     814         *
     815         * @param string $comment->comment_type The type of comment, such as 'comment', 'pingback', or 'trackback'.
     816         */
     817        return apply_filters( 'get_comment_type', $comment->comment_type );
    660818}
    661819
    662820/**
    … …  
    697855 * @return string The trackback URL after being filtered.
    698856 */
    699857function get_trackback_url() {
    700         if ( '' != get_option('permalink_structure') ) {
     858        if ( '' != get_option('permalink_structure') )
    701859                $tb_url = trailingslashit(get_permalink()) . user_trailingslashit('trackback', 'single_trackback');
    702         } else {
     860        else
    703861                $tb_url = get_option('siteurl') . '/wp-trackback.php?p=' . get_the_ID();
    704         }
    705         return apply_filters('trackback_url', $tb_url);
     862
     863        /**
     864         * Filter the returned trackback URL.
     865         *
     866         * @since 2.2.0
     867         *
     868         * @param string $tb_url The trackback URL.
     869         */
     870        return apply_filters( 'trackback_url', $tb_url );
    706871}
    707872
    708873/**
    … …  
    765930        $_post = get_post($post_id);
    766931
    767932        $open = ( 'open' == $_post->comment_status );
     933
     934        /**
     935         * Filter whether the current post is open for comments.
     936         *
     937         * @since
     938         *
     939         * @param bool        $open    Whether the current post is open for comments.
     940         * @param int|WP_Post $post_id The post ID or WP_Post object.
     941         */
    768942        return apply_filters( 'comments_open', $open, $post_id );
    769943}
    770944
    … …  
    8761050        }
    8771051
    8781052        // keep $comments for legacy's sake
     1053        /**
     1054         * Filter the comments array.
     1055         *
     1056         * @since 2.1.0
     1057         *
     1058         * @param array $comments The array of comments supplied to the comments template.
     1059         * @param int   $post->ID The post ID.
     1060         */
    8791061        $wp_query->comments = apply_filters( 'comments_array', $comments, $post->ID );
    8801062        $comments = &$wp_query->comments;
    8811063        $wp_query->comment_count = count($wp_query->comments);
    … …  
    8951077        if ( !defined('COMMENTS_TEMPLATE') )
    8961078                define('COMMENTS_TEMPLATE', true);
    8971079
    898         $include = apply_filters('comments_template', STYLESHEETPATH . $file );
     1080        $theme_template = STYLESHEETPATH . $file;
     1081        /**
     1082         * Filter the path to the theme template file used for the comments template.
     1083         *
     1084         * @since 1.5.2
     1085         *
     1086         * @param string $theme_template The path to the theme template file.
     1087         */
     1088        $include = apply_filters( 'comments_template', $theme_template );
    8991089        if ( file_exists( $include ) )
    9001090                require( $include );
    9011091        elseif ( file_exists( TEMPLATEPATH . $file ) )
    … …  
    9971187        }
    9981188        $title = the_title_attribute( array('echo' => 0 ) );
    9991189
    1000         echo apply_filters( 'comments_popup_link_attributes', '' );
     1190        $attributes = '';
     1191        /**
     1192         * Filter the comments popup link attributes for display.
     1193         *
     1194         * @since 2.5.0
     1195         *
     1196         * @param string $attributes The comments popup link attributes. Default empty.
     1197         */
     1198        echo apply_filters( 'comments_popup_link_attributes', $attributes );
    10011199
    10021200        echo ' title="' . esc_attr( sprintf( __('Comment on %s'), $title ) ) . '">';
    10031201        comments_number( $zero, $one, $more );
    … …  
    11301328        if ( !comments_open($post->ID) )
    11311329                return false;
    11321330
    1133         if ( get_option('comment_registration') && ! is_user_logged_in() ) {
     1331        if ( get_option('comment_registration') && ! is_user_logged_in() )
    11341332                $link = '<a rel="nofollow" href="' . wp_login_url( get_permalink() ) . '">' . $login_text . '</a>';
    1135         } else {
     1333        else
    11361334                $link = "<a rel='nofollow' class='comment-reply-link' href='" . get_permalink($post->ID) . "#$respond_id' onclick='return addComment.moveForm(\"$add_below-$post->ID\", \"0\", \"$respond_id\", \"$post->ID\")'>$reply_text</a>";
    1137         }
    1138         return apply_filters('post_comments_link', $before . $link . $after, $post);
     1335
     1336        $formatted_link = $before . $link . $after;
     1337        /**
     1338         * Filter the formatted post comments link HTML.
     1339         *
     1340         * @since 2.7.0
     1341         *
     1342         * @param string      $formatted The HTML-formatted post comments link.
     1343         * @param int|WP_Post $post      The post ID or WP_Post object.
     1344         */
     1345        return apply_filters( 'post_comments_link', $formatted_link, $post );
    11391346}
    11401347
    11411348/**
    … …  
    11641371
    11651372        $style = isset($_GET['replytocom']) ? '' : ' style="display:none;"';
    11661373        $link = esc_html( remove_query_arg('replytocom') ) . '#respond';
    1167         return apply_filters('cancel_comment_reply_link', '<a rel="nofollow" id="cancel-comment-reply-link" href="' . $link . '"' . $style . '>' . $text . '</a>', $link, $text);
     1374
     1375        $formatted_link = '<a rel="nofollow" id="cancel-comment-reply-link" href="' . $link . '"' . $style . '>' . $text . '</a>';
     1376        /**
     1377         * Filter the cancel comment reply link HTML.
     1378         *
     1379         * @since 2.7.0
     1380         *
     1381         * @param string $formatted_link The HTML-formatted cancel comment reply link.
     1382         * @param string $link           The cancel comment reply link URL.
     1383         * @param string $text           The cancel comment reply link text.
     1384         */
     1385        return apply_filters( 'cancel_comment_reply_link', $formatted_link, $link, $text );
    11681386}
    11691387
    11701388/**
    … …  
    11931411        $replytoid = isset($_GET['replytocom']) ? (int) $_GET['replytocom'] : 0;
    11941412        $result  = "<input type='hidden' name='comment_post_ID' value='$id' id='comment_post_ID' />\n";
    11951413        $result .= "<input type='hidden' name='comment_parent' id='comment_parent' value='$replytoid' />\n";
    1196         return apply_filters('comment_id_fields', $result, $id, $replytoid);
     1414
     1415        /**
     1416         * Filter the returned comment id fields.
     1417         *
     1418         * @since 3.0.0
     1419         *
     1420         * @param string $result    The HTML-formatted hidden id field comment elements.
     1421         * @param int    $id        The post ID.
     1422         * @param int    $replytoid The id of the comment being replied to.
     1423         */
     1424        return apply_filters( 'comment_id_fields', $result, $id, $replytoid );
    11971425}
    11981426
    11991427/**
    … …  
    16951923        );
    16961924
    16971925        $required_text = sprintf( ' ' . __('Required fields are marked %s'), '<span class="required">*</span>' );
     1926
     1927        /**
     1928         * Filter the default comment form fields.
     1929         *
     1930         * @since 3.0.0
     1931         *
     1932         * @param array $fields The default comment fields.
     1933         */
     1934        $fields = apply_filters( 'comment_form_default_fields', $fields );
    16981935        $defaults = array(
    1699                 'fields'               => apply_filters( 'comment_form_default_fields', $fields ),
     1936                'fields'               => $fields,
    17001937                '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>',
    17011938                '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>',
    17021939                '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>' ), get_edit_user_link(), $user_identity, wp_logout_url( apply_filters( 'the_permalink', get_permalink( $post_id ) ) ) ) . '</p>',
    … …  
    17111948                'format'               => 'xhtml',
    17121949        );
    17131950
     1951        /**
     1952         * Filter the comment form default arguments.
     1953         *
     1954         * Use 'comment_form_default_fields' to filter the comment fields.
     1955         *
     1956         * @since 3.0.0
     1957         *
     1958         * @param array $defaults The default comment form arguments.
     1959         */
    17141960        $args = wp_parse_args( $args, apply_filters( 'comment_form_defaults', $defaults ) );
    17151961
    17161962        ?>
    17171963                <?php if ( comments_open( $post_id ) ) : ?>
    1718                         <?php do_action( 'comment_form_before' ); ?>
     1964                        <?php
     1965                        /**
     1966                         * Fires before the comment form.
     1967                         *
     1968                         * @since 3.0.0
     1969                         */
     1970                        do_action( 'comment_form_before' );
     1971                        ?>
    17191972                        <div id="respond" class="comment-respond">
    17201973                                <h3 id="reply-title" class="comment-reply-title"><?php comment_form_title( $args['title_reply'], $args['title_reply_to'] ); ?> <small><?php cancel_comment_reply_link( $args['cancel_reply_link'] ); ?></small></h3>
    17211974                                <?php if ( get_option( 'comment_registration' ) && !is_user_logged_in() ) : ?>
    17221975                                        <?php echo $args['must_log_in']; ?>
    1723                                         <?php do_action( 'comment_form_must_log_in_after' ); ?>
     1976                                        <?php
     1977                                        /**
     1978                                         * Fires after the HTML-formatted 'must log in after' message in the comment form.
     1979                                         *
     1980                                         * @since 3.0.0
     1981                                         */
     1982                                        do_action( 'comment_form_must_log_in_after' );
     1983                                        ?>
    17241984                                <?php else : ?>
    17251985                                        <form action="<?php echo site_url( '/wp-comments-post.php' ); ?>" method="post" id="<?php echo esc_attr( $args['id_form'] ); ?>" class="comment-form"<?php echo $html5 ? ' novalidate' : ''; ?>>
    1726                                                 <?php do_action( 'comment_form_top' ); ?>
     1986                                                <?php
     1987                                                /**
     1988                                                 * Fires at the top of the comment form, inside the <form> tag.
     1989                                                 *
     1990                                                 * @since 3.0.0
     1991                                                 */
     1992                                                do_action( 'comment_form_top' );
     1993                                                ?>
    17271994                                                <?php if ( is_user_logged_in() ) : ?>
    1728                                                         <?php echo apply_filters( 'comment_form_logged_in', $args['logged_in_as'], $commenter, $user_identity ); ?>
    1729                                                         <?php do_action( 'comment_form_logged_in_after', $commenter, $user_identity ); ?>
     1995                                                        <?php
     1996                                                        /**
     1997                                                         * Filter the 'logged in' message for the comment form for display.
     1998                                                         *
     1999                                                         * @since 3.0.0
     2000                                                         *
     2001                                                         * @param string $args['logged_in_as'] The logged-in-as HTML-formatted message.
     2002                                                         * @param array  $commenter            An array containing the comment author's username, email, and URL.
     2003                                                         * @param string $user_identity        If the commenter is a registered user, the display name, blank otherwise.
     2004                                                         */
     2005                                                        echo apply_filters( 'comment_form_logged_in', $args['logged_in_as'], $commenter, $user_identity );
     2006                                                        ?>
     2007                                                        <?php
     2008                                                        /**
     2009                                                         * Fires after the is_user_logged_in() check in the comment form.
     2010                                                         *
     2011                                                         * @since 3.0.0
     2012                                                         *
     2013                                                         * @param array  $commenter     An array containing the comment author's username, email, and URL.
     2014                                                         * @param string $user_identity If the commenter is a registered user, the display name, blank otherwise.
     2015                                                         */
     2016                                                        do_action( 'comment_form_logged_in_after', $commenter, $user_identity );
     2017                                                        ?>
    17302018                                                <?php else : ?>
    17312019                                                        <?php echo $args['comment_notes_before']; ?>
    17322020                                                        <?php
     2021                                                        /**
     2022                                                         * Fires before the comment fields in the comment form.
     2023                                                         *
     2024                                                         * @since 3.0.0
     2025                                                         */
    17332026                                                        do_action( 'comment_form_before_fields' );
    17342027                                                        foreach ( (array) $args['fields'] as $name => $field ) {
     2028                                                                /**
     2029                                                                 * Filter a comment form field for display.
     2030                                                                 *
     2031                                                                 * The dynamic portion of the filter hook, $name, refers to the name
     2032                                                                 * of the comment form field. Such as 'author', 'email', or 'url'.
     2033                                                                 *
     2034                                                                 * @since 3.0.0
     2035                                                                 *
     2036                                                                 * @param string $field The HTML-formatted output of the comment form field.
     2037                                                                 */
    17352038                                                                echo apply_filters( "comment_form_field_{$name}", $field ) . "\n";
    17362039                                                        }
     2040                                                        /**
     2041                                                         * Fires after the comment fields in the comment form.
     2042                                                         *
     2043                                                         * @since 3.0.0
     2044                                                         */
    17372045                                                        do_action( 'comment_form_after_fields' );
    17382046                                                        ?>
    17392047                                                <?php endif; ?>
    1740                                                 <?php echo apply_filters( 'comment_form_field_comment', $args['comment_field'] ); ?>
     2048                                                <?php
     2049                                                /**
     2050                                                 * Filter the content of the comment textarea field for display.
     2051                                                 *
     2052                                                 * @since 3.0.0
     2053                                                 *
     2054                                                 * @param string $args['comment_field'] The content of the comment textarea field.
     2055                                                 */
     2056                                                echo apply_filters( 'comment_form_field_comment', $args['comment_field'] );
     2057                                                ?>
    17412058                                                <?php echo $args['comment_notes_after']; ?>
    17422059                                                <p class="form-submit">
    17432060                                                        <input name="submit" type="submit" id="<?php echo esc_attr( $args['id_submit'] ); ?>" value="<?php echo esc_attr( $args['label_submit'] ); ?>" />
    17442061                                                        <?php comment_id_fields( $post_id ); ?>
    17452062                                                </p>
    1746                                                 <?php do_action( 'comment_form', $post_id ); ?>
     2063                                                <?php
     2064                                                /**
     2065                                                 * Fires at the bottom of the comment form, inside the closing </form> tag.
     2066                                                 *
     2067                                                 * @since 1.5.2
     2068                                                 *
     2069                                                 * @param int $post_id The post ID.
     2070                                                 */
     2071                                                do_action( 'comment_form', $post_id );
     2072                                                ?>
    17472073                                        </form>
    17482074                                <?php endif; ?>
    17492075                        </div><!-- #respond -->
    1750                         <?php do_action( 'comment_form_after' ); ?>
    1751                 <?php else : ?>
    1752                         <?php do_action( 'comment_form_comments_closed' ); ?>
    1753                 <?php endif; ?>
    1754         <?php
     2076                        <?php
     2077                        /**
     2078                         * Fires after the comment form.
     2079                         *
     2080                         * @since 3.0.0
     2081                         */
     2082                        do_action( 'comment_form_after' );
     2083                else :
     2084                        /**
     2085                         * Fires after the comment form if comments are closed.
     2086                         *
     2087                         * @since 3.0.0
     2088                         */
     2089                        do_action( 'comment_form_comments_closed' );
     2090                endif;
    17552091}