WP_Theme_Install_List_Table::prepare_items()

Hooks fired · 3

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

1. 1
   apply_filters( install_themes_tabs )filterline 72 (+37 into the body)

   Filters the tabs shown on the Add Themes screen.

2. 2
   apply_filters( install_themes_nonmenu_tabs )filterline 82 (+47 into the body)

   Filters tabs not associated with a menu item on the Install Themes screen.

3. 3
   apply_filters( install_themes_table_api_args_{$tab} )filterline 150 (+115 into the body)

   Filters API request arguments for each Install Themes screen tab.

Uses · 11

• sanitize_text_field()Sanitizes a string from user input or from the database.
• wp_unslash()Removes slashes from a string or recursively removes slashes from strings within an array.
• __()Retrieves the translation of $text.
• _x()Retrieves translated string with gettext context.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• add_action()Adds a callback function to an action hook.
• themes_api()Retrieves theme installer pages from the WordPress.org Themes API.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• wp_die()Kills WordPress execution and displays HTML page with an error message.
• WP_Theme_Install_List_Table::get_pagenum()
• WP_Theme_Install_List_Table::set_pagination_args()

Source

View on Trac ↗View on GitHub ↗

35	public function prepare_items() {36		require ABSPATH . 'wp-admin/includes/theme-install.php';37 38		global $tabs, $tab, $paged, $type, $theme_field_defaults;39 40		$tab = ! empty( $_REQUEST['tab'] ) ? sanitize_text_field( $_REQUEST['tab'] ) : '';41 42		$search_terms  = array();43		$search_string = '';44		if ( ! empty( $_REQUEST['s'] ) ) {45			$search_string = strtolower( wp_unslash( $_REQUEST['s'] ) );46			$search_terms  = array_unique( array_filter( array_map( 'trim', explode( ',', $search_string ) ) ) );47		}48 49		if ( ! empty( $_REQUEST['features'] ) ) {50			$this->features = $_REQUEST['features'];51		}52 53		$paged = $this->get_pagenum();54 55		$per_page = 36;56 57		// These are the tabs which are shown on the page,58		$tabs              = array();59		$tabs['dashboard'] = __( 'Search' );60		if ( 'search' === $tab ) {61			$tabs['search'] = __( 'Search Results' );62		}63		$tabs['upload']   = __( 'Upload' );64		$tabs['featured'] = _x( 'Featured', 'themes' );65		//$tabs['popular']  = _x( 'Popular', 'themes' );66		$tabs['new']     = _x( 'Latest', 'themes' );67		$tabs['updated'] = _x( 'Recently Updated', 'themes' );68 69		$nonmenu_tabs = array( 'theme-information' ); // Valid actions to perform which do not have a Menu item.70 71		/** This filter is documented in wp-admin/theme-install.php */72		$tabs = apply_filters( 'install_themes_tabs', $tabs );73 74		/**75		 * Filters tabs not associated with a menu item on the Install Themes screen.76		 *77		 * @since 2.8.078		 *79		 * @param string[] $nonmenu_tabs The tabs that don't have a menu item on80		 *                               the Install Themes screen.81		 */82		$nonmenu_tabs = apply_filters( 'install_themes_nonmenu_tabs', $nonmenu_tabs );83 84		// If a non-valid menu tab has been selected, And it's not a non-menu action.85		if ( empty( $tab ) || ( ! isset( $tabs[ $tab ] ) && ! in_array( $tab, (array) $nonmenu_tabs, true ) ) ) {86			$tab = key( $tabs );87		}88 89		$args = array(90			'page'     => $paged,91			'per_page' => $per_page,92			'fields'   => $theme_field_defaults,93		);94 95		switch ( $tab ) {96			case 'search':97				$type = isset( $_REQUEST['type'] ) ? wp_unslash( $_REQUEST['type'] ) : 'term';98				switch ( $type ) {99					case 'tag':100						$args['tag'] = array_map( 'sanitize_key', $search_terms );101						break;102					case 'term':103						$args['search'] = $search_string;104						break;105					case 'author':106						$args['author'] = $search_string;107						break;108				}109 110				if ( ! empty( $this->features ) ) {111					$args['tag']      = $this->features;112					$_REQUEST['s']    = implode( ',', $this->features );113					$_REQUEST['type'] = 'tag';114				}

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-theme-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.