_wp_dashboard_recent_comments_row( WP_Comment $comment, bool $show_date = true )

Parameters

$commentWP_Comment

The current comment.

$show_datebooloptional

Whether to display the date.Default: true

Hooks fired · 1

One hook fires while _wp_dashboard_recent_comments_row() runs, in this order:

1. 1
   apply_filters( comment_row_actions )filterline 814 (+103 into the body)

   Filters the action links displayed for each comment in the Comments list table.

Uses · 18

• _draft_or_post_title()Gets the post title.
• get_the_permalink()Retrieves the full permalink for the current post or post ID.
• esc_url()Checks and cleans a URL.
• current_user_can()Returns whether the current user has the specified capability.
• esc_html()Escaping for HTML blocks.
• wp_create_nonce()Creates a cryptographic token tied to a specific action, user, user session, and window of time.
• esc_attr__()Retrieves the translation of $text and escapes it for safe use in an attribute.
• __()Retrieves the translation of $text.
• _x()Retrieves translated string with gettext context.
• get_comment_link()Retrieves the link to a given comment.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• comment_class()Generates semantic classes for each comment element.

Used by · 2

• wp_ajax_replyto_comment()Handles replying to a comment via AJAX.
• wp_dashboard_recent_comments()Show Comments section.

Source

View on Trac ↗View on GitHub ↗

711function _wp_dashboard_recent_comments_row( &$comment, $show_date = true ) {712	$GLOBALS['comment'] = clone $comment;713 714	if ( $comment->comment_post_ID > 0 ) {715		$comment_post_title = _draft_or_post_title( $comment->comment_post_ID );716		$comment_post_url   = get_the_permalink( $comment->comment_post_ID );717		$comment_post_link  = '<a href="' . esc_url( $comment_post_url ) . '">' . $comment_post_title . '</a>';718	} else {719		$comment_post_link = '';720	}721 722	$actions_string = '';723	if ( current_user_can( 'edit_comment', $comment->comment_ID ) ) {724		// Pre-order it: Approve | Reply | Edit | Spam | Trash.725		$actions = array(726			'approve'   => '',727			'unapprove' => '',728			'reply'     => '',729			'edit'      => '',730			'spam'      => '',731			'trash'     => '',732			'delete'    => '',733			'view'      => '',734		);735 736		$approve_nonce = esc_html( '_wpnonce=' . wp_create_nonce( 'approve-comment_' . $comment->comment_ID ) );737		$del_nonce     = esc_html( '_wpnonce=' . wp_create_nonce( 'delete-comment_' . $comment->comment_ID ) );738 739		$action_string = 'comment.php?action=%s&p=' . $comment->comment_post_ID . '&c=' . $comment->comment_ID . '&%s';740 741		$approve_url   = sprintf( $action_string, 'approvecomment', $approve_nonce );742		$unapprove_url = sprintf( $action_string, 'unapprovecomment', $approve_nonce );743		$spam_url      = sprintf( $action_string, 'spamcomment', $del_nonce );744		$trash_url     = sprintf( $action_string, 'trashcomment', $del_nonce );745		$delete_url    = sprintf( $action_string, 'deletecomment', $del_nonce );746 747		$actions['approve'] = sprintf(748			'<a href="%s" data-wp-lists="%s" class="vim-a aria-button-if-js" aria-label="%s">%s</a>',749			esc_url( $approve_url ),750			"dim:the-comment-list:comment-{$comment->comment_ID}:unapproved:e7e7d3:e7e7d3:new=approved",751			esc_attr__( 'Approve this comment' ),752			__( 'Approve' )753		);754 755		$actions['unapprove'] = sprintf(756			'<a href="%s" data-wp-lists="%s" class="vim-u aria-button-if-js" aria-label="%s">%s</a>',757			esc_url( $unapprove_url ),758			"dim:the-comment-list:comment-{$comment->comment_ID}:unapproved:e7e7d3:e7e7d3:new=unapproved",759			esc_attr__( 'Unapprove this comment' ),760			__( 'Unapprove' )761		);762 763		$actions['edit'] = sprintf(764			'<a href="%s" aria-label="%s">%s</a>',765			"comment.php?action=editcomment&amp;c={$comment->comment_ID}",766			esc_attr__( 'Edit this comment' ),767			__( 'Edit' )768		);769 770		$actions['reply'] = sprintf(771			'<button type="button" onclick="window.commentReply && commentReply.open(\'%s\',\'%s\');" class="vim-r button-link hide-if-no-js" aria-label="%s">%s</button>',772			$comment->comment_ID,773			$comment->comment_post_ID,774			esc_attr__( 'Reply to this comment' ),775			/* translators: Comment reply button text. */776			_x( 'Reply', 'verb' )777		);778 779		$actions['spam'] = sprintf(780			'<a href="%s" data-wp-lists="%s" class="vim-s vim-destructive aria-button-if-js" aria-label="%s">%s</a>',781			esc_url( $spam_url ),782			"delete:the-comment-list:comment-{$comment->comment_ID}::spam=1",783			esc_attr__( 'Mark this comment as spam' ),784			/* translators: "Mark as spam" link. */785			_x( 'Spam', 'verb' )786		);787 788		if ( ! EMPTY_TRASH_DAYS ) {789			$actions['delete'] = sprintf(790				'<a href="%s" data-wp-lists="%s" class="delete vim-d vim-destructive aria-button-if-js" aria-label="%s">%s</a>',

History

Introduced in 2.7.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-admin/includes/dashboard.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.