WP_Plugin_Install_List_Table::prepare_items()

Hooks fired · 3

3 hooks fire while WP_Plugin_Install_List_Table::prepare_items() runs, in this order:

1. 1
   apply_filters( install_plugins_tabs )filterline 135 (+45 into the body)

   Filters the tabs shown on the Add Plugins screen.

2. 2
   apply_filters( install_plugins_nonmenu_tabs )filterline 144 (+54 into the body)

   Filters tabs not associated with a menu item on the Add Plugins screen.

3. 3
   apply_filters( install_plugins_table_api_args_{$tab} )filterline 236 (+146 into the body)

   Filters API request arguments for each Add Plugins screen tab.

Uses · 24

• sanitize_text_field()Sanitizes a string from user input or from the database.
• __()Retrieves the translation of $text.
• str_contains()Polyfill for `str_contains()` function added in PHP 8.0.
• get_bloginfo()Retrieves information about the current site.
• _x()Retrieves translated string with gettext context.
• current_user_can()Returns whether the current user has the specified capability.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• get_user_locale()Retrieves the locale of a user.
• wp_unslash()Removes slashes from a string or recursively removes slashes from strings within an array.
• sanitize_title_with_dashes()Sanitizes a title, replacing whitespace and a few other characters with dashes.
• get_current_user_id()Gets the current user's ID.
• wp_verify_nonce()Verifies that a correct security nonce was used with time limit.

Source

View on Trac ↗View on GitHub ↗

90	public function prepare_items() {91		require_once ABSPATH . 'wp-admin/includes/plugin-install.php';92 93		global $tabs, $tab, $paged, $type, $term;94 95		$tab = ! empty( $_REQUEST['tab'] ) ? sanitize_text_field( $_REQUEST['tab'] ) : '';96 97		$paged = $this->get_pagenum();98 99		$per_page = 36;100 101		// These are the tabs which are shown on the page.102		$tabs = array();103 104		if ( 'search' === $tab ) {105			$tabs['search'] = __( 'Search Results' );106		}107 108		if ( 'beta' === $tab || str_contains( get_bloginfo( 'version' ), '-' ) ) {109			$tabs['beta'] = _x( 'Beta Testing', 'Plugin Installer' );110		}111 112		$tabs['featured']    = _x( 'Featured', 'Plugin Installer' );113		$tabs['popular']     = _x( 'Popular', 'Plugin Installer' );114		$tabs['recommended'] = _x( 'Recommended', 'Plugin Installer' );115		$tabs['favorites']   = _x( 'Favorites', 'Plugin Installer' );116 117		if ( current_user_can( 'upload_plugins' ) ) {118			/*119			 * No longer a real tab. Here for filter compatibility.120			 * Gets skipped in get_views().121			 */122			$tabs['upload'] = __( 'Upload Plugin' );123		}124 125		$nonmenu_tabs = array( 'plugin-information' ); // Valid actions to perform which do not have a Menu item.126 127		/**128		 * Filters the tabs shown on the Add Plugins screen.129		 *130		 * @since 2.7.0131		 *132		 * @param string[] $tabs The tabs shown on the Add Plugins screen. Defaults include133		 *                       'featured', 'popular', 'recommended', 'favorites', and 'upload'.134		 */135		$tabs = apply_filters( 'install_plugins_tabs', $tabs );136 137		/**138		 * Filters tabs not associated with a menu item on the Add Plugins screen.139		 *140		 * @since 2.7.0141		 *142		 * @param string[] $nonmenu_tabs The tabs that don't have a menu item on the Add Plugins screen.143		 */144		$nonmenu_tabs = apply_filters( 'install_plugins_nonmenu_tabs', $nonmenu_tabs );145 146		// If a non-valid menu tab has been selected, And it's not a non-menu action.147		if ( empty( $tab ) || ( ! isset( $tabs[ $tab ] ) && ! in_array( $tab, (array) $nonmenu_tabs, true ) ) ) {148			$tab = key( $tabs );149		}150 151		$installed_plugins = $this->get_installed_plugins();152 153		$args = array(154			'page'     => $paged,155			'per_page' => $per_page,156			// Send the locale to the API so it can provide context-sensitive results.157			'locale'   => get_user_locale(),158		);159 160		switch ( $tab ) {161			case 'search':162				$type = isset( $_REQUEST['type'] ) ? wp_unslash( $_REQUEST['type'] ) : 'term';163				$term = isset( $_REQUEST['s'] ) ? wp_unslash( $_REQUEST['s'] ) : '';164 165				switch ( $type ) {166					case 'tag':167						$args['tag'] = sanitize_title_with_dashes( $term );168						break;169					case 'term':

History

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-plugin-install-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.