wp_ajax_query_themes()

Hooks fired · 1

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

1. 1
   apply_filters( install_themes_table_api_args_{$old_filter} )filterline 3643 (+30 into the body)

Uses · 25

• current_user_can()Returns whether the current user has the specified capability.
• wp_send_json_error()Sends a JSON response back to an Ajax request, indicating failure.
• wp_parse_args()Merges user defined arguments into defaults array.
• wp_unslash()Removes slashes from a string or recursively removes slashes from strings within an array.
• get_user_option()Retrieves user option that can be either per Site or per Network.
• apply_filters()Calls the callback functions that have been added to a filter 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.
• network_admin_url()Retrieves the URL to the admin area for the network.
• search_theme_directories()Searches all registered theme directories for complete and valid themes.
• str_contains()Polyfill for `str_contains()` function added in PHP 8.0.
• add_query_arg()Retrieves a modified URL query string.

Source

View on Trac ↗View on GitHub ↗

3613function wp_ajax_query_themes() {3614	global $themes_allowedtags, $theme_field_defaults;3615 3616	if ( ! current_user_can( 'install_themes' ) ) {3617		wp_send_json_error();3618	}3619 3620	$args = wp_parse_args(3621		wp_unslash( $_REQUEST['request'] ),3622		array(3623			'per_page' => 20,3624			'fields'   => array_merge(3625				(array) $theme_field_defaults,3626				array(3627					'reviews_url' => true, // Explicitly request the reviews URL to be linked from the Add Themes screen.3628				)3629			),3630		)3631	);3632 3633	if ( isset( $args['browse'] ) && 'favorites' === $args['browse'] && ! isset( $args['user'] ) ) {3634		$user = get_user_option( 'wporg_favorites' );3635		if ( $user ) {3636			$args['user'] = $user;3637		}3638	}3639 3640	$old_filter = isset( $args['browse'] ) ? $args['browse'] : 'search';3641 3642	/** This filter is documented in wp-admin/includes/class-wp-theme-install-list-table.php */3643	$args = apply_filters( 'install_themes_table_api_args_' . $old_filter, $args );3644 3645	$api = themes_api( 'query_themes', $args );3646 3647	if ( is_wp_error( $api ) ) {3648		wp_send_json_error();3649	}3650 3651	$update_php = network_admin_url( 'update.php?action=install-theme' );3652 3653	$installed_themes = search_theme_directories();3654 3655	if ( false === $installed_themes ) {3656		$installed_themes = array();3657	}3658 3659	foreach ( $installed_themes as $theme_slug => $theme_data ) {3660		// Ignore child themes.3661		if ( str_contains( $theme_slug, '/' ) ) {3662			unset( $installed_themes[ $theme_slug ] );3663		}3664	}3665 3666	foreach ( $api->themes as &$theme ) {3667		$theme->install_url = add_query_arg(3668			array(3669				'theme'    => $theme->slug,3670				'_wpnonce' => wp_create_nonce( 'install-theme_' . $theme->slug ),3671			),3672			$update_php3673		);3674 3675		if ( current_user_can( 'switch_themes' ) ) {3676			if ( is_multisite() ) {3677				$theme->activate_url = add_query_arg(3678					array(3679						'action'   => 'enable',3680						'_wpnonce' => wp_create_nonce( 'enable-theme_' . $theme->slug ),3681						'theme'    => $theme->slug,3682					),3683					network_admin_url( 'themes.php' )3684				);3685			} else {3686				$theme->activate_url = add_query_arg(3687					array(3688						'action'     => 'activate',3689						'_wpnonce'   => wp_create_nonce( 'switch-theme_' . $theme->slug ),3690						'stylesheet' => $theme->slug,3691					),3692					admin_url( 'themes.php' )

History

Introduced in 3.9.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/ajax-actions.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.