Wordpress 3.7
[autoinstalls/wordpress.git] / wp-includes / feed-rss2.php
index a20aa1ea34278139b566839b60f4c6e19fbb24a9..0ce4e6be51411bb39436786647c88d48a1838c6c 100644 (file)
@@ -17,7 +17,14 @@ echo '<?xml version="1.0" encoding="'.get_option('blog_charset').'"?'.'>'; ?>
        xmlns:atom="http://www.w3.org/2005/Atom"
        xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
        xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
-       <?php do_action('rss2_ns'); ?>
+       <?php
+       /**
+        * Fires at the end of the RSS root to add namespaces.
+        *
+        * @since 2.0.0
+        */
+       do_action( 'rss2_ns' );
+       ?>
 >
 
 <channel>
@@ -27,16 +34,46 @@ echo '<?xml version="1.0" encoding="'.get_option('blog_charset').'"?'.'>'; ?>
        <description><?php bloginfo_rss("description") ?></description>
        <lastBuildDate><?php echo mysql2date('D, d M Y H:i:s +0000', get_lastpostmodified('GMT'), false); ?></lastBuildDate>
        <language><?php bloginfo_rss( 'language' ); ?></language>
-       <sy:updatePeriod><?php echo apply_filters( 'rss_update_period', 'hourly' ); ?></sy:updatePeriod>
-       <sy:updateFrequency><?php echo apply_filters( 'rss_update_frequency', '1' ); ?></sy:updateFrequency>
-       <?php do_action('rss2_head'); ?>
-       <?php while( have_posts()) : the_post(); ?>
+       <?php
+       $duration = 'hourly';
+       /**
+        * Filter how often to update the RSS feed.
+        *
+        * @since 2.1.0
+        *
+        * @param string $duration The update period.
+        *                         Default 'hourly'. Accepts 'hourly', 'daily', 'weekly', 'monthly', 'yearly'.
+        */
+       ?>
+       <sy:updatePeriod><?php echo apply_filters( 'rss_update_period', $duration ); ?></sy:updatePeriod>
+       <?php
+       $frequency = '1';
+       /**
+        * Filter the RSS update frequency.
+        *
+        * @since 2.1.0
+        *
+        * @param string $frequency An integer passed as a string representing the frequency
+        *                          of RSS updates within the update period. Default '1'.
+        */
+       ?>
+       <sy:updateFrequency><?php echo apply_filters( 'rss_update_frequency', $frequency ); ?></sy:updateFrequency>
+       <?php
+       /**
+        * Fires at the end of the RSS2 Feed Header.
+        *
+        * @since 2.0.0
+        */
+       do_action( 'rss2_head');
+
+       while( have_posts()) : the_post();
+       ?>
        <item>
                <title><?php the_title_rss() ?></title>
                <link><?php the_permalink_rss() ?></link>
                <comments><?php comments_link_feed(); ?></comments>
                <pubDate><?php echo mysql2date('D, d M Y H:i:s +0000', get_post_time('Y-m-d H:i:s', true), false); ?></pubDate>
-               <dc:creator><?php the_author() ?></dc:creator>
+               <dc:creator><![CDATA[<?php the_author() ?>]]></dc:creator>
                <?php the_category_rss('rss2') ?>
 
                <guid isPermaLink="false"><?php the_guid(); ?></guid>
@@ -54,7 +91,14 @@ echo '<?xml version="1.0" encoding="'.get_option('blog_charset').'"?'.'>'; ?>
                <wfw:commentRss><?php echo esc_url( get_post_comments_feed_link(null, 'rss2') ); ?></wfw:commentRss>
                <slash:comments><?php echo get_comments_number(); ?></slash:comments>
 <?php rss_enclosure(); ?>
-       <?php do_action('rss2_item'); ?>
+       <?php
+       /**
+        * Fires at the end of each RSS2 feed item.
+        *
+        * @since 2.0.0
+        */
+       do_action( 'rss2_item' );
+       ?>
        </item>
        <?php endwhile; ?>
 </channel>