WP_Posts_List_Table::handle_row_actions( WP_Post $item, string $column_name, string $primary ): string

Parameters

$itemWP_Post

Post being acted upon.

$column_namestring

Current column name.

$primarystring

Primary column name.

Return

string

Row actions output for posts, or an empty string if the current column is not the primary column.

Hooks fired · 3

3 hooks fire while WP_Posts_List_Table::handle_row_actions() runs, in this order:

1. 1
   apply_filters( quick_edit_enabled_for_post_type )filterline 1496 (+30 into the body)

   Filters whether Quick Edit should be enabled for the given post type.

2. 2
   apply_filters( page_row_actions )filterline 1585 (+119 into the body)

   Filters the array of row action links on the Pages list table.

3. 3
   apply_filters( post_row_actions )filterline 1600 (+134 into the body)

   Filters the array of row action links on the Posts list table.

Uses · 17

• get_post_type_object()Retrieves a post type object by name.
• current_user_can()Returns whether the current user has the specified capability.
• _draft_or_post_title()Gets the post title.
• get_edit_post_link()Retrieves the edit post link for post.
• esc_attr()Escaping for HTML attributes.
• __()Retrieves the translation of $text.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• wp_nonce_url()Retrieves URL with nonce added to URL query.
• admin_url()Retrieves the URL to the admin area for the current site.
• get_delete_post_link()Retrieves the delete posts link for post.
• _x()Retrieves translated string with gettext context.
• is_post_type_viewable()Determines whether a post type is considered "viewable".

Used by · 1

• WP_Posts_List_Table::_column_title()

Source

View on Trac ↗View on GitHub ↗

1466	protected function handle_row_actions( $item, $column_name, $primary ) {1467		if ( $primary !== $column_name ) {1468			return '';1469		}1470 1471		// Restores the more descriptive, specific name for use within this method.1472		$post = $item;1473 1474		$post_type_object = get_post_type_object( $post->post_type );1475		$can_edit_post    = current_user_can( 'edit_post', $post->ID );1476		$actions          = array();1477		$title            = _draft_or_post_title();1478 1479		if ( $can_edit_post && 'trash' !== $post->post_status ) {1480			$actions['edit'] = sprintf(1481				'<a href="%s" aria-label="%s">%s</a>',1482				get_edit_post_link( $post->ID ),1483				/* translators: %s: Post title. */1484				esc_attr( sprintf( __( 'Edit &#8220;%s&#8221;' ), $title ) ),1485				__( 'Edit' )1486			);1487 1488			/**1489			 * Filters whether Quick Edit should be enabled for the given post type.1490			 *1491			 * @since 6.4.01492			 *1493			 * @param bool   $enable    Whether to enable the Quick Edit functionality. Default true.1494			 * @param string $post_type Post type name.1495			 */1496			$quick_edit_enabled = apply_filters( 'quick_edit_enabled_for_post_type', true, $post->post_type );1497 1498			if ( $quick_edit_enabled && 'wp_block' !== $post->post_type ) {1499				$actions['inline hide-if-no-js'] = sprintf(1500					'<button type="button" class="button-link editinline" aria-label="%s" aria-expanded="false">%s</button>',1501					/* translators: %s: Post title. */1502					esc_attr( sprintf( __( 'Quick edit &#8220;%s&#8221; inline' ), $title ) ),1503					__( 'Quick&nbsp;Edit' )1504				);1505			}1506		}1507 1508		if ( current_user_can( 'delete_post', $post->ID ) ) {1509			if ( 'trash' === $post->post_status ) {1510				$actions['untrash'] = sprintf(1511					'<a href="%s" aria-label="%s">%s</a>',1512					wp_nonce_url( admin_url( sprintf( $post_type_object->_edit_link . '&amp;action=untrash', $post->ID ) ), 'untrash-post_' . $post->ID ),1513					/* translators: %s: Post title. */1514					esc_attr( sprintf( __( 'Restore &#8220;%s&#8221; from the Trash' ), $title ) ),1515					__( 'Restore' )1516				);1517			} elseif ( EMPTY_TRASH_DAYS ) {1518				$actions['trash'] = sprintf(1519					'<a href="%s" class="submitdelete" aria-label="%s">%s</a>',1520					get_delete_post_link( $post->ID ),1521					/* translators: %s: Post title. */1522					esc_attr( sprintf( __( 'Move &#8220;%s&#8221; to the Trash' ), $title ) ),1523					_x( 'Trash', 'verb' )1524				);1525			}1526 1527			if ( 'trash' === $post->post_status || ! EMPTY_TRASH_DAYS ) {1528				$actions['delete'] = sprintf(1529					'<a href="%s" class="submitdelete" aria-label="%s">%s</a>',1530					get_delete_post_link( $post->ID, '', true ),1531					/* translators: %s: Post title. */1532					esc_attr( sprintf( __( 'Delete &#8220;%s&#8221; permanently' ), $title ) ),1533					__( 'Delete Permanently' )1534				);1535			}1536		}1537 1538		if ( is_post_type_viewable( $post_type_object ) ) {1539			if ( in_array( $post->post_status, array( 'pending', 'draft', 'future' ), true ) ) {1540				if ( $can_edit_post ) {1541					$preview_link    = get_preview_post_link( $post );1542					$actions['view'] = sprintf(1543						'<a href="%s" rel="bookmark" aria-label="%s">%s</a>',1544						esc_url( $preview_link ),1545						/* translators: %s: Post title. */

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.7.7 tag, from src/wp-admin/includes/class-wp-posts-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.