WP_Terms_List_Table::handle_row_actions( WP_Term $item, string $column_name, string $primary ): string

Parameters

$itemWP_Term

Tag being acted upon.

$column_namestring

Current column name.

$primarystring

Primary column name.

Return

string

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

Hooks fired · 3

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

1. 1
   apply_filters( quick_edit_enabled_for_taxonomy )filterline 503 (+36 into the body)

   Filters whether Quick Edit should be enabled for the given taxonomy.

2. 2
   apply_filters( tag_row_actions )filterline 546 (+79 into the body)

   Filters the action links displayed for each term in the Tags list table.

3. 3
   apply_filters( {$taxonomy}_row_actions )filterline 564 (+97 into the body)

   Filters the action links displayed for each term in the terms list table.

Uses · 14

• wp_doing_ajax()Determines whether the current request is a WordPress Ajax request.
• wp_get_referer()Retrieves referer from '_wp_http_referer' or HTTP referer.
• current_user_can()Returns whether the current user has the specified capability.
• 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_term_link()Retrieves the URL for editing a given term.
• 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.
• is_term_publicly_viewable()Determines whether a term is publicly viewable.

Source

View on Trac ↗View on GitHub ↗

467	protected function handle_row_actions( $item, $column_name, $primary ) {468		if ( $primary !== $column_name ) {469			return '';470		}471 472		// Restores the more descriptive, specific name for use within this method.473		$tag = $item;474 475		$taxonomy = $this->screen->taxonomy;476		$uri      = wp_doing_ajax() ? wp_get_referer() : $_SERVER['REQUEST_URI'];477 478		$actions = array();479 480		if ( current_user_can( 'edit_term', $tag->term_id ) ) {481			$actions['edit'] = sprintf(482				'<a href="%s" aria-label="%s">%s</a>',483				esc_url(484					add_query_arg(485						'wp_http_referer',486						urlencode( wp_unslash( $uri ) ),487						get_edit_term_link( $tag, $taxonomy, $this->screen->post_type )488					)489				),490				/* translators: %s: Taxonomy term name. */491				esc_attr( sprintf( __( 'Edit &#8220;%s&#8221;' ), $tag->name ) ),492				__( 'Edit' )493			);494 495			/**496			 * Filters whether Quick Edit should be enabled for the given taxonomy.497			 *498			 * @since 6.4.0499			 *500			 * @param bool   $enable   Whether to enable the Quick Edit functionality. Default true.501			 * @param string $taxonomy Taxonomy name.502			 */503			$quick_edit_enabled = apply_filters( 'quick_edit_enabled_for_taxonomy', true, $taxonomy );504 505			if ( $quick_edit_enabled ) {506				$actions['inline hide-if-no-js'] = sprintf(507					'<button type="button" class="button-link editinline" aria-label="%s" aria-expanded="false">%s</button>',508					/* translators: %s: Taxonomy term name. */509					esc_attr( sprintf( __( 'Quick edit &#8220;%s&#8221; inline' ), $tag->name ) ),510					__( 'Quick&nbsp;Edit' )511				);512			}513		}514 515		if ( current_user_can( 'delete_term', $tag->term_id ) ) {516			$actions['delete'] = sprintf(517				'<a href="%s" class="delete-tag aria-button-if-js" aria-label="%s">%s</a>',518				wp_nonce_url( "edit-tags.php?action=delete&amp;taxonomy=$taxonomy&amp;tag_ID=$tag->term_id", 'delete-tag_' . $tag->term_id ),519				/* translators: %s: Taxonomy term name. */520				esc_attr( sprintf( __( 'Delete &#8220;%s&#8221;' ), $tag->name ) ),521				__( 'Delete' )522			);523		}524 525		if ( is_term_publicly_viewable( $tag ) ) {526			$actions['view'] = sprintf(527				'<a href="%s" aria-label="%s">%s</a>',528				get_term_link( $tag ),529				/* translators: %s: Taxonomy term name. */530				esc_attr( sprintf( __( 'View &#8220;%s&#8221; archive' ), $tag->name ) ),531				__( 'View' )532			);533		}534 535		/**536		 * Filters the action links displayed for each term in the Tags list table.537		 *538		 * @since 2.8.0539		 * @since 3.0.0 Deprecated in favor of {@see '{$taxonomy}_row_actions'} filter.540		 * @since 5.4.2 Restored (un-deprecated).541		 *542		 * @param string[] $actions An array of action links to be displayed. Default543		 *                          'Edit', 'Quick Edit', 'Delete', and 'View'.544		 * @param WP_Term  $tag     Term object.545		 */546		$actions = apply_filters( 'tag_row_actions', $actions, $tag );

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