WordPress 4.3-scripts
[autoinstalls/wordpress.git] / wp-includes / feed-rss2.php
index 538f96b72755cfc208597992e98b2390505ae5d7..c82fc63c56c970a8b8835abaea7cd27565b74b77 100644 (file)
@@ -5,11 +5,21 @@
  * @package WordPress
  */
 
-header('Content-Type: ' . feed_content_type('rss-http') . '; charset=' . get_option('blog_charset'), true);
+header('Content-Type: ' . feed_content_type('rss2') . '; charset=' . get_option('blog_charset'), true);
 $more = 1;
 
-echo '<?xml version="1.0" encoding="'.get_option('blog_charset').'"?'.'>'; ?>
+echo '<?xml version="1.0" encoding="'.get_option('blog_charset').'"?'.'>';
 
+/**
+ * Fires between the xml and rss tags in a feed.
+ *
+ * @since 4.0.0
+ *
+ * @param string $context Type of feed. Possible values include 'rss2', 'rss2-comments',
+ *                        'rdf', 'atom', and 'atom-comments'.
+ */
+do_action( 'rss_tag_pre', 'rss2' );
+?>
 <rss version="2.0"
        xmlns:content="http://purl.org/rss/1.0/modules/content/"
        xmlns:wfw="http://wellformedweb.org/CommentAPI/"
@@ -17,7 +27,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>
@@ -26,34 +43,74 @@ echo '<?xml version="1.0" encoding="'.get_option('blog_charset').'"?'.'>'; ?>
        <link><?php bloginfo_rss('url') ?></link>
        <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 echo get_option('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(); ?>
+       <language><?php bloginfo_rss( 'language' ); ?></language>
+       <sy:updatePeriod><?php
+               $duration = 'hourly';
+
+               /**
+                * Filter how often to update the RSS feed.
+                *
+                * @since 2.1.0
+                *
+                * @param string $duration The update period. Accepts 'hourly', 'daily', 'weekly', 'monthly',
+                *                         'yearly'. Default 'hourly'.
+                */
+               echo apply_filters( 'rss_update_period', $duration );
+       ?></sy:updatePeriod>
+       <sy:updateFrequency><?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'.
+                */
+               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>
-               <?php the_category_rss() ?>
+               <dc:creator><![CDATA[<?php the_author() ?>]]></dc:creator>
+               <?php the_category_rss('rss2') ?>
 
                <guid isPermaLink="false"><?php the_guid(); ?></guid>
 <?php if (get_option('rss_use_excerpt')) : ?>
-               <description><![CDATA[<?php the_excerpt_rss() ?>]]></description>
+               <description><![CDATA[<?php the_excerpt_rss(); ?>]]></description>
 <?php else : ?>
-               <description><![CDATA[<?php the_excerpt_rss() ?>]]></description>
-       <?php if ( strlen( $post->post_content ) > 0 ) : ?>
-               <content:encoded><![CDATA[<?php the_content_feed('rss2') ?>]]></content:encoded>
+               <description><![CDATA[<?php the_excerpt_rss(); ?>]]></description>
+       <?php $content = get_the_content_feed('rss2'); ?>
+       <?php if ( strlen( $content ) > 0 ) : ?>
+               <content:encoded><![CDATA[<?php echo $content; ?>]]></content:encoded>
        <?php else : ?>
-               <content:encoded><![CDATA[<?php the_excerpt_rss() ?>]]></content:encoded>
+               <content:encoded><![CDATA[<?php the_excerpt_rss(); ?>]]></content:encoded>
        <?php endif; ?>
 <?php endif; ?>
                <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>