Ticket #26532: 26532.diff

src/wp-includes/feed-atom-comments.php

@@ -12 +12 @@
         xmlns="http://www.w3.org/2005/Atom"
         xml:lang="<?php bloginfo_rss( 'language' ); ?>"
         xmlns:thr="http://purl.org/syndication/thread/1.0"
-        <?php do_action('atom_ns'); do_action('atom_comments_ns'); ?>
+        <?php 
+                /** This action is documented in wp-includes/feed-atom.php */
+                do_action( 'atom_ns' ); 
+                
+                /**
+                 * Fires inside the feed tag in the Atom comment feed.
+                 *
+                 * @since 2.8.0
+                 */
+                do_action( 'atom_comments_ns' );
+        ?>
 >
         <title type="text"><?php
                 if ( is_singular() )
@@ -39 +49 @@
         <link rel="self" type="application/atom+xml" href="<?php bloginfo_rss('comments_atom_url'); ?>" />
         <id><?php bloginfo_rss('comments_atom_url'); ?></id>
 <?php } ?>
-<?php do_action('comments_atom_head'); ?>
+<?php 
+        /**
+         * Fires at the end of the Atom comment feed header.
+         *
+         * @since 2.8.0
+         */
+        do_action( 'comments_atom_head' );
+?>
 <?php
 if ( have_comments() ) : while ( have_comments() ) : the_comment();
         $comment_post = $GLOBALS['post'] = get_post( $comment->comment_post_ID );
@@ -80 +97 @@
 ?>
                 <thr:in-reply-to ref="<?php comment_guid($parent_comment) ?>" href="<?php echo get_comment_link($parent_comment) ?>" type="<?php bloginfo_rss('html_type'); ?>" />
 <?php endif;
-        do_action('comment_atom_entry', $comment->comment_ID, $comment_post->ID);
+        /**
+         * Fires at the end of each Atom comment feed item.
+         *
+         * @since 2.2.0
+         *
+         * @param int $comment_id      ID of the current comment.
+         * @param int $comment_post_id ID of the post the current comment is connected to.
+         */
+        do_action( 'comment_atom_entry', $comment->comment_ID, $comment_post->ID );
 ?>
         </entry>
 <?php endwhile; endif; ?>