Changeset 25531

Timestamp:

09/20/2013 10:49:36 PM (11 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()?>"/>