X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/6c8f14c09105d0afa4c1574215c59b5021040e76..46588ee871246a923d972538dbc93b26f4fda932:/wp-includes/feed-rss2-comments.php

diff --git a/wp-includes/feed-rss2-comments.php b/wp-includes/feed-rss2-comments.php
index a6a91016..703fa87c 100644
--- a/wp-includes/feed-rss2-comments.php
+++ b/wp-includes/feed-rss2-comments.php
@@ -8,14 +8,29 @@
 header('Content-Type: ' . feed_content_type('rss-http') . '; charset=' . get_option('blog_charset'), true);
 
 echo '<?xml version="1.0" encoding="'.get_option('blog_charset').'"?'.'>';
+
+/** This action is documented in wp-includes/feed-rss2.php */
+do_action( 'rss_tag_pre', 'rss2-comments' );
 ?>
 <rss version="2.0"
 	xmlns:content="http://purl.org/rss/1.0/modules/content/"
 	xmlns:dc="http://purl.org/dc/elements/1.1/"
 	xmlns:atom="http://www.w3.org/2005/Atom"
 	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
-	<?php do_action('rss2_ns'); do_action('rss2_comments_ns'); ?>
-	>
+	<?php
+	/** This action is documented in wp-includes/feed-rss2.php */
+	do_action( 'rss2_ns' );
+	?>
+
+	<?php
+	/**
+	 * Fires at the end of the RSS root to add namespaces.
+	 *
+	 * @since 2.8.0
+	 */
+	do_action( 'rss2_comments_ns' );
+	?>
+>
 <channel>
 	<title><?php
 		if ( is_singular() )
@@ -29,25 +44,38 @@ echo '<?xml version="1.0" encoding="'.get_option('blog_charset').'"?'.'>';
 	<link><?php (is_single()) ? the_permalink_rss() : bloginfo_rss("url") ?></link>
 	<description><?php bloginfo_rss("description") ?></description>
 	<lastBuildDate><?php echo mysql2date('r', get_lastcommentmodified('GMT')); ?></lastBuildDate>
-	<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('commentsrss2_head'); ?>
-<?php
-if ( have_comments() ) : while ( have_comments() ) : the_comment();
-	$comment_post = $GLOBALS['post'] = get_post( $comment->comment_post_ID );
-?>
+	<sy:updatePeriod><?php
+		/** This filter is documented in wp-includes/feed-rss2.php */
+		echo apply_filters( 'rss_update_period', 'hourly' );
+	?></sy:updatePeriod>
+	<sy:updateFrequency><?php
+		/** This filter is documented in wp-includes/feed-rss2.php */
+		echo apply_filters( 'rss_update_frequency', '1' );
+	?></sy:updateFrequency>
+	<?php
+	/**
+	 * Fires at the end of the RSS2 comment feed header.
+	 *
+	 * @since 2.3.0
+	 */
+	do_action( 'commentsrss2_head' );
+
+	if ( have_comments() ) : while ( have_comments() ) : the_comment();
+		$comment_post = $GLOBALS['post'] = get_post( $comment->comment_post_ID );
+	?>
 	<item>
 		<title><?php
 			if ( !is_singular() ) {
 				$title = get_the_title($comment_post->ID);
-				$title = apply_filters('the_title_rss', $title);
+				/** This filter is documented in wp-includes/feed.php */
+				$title = apply_filters( 'the_title_rss', $title );
 				printf(ent2ncr(__('Comment on %1$s by %2$s')), $title, get_comment_author_rss());
 			} else {
 				printf(ent2ncr(__('By: %s')), get_comment_author_rss());
 			}
 		?></title>
 		<link><?php comment_link() ?></link>
-		<dc:creator><?php echo get_comment_author_rss() ?></dc:creator>
+		<dc:creator><![CDATA[<?php echo get_comment_author_rss() ?>]]></dc:creator>
 		<pubDate><?php echo mysql2date('D, d M Y H:i:s +0000', get_comment_time('Y-m-d H:i:s', true, false), false); ?></pubDate>
 		<guid isPermaLink="false"><?php comment_guid() ?></guid>
 <?php if ( post_password_required($comment_post) ) : ?>
@@ -57,7 +85,15 @@ if ( have_comments() ) : while ( have_comments() ) : the_comment();
 		<description><![CDATA[<?php comment_text_rss() ?>]]></description>
 		<content:encoded><![CDATA[<?php comment_text() ?>]]></content:encoded>
 <?php endif; // post pass
-	do_action('commentrss2_item', $comment->comment_ID, $comment_post->ID);
+	/**
+	 * Fires at the end of each RSS2 comment feed item.
+	 *
+	 * @since 2.1.0
+	 *
+	 * @param int $comment->comment_ID The ID of the comment being displayed.
+	 * @param int $comment_post->ID    The ID of the post the comment is connected to.
+	 */
+	do_action( 'commentrss2_item', $comment->comment_ID, $comment_post->ID );
 ?>
 	</item>
 <?php endwhile; endif; ?>