WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

WP_MS_Users_List_Table::handle_row_actions()

WP_MS_Users_List_Table::handle_row_actions( WP_User $item, string $column_name, string $primary ): string

In this article

Back to top

Generates and displays row action links.

Parameters

$itemWP_Userrequired
User being acted upon.
$column_namestringrequired
Current column name.
$primarystringrequired
Primary column name.

Return

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

Source

protected function handle_row_actions( $item, $column_name, $primary ) {
	if ( $primary !== $column_name ) {
		return '';
	}

	// Restores the more descriptive, specific name for use within this method.
	$user = $item;

	$super_admins = get_super_admins();
	$actions      = array();

	if ( current_user_can( 'edit_user', $user->ID ) ) {
		$edit_link       = esc_url( add_query_arg( 'wp_http_referer', urlencode( wp_unslash( $_SERVER['REQUEST_URI'] ) ), get_edit_user_link( $user->ID ) ) );
		$actions['edit'] = '<a href="' . $edit_link . '">' . __( 'Edit' ) . '</a>';
	}

	if ( current_user_can( 'delete_user', $user->ID ) && ! in_array( $user->user_login, $super_admins, true ) ) {
		$actions['delete'] = '<a href="' . esc_url( network_admin_url( add_query_arg( '_wp_http_referer', urlencode( wp_unslash( $_SERVER['REQUEST_URI'] ) ), wp_nonce_url( 'users.php', 'deleteuser' ) . '&amp;action=deleteuser&amp;id=' . $user->ID ) ) ) . '" class="delete">' . __( 'Delete' ) . '</a>';
	}

	/**
	 * Filters the action links displayed under each user in the Network Admin Users list table.
	 *
	 * @since 3.2.0
	 *
	 * @param string[] $actions An array of action links to be displayed. Default 'Edit', 'Delete'.
	 * @param WP_User  $user    WP_User object.
	 */
	$actions = apply_filters( 'ms_user_row_actions', $actions, $user );

	return $this->row_actions( $actions );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘ms_user_row_actions’, string[] $actions, WP_User $user )

Filters the action links displayed under each user in the Network Admin Users list table.

UsesDescription
get_super_admins()wp-includes/capabilities.php

Retrieves a list of super admins.

network_admin_url()wp-includes/link-template.php

Retrieves the URL to the admin area for the network.

get_edit_user_link()wp-includes/link-template.php

Retrieves the edit user link.

current_user_can()wp-includes/capabilities.php

Returns whether the current user has the specified capability.

__()wp-includes/l10n.php

Retrieves the translation of $text.

wp_unslash()wp-includes/formatting.php

Removes slashes from a string or recursively removes slashes from strings within an array.

esc_url()wp-includes/formatting.php

Checks and cleans a URL.

wp_nonce_url()wp-includes/functions.php

Retrieves URL with nonce added to URL query.

add_query_arg()wp-includes/functions.php

Retrieves a modified URL query string.

apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.

Show 7 moreShow less
Used byDescription
WP_MS_Users_List_Table::_column_blogs()wp-admin/includes/class-wp-ms-users-list-table.php

Changelog

VersionDescription
5.9.0Renamed $user to $item to match parent class for PHP 8 named parameter support.
4.3.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.