Changeset 25531

Timestamp:

09/20/2013 10:49:36 PM (13 years ago)

Author:

DrewAPicture

Message:

Inline documentation for hooks in wp-includes/feed-atom.php.

Props dustyf.
See #25229.

File:

• trunk/src/wp-includes/feed-atom.php (modified) (4 diffs)

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

@@ -15 +15 @@
   xml:lang="<?php bloginfo_rss( 'language' ); ?>"
   xml:base="<?php bloginfo_rss('url') ?>/wp-atom.php"
-  <?php do_action('atom_ns'); ?>
+  <?php
+  /**
+   * Fires at end of the Atom feed root to add namespaces.
+   *
+   * @since 2.0.0
+   */
+  do_action( 'atom_ns' );
+  ?>
  >
         <title type="text"><?php bloginfo_rss('name'); wp_title_rss(); ?></title>
@@ -26 +33 @@
         <link rel="self" type="application/atom+xml" href="<?php self_link(); ?>" />
 
-        <?php do_action('atom_head'); ?>
-        <?php while (have_posts()) : the_post(); ?>
+        <?php
+        /**
+         * Fires just before the first Atom feed entry.
+         *
+         * @since 2.0.0
+         */
+        do_action( 'atom_head' );
+
+        while ( have_posts() ) : the_post();
+        ?>
         <entry>
                 <author>
@@ -34 +49 @@
                         <uri><?php the_author_meta('url')?></uri>
                         <?php endif;
-                        do_action('atom_author'); ?>
+
+                        /**
+                         * Fires at the end of each Atom feed author entry.
+                         *
+                         * @since 3.2.0
+                         */
+                        do_action( 'atom_author' );
+                ?>
                 </author>
                 <title type="<?php html_type_rss(); ?>"><![CDATA[<?php the_title_rss() ?>]]></title>
@@ -46 +68 @@
                 <content type="<?php html_type_rss(); ?>" xml:base="<?php the_permalink_rss() ?>"><![CDATA[<?php the_content_feed('atom') ?>]]></content>
 <?php endif; ?>
-<?php atom_enclosure(); ?>
-<?php do_action('atom_entry'); ?>
+        <?php atom_enclosure();
+        /**
+         * Fires at the end of each Atom feed item.
+         *
+         * @since 2.0.0
+         */
+        do_action( 'atom_entry' );
+                ?>
                 <link rel="replies" type="<?php bloginfo_rss('html_type'); ?>" href="<?php the_permalink_rss() ?>#comments" thr:count="<?php echo get_comments_number()?>"/>
                 <link rel="replies" type="application/atom+xml" href="<?php echo esc_url( get_post_comments_feed_link(0, 'atom') ); ?>" thr:count="<?php echo get_comments_number()?>"/>