WP_Comments_List_Table::handle_row_actions( WP_Comment $item, string $column_name, string $primary ): string

Parameters

$itemWP_Comment

The comment object.

$column_namestring

Current column name.

$primarystring

Primary column name.

Return

string

Row actions output for comments. An empty string if the current column is not the primary column, or if the current user cannot edit the comment.

Hooks fired · 1

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

1. 1
   apply_filters( comment_row_actions )filterline 864 (+170 into the body)

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

Uses · 11

• wp_get_comment_status()Retrieves the status of a comment by comment ID.
• 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_url()Checks and cleans a URL.
• 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.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• get_user_setting()Retrieves user interface setting value based on setting name.
• wp_doing_ajax()Determines whether the current request is a WordPress Ajax request.
• get_comment_meta()Retrieves comment meta field for a comment.

Source

View on Trac ↗View on GitHub ↗

694	protected function handle_row_actions( $item, $column_name, $primary ) {695		global $comment_status;696 697		if ( $primary !== $column_name ) {698			return '';699		}700 701		if ( ! $this->user_can ) {702			return '';703		}704 705		// Restores the more descriptive, specific name for use within this method.706		$comment = $item;707 708		$the_comment_status = wp_get_comment_status( $comment );709 710		$output = '';711 712		$approve_nonce = esc_html( '_wpnonce=' . wp_create_nonce( 'approve-comment_' . $comment->comment_ID ) );713		$del_nonce     = esc_html( '_wpnonce=' . wp_create_nonce( 'delete-comment_' . $comment->comment_ID ) );714 715		$action_string = 'comment.php?action=%s&c=' . $comment->comment_ID . '&%s';716 717		$approve_url   = sprintf( $action_string, 'approvecomment', $approve_nonce );718		$unapprove_url = sprintf( $action_string, 'unapprovecomment', $approve_nonce );719		$spam_url      = sprintf( $action_string, 'spamcomment', $del_nonce );720		$unspam_url    = sprintf( $action_string, 'unspamcomment', $del_nonce );721		$trash_url     = sprintf( $action_string, 'trashcomment', $del_nonce );722		$untrash_url   = sprintf( $action_string, 'untrashcomment', $del_nonce );723		$delete_url    = sprintf( $action_string, 'deletecomment', $del_nonce );724 725		// Preorder it: Approve | Reply | Quick Edit | Edit | Spam | Trash.726		$actions = array(727			'approve'   => '',728			'unapprove' => '',729			'reply'     => '',730			'quickedit' => '',731			'edit'      => '',732			'spam'      => '',733			'unspam'    => '',734			'trash'     => '',735			'untrash'   => '',736			'delete'    => '',737		);738 739		// Not looking at all comments.740		if ( $comment_status && 'all' !== $comment_status ) {741			if ( 'approved' === $the_comment_status ) {742				$actions['unapprove'] = sprintf(743					'<a href="%s" data-wp-lists="%s" class="vim-u vim-destructive aria-button-if-js" aria-label="%s">%s</a>',744					esc_url( $unapprove_url ),745					"delete:the-comment-list:comment-{$comment->comment_ID}:e7e7d3:action=dim-comment&amp;new=unapproved",746					esc_attr__( 'Unapprove this comment' ),747					__( 'Unapprove' )748				);749			} elseif ( 'unapproved' === $the_comment_status ) {750				$actions['approve'] = sprintf(751					'<a href="%s" data-wp-lists="%s" class="vim-a vim-destructive aria-button-if-js" aria-label="%s">%s</a>',752					esc_url( $approve_url ),753					"delete:the-comment-list:comment-{$comment->comment_ID}:e7e7d3:action=dim-comment&amp;new=approved",754					esc_attr__( 'Approve this comment' ),755					__( 'Approve' )756				);757			}758		} else {759			$actions['approve'] = sprintf(760				'<a href="%s" data-wp-lists="%s" class="vim-a aria-button-if-js" aria-label="%s">%s</a>',761				esc_url( $approve_url ),762				"dim:the-comment-list:comment-{$comment->comment_ID}:unapproved:e7e7d3:e7e7d3:new=approved",763				esc_attr__( 'Approve this comment' ),764				__( 'Approve' )765			);766 767			$actions['unapprove'] = sprintf(768				'<a href="%s" data-wp-lists="%s" class="vim-u aria-button-if-js" aria-label="%s">%s</a>',769				esc_url( $unapprove_url ),770				"dim:the-comment-list:comment-{$comment->comment_ID}:unapproved:e7e7d3:e7e7d3:new=unapproved",771				esc_attr__( 'Unapprove this comment' ),772				__( 'Unapprove' )773			);

History

Introduced in 4.3.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 6.8.8 tag, from src/wp-admin/includes/class-wp-comments-list-table.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.