WP_Users_List_Table::single_row( WP_User $user_object, string $style = '', string $role = '', int $numposts = 0 ): string

Parameters

$user_objectWP_User

The current user object.

$stylestringoptional

Deprecated. Not used.Default: ''

$rolestringoptional

Deprecated. Not used.Default: ''

$numpostsintoptional

Post count to display for this user. Defaults to zero, as in, a new user has made zero posts.Default: 0

Return

string

Output for a single row.

Hooks fired · 2

2 hooks fire while WP_Users_List_Table::single_row() runs, in this order:

1. 1
   apply_filters( user_row_actions )filterline 520 (+87 into the body)

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

2. 2
   apply_filters( manage_users_custom_column )filterline 632 (+199 into the body)

   Filters the display output of custom columns in the Users list table.

Uses · 24

• get_userdata()Retrieves user info by user ID.
• is_multisite()Determines whether Multisite is enabled.
• current_user_can()Returns whether the current user has the specified capability.
• get_super_admins()Retrieves a list of super admins.
• __()Retrieves the translation of $text.
• esc_url()Checks and cleans a URL.
• add_query_arg()Retrieves a modified URL query string.
• wp_unslash()Removes slashes from a string or recursively removes slashes from strings within an array.
• get_edit_user_link()Retrieves the edit user link.
• get_current_user_id()Gets the current user's ID.
• wp_nonce_url()Retrieves URL with nonce added to URL query.
• get_author_posts_url()Retrieves the URL to the author page for the user with the ID provided.

Used by · 1

• WP_Users_List_Table::display_rows()Generates the list table rows.

Source

View on Trac ↗View on GitHub ↗

433	public function single_row( $user_object, $style = '', $role = '', $numposts = 0 ) {434		if ( ! ( $user_object instanceof WP_User ) ) {435			$user_object = get_userdata( (int) $user_object );436		}437		$user_object->filter = 'display';438		$email               = $user_object->user_email;439 440		if ( $this->is_site_users ) {441			$url = "site-users.php?id={$this->site_id}&amp;";442		} else {443			$url = 'users.php?';444		}445 446		$user_roles = $this->get_role_list( $user_object );447 448		// Set up the hover actions for this user.449		$actions     = array();450		$checkbox    = '';451		$super_admin = '';452 453		if ( is_multisite() && current_user_can( 'manage_network_users' ) ) {454			if ( in_array( $user_object->user_login, get_super_admins(), true ) ) {455				$super_admin = ' &mdash; ' . __( 'Super Admin' );456			}457		}458 459		// Check if the user for this row is editable.460		if ( current_user_can( 'list_users' ) ) {461			// Set up the user editing link.462			$edit_link = esc_url(463				add_query_arg(464					'wp_http_referer',465					urlencode( wp_unslash( $_SERVER['REQUEST_URI'] ) ),466					get_edit_user_link( $user_object->ID )467				)468			);469 470			if ( current_user_can( 'edit_user', $user_object->ID ) ) {471				$edit            = "<strong><a href=\"{$edit_link}\">{$user_object->user_login}</a>{$super_admin}</strong><br />";472				$actions['edit'] = '<a href="' . $edit_link . '">' . __( 'Edit' ) . '</a>';473			} else {474				$edit = "<strong>{$user_object->user_login}{$super_admin}</strong><br />";475			}476 477			if ( ! is_multisite()478				&& get_current_user_id() !== $user_object->ID479				&& current_user_can( 'delete_user', $user_object->ID )480			) {481				$actions['delete'] = "<a class='submitdelete' href='" . wp_nonce_url( "users.php?action=delete&amp;user=$user_object->ID", 'bulk-users' ) . "'>" . __( 'Delete' ) . '</a>';482			}483 484			if ( is_multisite()485				&& current_user_can( 'remove_user', $user_object->ID )486			) {487				$actions['remove'] = "<a class='submitdelete' href='" . wp_nonce_url( $url . "action=remove&amp;user=$user_object->ID", 'bulk-users' ) . "'>" . __( 'Remove' ) . '</a>';488			}489 490			// Add a link to the user's author archive, if not empty.491			$author_posts_url = get_author_posts_url( $user_object->ID );492			if ( $author_posts_url ) {493				$actions['view'] = sprintf(494					'<a href="%s" aria-label="%s">%s</a>',495					esc_url( $author_posts_url ),496					/* translators: %s: Author's display name. */497					esc_attr( sprintf( __( 'View posts by %s' ), $user_object->display_name ) ),498					__( 'View' )499				);500			}501 502			// Add a link to send the user a reset password link by email.503			if ( get_current_user_id() !== $user_object->ID504				&& current_user_can( 'edit_user', $user_object->ID )505				&& true === wp_is_password_reset_allowed_for_user( $user_object )506			) {507				$actions['resetpassword'] = "<a class='resetpassword' href='" . wp_nonce_url( "users.php?action=resetpassword&amp;users=$user_object->ID", 'bulk-users' ) . "'>" . __( 'Send password reset' ) . '</a>';508			}509 510			/**511			 * Filters the action links displayed under each user in the Users list table.512			 *

History

Introduced in 3.1.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.1.0 tag, from src/wp-admin/includes/class-wp-users-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.