mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-28 16:49:40 +02:00
Add missing `@since` tags for some functions. Correct alignment of some `@param` tags. Follow-up to [46271], [46278], [51304]. See #52628, #53461. Built from https://develop.svn.wordpress.org/trunk@51322 git-svn-id: http://core.svn.wordpress.org/trunk@50931 1a063a9b-81f0-0310-95a4-ce76da25c4cd
153 lines
4.7 KiB
PHP
153 lines
4.7 KiB
PHP
<?php
|
|
/**
|
|
* Custom comment walker for this theme.
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Twenty_Twenty
|
|
* @since Twenty Twenty 1.0
|
|
*/
|
|
|
|
if ( ! class_exists( 'TwentyTwenty_Walker_Comment' ) ) {
|
|
/**
|
|
* CUSTOM COMMENT WALKER
|
|
* A custom walker for comments, based on the walker in Twenty Nineteen.
|
|
*
|
|
* @since Twenty Twenty 1.0
|
|
*/
|
|
class TwentyTwenty_Walker_Comment extends Walker_Comment {
|
|
|
|
/**
|
|
* Outputs a comment in the HTML5 format.
|
|
*
|
|
* @since Twenty Twenty 1.0
|
|
*
|
|
* @see wp_list_comments()
|
|
* @see https://developer.wordpress.org/reference/functions/get_comment_author_url/
|
|
* @see https://developer.wordpress.org/reference/functions/get_comment_author/
|
|
* @see https://developer.wordpress.org/reference/functions/get_avatar/
|
|
* @see https://developer.wordpress.org/reference/functions/get_comment_reply_link/
|
|
* @see https://developer.wordpress.org/reference/functions/get_edit_comment_link/
|
|
*
|
|
* @param WP_Comment $comment Comment to display.
|
|
* @param int $depth Depth of the current comment.
|
|
* @param array $args An array of arguments.
|
|
*/
|
|
protected function html5_comment( $comment, $depth, $args ) {
|
|
|
|
$tag = ( 'div' === $args['style'] ) ? 'div' : 'li';
|
|
|
|
?>
|
|
<<?php echo $tag; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- static output ?> id="comment-<?php comment_ID(); ?>" <?php comment_class( $this->has_children ? 'parent' : '', $comment ); ?>>
|
|
<article id="div-comment-<?php comment_ID(); ?>" class="comment-body">
|
|
<footer class="comment-meta">
|
|
<div class="comment-author vcard">
|
|
<?php
|
|
$comment_author_url = get_comment_author_url( $comment );
|
|
$comment_author = get_comment_author( $comment );
|
|
$avatar = get_avatar( $comment, $args['avatar_size'] );
|
|
if ( 0 !== $args['avatar_size'] ) {
|
|
if ( empty( $comment_author_url ) ) {
|
|
echo wp_kses_post( $avatar );
|
|
} else {
|
|
printf( '<a href="%s" rel="external nofollow" class="url">', $comment_author_url ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped --Escaped in https://developer.wordpress.org/reference/functions/get_comment_author_url/
|
|
echo wp_kses_post( $avatar );
|
|
}
|
|
}
|
|
|
|
printf(
|
|
'<span class="fn">%1$s</span><span class="screen-reader-text says">%2$s</span>',
|
|
esc_html( $comment_author ),
|
|
__( 'says:', 'twentytwenty' )
|
|
);
|
|
|
|
if ( ! empty( $comment_author_url ) ) {
|
|
echo '</a>';
|
|
}
|
|
?>
|
|
</div><!-- .comment-author -->
|
|
|
|
<div class="comment-metadata">
|
|
<?php
|
|
/* translators: 1: Comment date, 2: Comment time. */
|
|
$comment_timestamp = sprintf( __( '%1$s at %2$s', 'twentytwenty' ), get_comment_date( '', $comment ), get_comment_time() );
|
|
|
|
printf(
|
|
'<a href="%s"><time datetime="%s" title="%s">%s</time></a>',
|
|
esc_url( get_comment_link( $comment, $args ) ),
|
|
get_comment_time( 'c' ),
|
|
esc_attr( $comment_timestamp ),
|
|
esc_html( $comment_timestamp )
|
|
);
|
|
|
|
if ( get_edit_comment_link() ) {
|
|
printf(
|
|
' <span aria-hidden="true">•</span> <a class="comment-edit-link" href="%s">%s</a>',
|
|
esc_url( get_edit_comment_link() ),
|
|
__( 'Edit', 'twentytwenty' )
|
|
);
|
|
}
|
|
?>
|
|
</div><!-- .comment-metadata -->
|
|
|
|
</footer><!-- .comment-meta -->
|
|
|
|
<div class="comment-content entry-content">
|
|
|
|
<?php
|
|
|
|
comment_text();
|
|
|
|
if ( '0' === $comment->comment_approved ) {
|
|
?>
|
|
<p class="comment-awaiting-moderation"><?php _e( 'Your comment is awaiting moderation.', 'twentytwenty' ); ?></p>
|
|
<?php
|
|
}
|
|
|
|
?>
|
|
|
|
</div><!-- .comment-content -->
|
|
|
|
<?php
|
|
|
|
$comment_reply_link = get_comment_reply_link(
|
|
array_merge(
|
|
$args,
|
|
array(
|
|
'add_below' => 'div-comment',
|
|
'depth' => $depth,
|
|
'max_depth' => $args['max_depth'],
|
|
'before' => '<span class="comment-reply">',
|
|
'after' => '</span>',
|
|
)
|
|
)
|
|
);
|
|
|
|
$by_post_author = twentytwenty_is_comment_by_post_author( $comment );
|
|
|
|
if ( $comment_reply_link || $by_post_author ) {
|
|
?>
|
|
|
|
<footer class="comment-footer-meta">
|
|
|
|
<?php
|
|
if ( $comment_reply_link ) {
|
|
echo $comment_reply_link; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Link is escaped in https://developer.wordpress.org/reference/functions/get_comment_reply_link/
|
|
}
|
|
if ( $by_post_author ) {
|
|
echo '<span class="by-post-author">' . __( 'By Post Author', 'twentytwenty' ) . '</span>';
|
|
}
|
|
?>
|
|
|
|
</footer>
|
|
|
|
<?php
|
|
}
|
|
?>
|
|
|
|
</article><!-- .comment-body -->
|
|
|
|
<?php
|
|
}
|
|
}
|
|
}
|