WP_MS_Themes_List_Table::prepare_items()

Hooks fired · 1

One hook fires while WP_MS_Themes_List_Table::prepare_items() runs, in this order:

1. 1
   apply_filters( all_themes )filterline 115 (+16 into the body)

   Filters the full array of WP_Theme objects to list in the Multisite themes list table.

Uses · 12

• sanitize_text_field()Sanitizes a string from user input or from the database.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• wp_get_themes()Returns an array of WP_Theme objects based on the arguments.
• get_site_option()Retrieve an option value for the current network based on name of option.
• get_site_transient()Retrieves the value of a site transient.
• current_user_can()Returns whether the current user has the specified capability.
• wp_is_auto_update_forced_for_item()Checks whether auto-updates are forced for an item.
• wp_localize_script()Localizes a script.
• wp_get_update_data()Collects counts and UI strings for available updates.
• WP_MS_Themes_List_Table::get_items_per_page()
• WP_Theme::sort_by_name()Sorts themes by name.
• WP_MS_Themes_List_Table::set_pagination_args()

Source

View on Trac ↗View on GitHub ↗

99	public function prepare_items() {100		global $status, $totals, $page, $orderby, $order, $s;101 102		$orderby = ! empty( $_REQUEST['orderby'] ) ? sanitize_text_field( $_REQUEST['orderby'] ) : '';103		$order   = ! empty( $_REQUEST['order'] ) ? sanitize_text_field( $_REQUEST['order'] ) : '';104		$s       = ! empty( $_REQUEST['s'] ) ? sanitize_text_field( $_REQUEST['s'] ) : '';105 106		$themes = array(107			/**108			 * Filters the full array of WP_Theme objects to list in the Multisite109			 * themes list table.110			 *111			 * @since 3.1.0112			 *113			 * @param WP_Theme[] $all Array of WP_Theme objects to display in the list table.114			 */115			'all'      => apply_filters( 'all_themes', wp_get_themes() ),116			'search'   => array(),117			'enabled'  => array(),118			'disabled' => array(),119			'upgrade'  => array(),120			'broken'   => $this->is_site_themes ? array() : wp_get_themes( array( 'errors' => true ) ),121		);122 123		if ( $this->show_autoupdates ) {124			$auto_updates = (array) get_site_option( 'auto_update_themes', array() );125 126			$themes['auto-update-enabled']  = array();127			$themes['auto-update-disabled'] = array();128		}129 130		if ( $this->is_site_themes ) {131			$themes_per_page = $this->get_items_per_page( 'site_themes_network_per_page' );132			$allowed_where   = 'site';133		} else {134			$themes_per_page = $this->get_items_per_page( 'themes_network_per_page' );135			$allowed_where   = 'network';136		}137 138		$current      = get_site_transient( 'update_themes' );139		$maybe_update = current_user_can( 'update_themes' ) && ! $this->is_site_themes && $current;140 141		foreach ( (array) $themes['all'] as $key => $theme ) {142			if ( $this->is_site_themes && $theme->is_allowed( 'network' ) ) {143				unset( $themes['all'][ $key ] );144				continue;145			}146 147			if ( $maybe_update && isset( $current->response[ $key ] ) ) {148				$themes['all'][ $key ]->update = true;149				$themes['upgrade'][ $key ]     = $themes['all'][ $key ];150			}151 152			$filter                    = $theme->is_allowed( $allowed_where, $this->site_id ) ? 'enabled' : 'disabled';153			$themes[ $filter ][ $key ] = $themes['all'][ $key ];154 155			$theme_data = array(156				'update_supported' => isset( $theme->update_supported ) ? $theme->update_supported : true,157			);158 159			// Extra info if known. array_merge() ensures $theme_data has precedence if keys collide.160			if ( isset( $current->response[ $key ] ) ) {161				$theme_data = array_merge( (array) $current->response[ $key ], $theme_data );162			} elseif ( isset( $current->no_update[ $key ] ) ) {163				$theme_data = array_merge( (array) $current->no_update[ $key ], $theme_data );164			} else {165				$theme_data['update_supported'] = false;166			}167 168			$theme->update_supported = $theme_data['update_supported'];169 170			/*171			 * Create the expected payload for the auto_update_theme filter, this is the same data172			 * as contained within $updates or $no_updates but used when the Theme is not known.173			 */174			$filter_payload = array(175				'theme'        => $key,176				'new_version'  => '',177				'url'          => '',178				'package'      => '',

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