Docs: Improve inline comments per the documentation standards.

Includes minor code layout fixes for better readability.

See #48303.
Built from https://develop.svn.wordpress.org/trunk@47122


git-svn-id: http://core.svn.wordpress.org/trunk@46922 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov
2020-01-29 00:45:18 +00:00
parent e336b24edd
commit 001ffe81fb
497 changed files with 6841 additions and 5486 deletions

View File

@@ -70,53 +70,52 @@ do_action( 'rss_tag_pre', 'rss2-comments' );
*/
do_action( 'commentsrss2_head' );
if ( have_comments() ) :
while ( have_comments() ) :
the_comment();
$comment_post = get_post( $comment->comment_post_ID );
$GLOBALS['post'] = $comment_post;
?>
<item>
<title>
<?php
if ( ! is_singular() ) {
$title = get_the_title( $comment_post->ID );
/** This filter is documented in wp-includes/feed.php */
$title = apply_filters( 'the_title_rss', $title );
/* translators: Individual comment title. 1: Post title, 2: Comment author name. */
printf( ent2ncr( __( 'Comment on %1$s by %2$s' ) ), $title, get_comment_author_rss() );
} else {
/* translators: Comment author title. %s: Comment author name. */
printf( ent2ncr( __( 'By: %s' ) ), get_comment_author_rss() );
}
?>
</title>
<link><?php comment_link(); ?></link>
while ( have_comments() ) :
the_comment();
$comment_post = get_post( $comment->comment_post_ID );
$GLOBALS['post'] = $comment_post;
?>
<item>
<title>
<?php
if ( ! is_singular() ) {
$title = get_the_title( $comment_post->ID );
/** This filter is documented in wp-includes/feed.php */
$title = apply_filters( 'the_title_rss', $title );
/* translators: Individual comment title. 1: Post title, 2: Comment author name. */
printf( ent2ncr( __( 'Comment on %1$s by %2$s' ) ), $title, get_comment_author_rss() );
} else {
/* translators: Comment author title. %s: Comment author name. */
printf( ent2ncr( __( 'By: %s' ) ), get_comment_author_rss() );
}
?>
</title>
<link><?php comment_link(); ?></link>
<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 ) ) : ?>
<description><?php echo ent2ncr( __( 'Protected Comments: Please enter your password to view comments.' ) ); ?></description>
<content:encoded><![CDATA[<?php echo get_the_password_form(); ?>]]></content:encoded>
<?php else : // post pass ?>
<description><![CDATA[<?php comment_text_rss(); ?>]]></description>
<content:encoded><![CDATA[<?php comment_text(); ?>]]></content:encoded>
<?php
endif; // post pass
/**
* 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 );
<?php if ( post_password_required( $comment_post ) ) : ?>
<description><?php echo ent2ncr( __( 'Protected Comments: Please enter your password to view comments.' ) ); ?></description>
<content:encoded><![CDATA[<?php echo get_the_password_form(); ?>]]></content:encoded>
<?php else : ?>
<description><![CDATA[<?php comment_text_rss(); ?>]]></description>
<content:encoded><![CDATA[<?php comment_text(); ?>]]></content:encoded>
<?php endif; // End if post_password_required(). ?>
<?php
/**
* 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;
?>
</item>
<?php endwhile; ?>
</channel>
</rss>