WP_MS_Sites_List_Table::handle_row_actions( array $item, string $column_name, string $primary ): string

Parameters

$itemarray

Site being acted upon.

$column_namestring

Current column name.

$primarystring

Primary column name.

Return

string

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

Hooks fired · 1

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

1. 1
   apply_filters( manage_sites_action_links )filterline 859 (+144 into the body)

   Filters the action links displayed for each site in the Sites list table.

Uses · 12

• untrailingslashit()Removes trailing forward slashes and backslashes if they exist.
• esc_url()Checks and cleans a URL.
• network_admin_url()Retrieves the URL to the admin area for the network.
• __()Retrieves the translation of $text.
• get_admin_url()Retrieves the URL to the admin area for a given site.
• is_main_site()Determines whether a site is the main site of the current network.
• wp_nonce_url()Retrieves URL with nonce added to URL query.
• _x()Retrieves translated string with gettext context.
• current_user_can()Returns whether the current user has the specified capability.
• get_home_url()Retrieves the URL for a given site where the front end is accessible.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• WP_MS_Sites_List_Table::row_actions()

Source

View on Trac ↗View on GitHub ↗

715	protected function handle_row_actions( $item, $column_name, $primary ) {716		if ( $primary !== $column_name ) {717			return '';718		}719 720		// Restores the more descriptive, specific name for use within this method.721		$blog = $item;722 723		$blogname = untrailingslashit( $blog['domain'] . $blog['path'] );724 725		// Preordered.726		$actions = array(727			'edit'       => '',728			'backend'    => '',729			'activate'   => '',730			'deactivate' => '',731			'archive'    => '',732			'unarchive'  => '',733			'spam'       => '',734			'unspam'     => '',735			'delete'     => '',736			'visit'      => '',737		);738 739		$actions['edit'] = sprintf(740			'<a href="%1$s">%2$s</a>',741			esc_url( network_admin_url( 'site-info.php?id=' . $blog['blog_id'] ) ),742			__( 'Edit' )743		);744 745		$actions['backend'] = sprintf(746			'<a href="%1$s" class="edit">%2$s</a>',747			esc_url( get_admin_url( $blog['blog_id'] ) ),748			__( 'Dashboard' )749		);750 751		if ( ! is_main_site( $blog['blog_id'] ) ) {752			if ( '1' === $blog['deleted'] ) {753				$actions['activate'] = sprintf(754					'<a href="%1$s">%2$s</a>',755					esc_url(756						wp_nonce_url(757							network_admin_url( 'sites.php?action=confirm&amp;action2=activateblog&amp;id=' . $blog['blog_id'] ),758							'activateblog_' . $blog['blog_id']759						)760					),761					_x( 'Activate', 'site' )762				);763			} else {764				$actions['deactivate'] = sprintf(765					'<a href="%1$s">%2$s</a>',766					esc_url(767						wp_nonce_url(768							network_admin_url( 'sites.php?action=confirm&amp;action2=deactivateblog&amp;id=' . $blog['blog_id'] ),769							'deactivateblog_' . $blog['blog_id']770						)771					),772					__( 'Deactivate' )773				);774			}775 776			if ( '1' === $blog['archived'] ) {777				$actions['unarchive'] = sprintf(778					'<a href="%1$s">%2$s</a>',779					esc_url(780						wp_nonce_url(781							network_admin_url( 'sites.php?action=confirm&amp;action2=unarchiveblog&amp;id=' . $blog['blog_id'] ),782							'unarchiveblog_' . $blog['blog_id']783						)784					),785					__( 'Unarchive' )786				);787			} else {788				$actions['archive'] = sprintf(789					'<a href="%1$s">%2$s</a>',790					esc_url(791						wp_nonce_url(792							network_admin_url( 'sites.php?action=confirm&amp;action2=archiveblog&amp;id=' . $blog['blog_id'] ),793							'archiveblog_' . $blog['blog_id']794						)

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-ms-sites-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.