wp_ajax_install_theme()

Uses · 20

• check_ajax_referer()Verifies the Ajax request to prevent processing requests external of the blog.
• wp_send_json_error()Sends a JSON response back to an Ajax request, indicating failure.
• __()Retrieves the translation of $text.
• sanitize_key()Sanitizes a string key.
• wp_unslash()Removes slashes from a string or recursively removes slashes from strings within an array.
• current_user_can()Returns whether the current user has the specified capability.
• themes_api()Retrieves theme installer pages from the WordPress.org Themes API.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• esc_html()Escaping for HTML blocks.
• wp_get_theme()Gets a WP_Theme object for a theme.
• is_multisite()Determines whether Multisite is enabled.
• add_query_arg()Retrieves a modified URL query string.

Source

View on Trac ↗View on GitHub ↗

4164function wp_ajax_install_theme() {4165	check_ajax_referer( 'updates' );4166 4167	if ( empty( $_POST['slug'] ) ) {4168		wp_send_json_error(4169			array(4170				'slug'         => '',4171				'errorCode'    => 'no_theme_specified',4172				'errorMessage' => __( 'No theme specified.' ),4173			)4174		);4175	}4176 4177	$slug = sanitize_key( wp_unslash( $_POST['slug'] ) );4178 4179	$status = array(4180		'install' => 'theme',4181		'slug'    => $slug,4182	);4183 4184	if ( ! current_user_can( 'install_themes' ) ) {4185		$status['errorMessage'] = __( 'Sorry, you are not allowed to install themes on this site.' );4186		wp_send_json_error( $status );4187	}4188 4189	require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';4190	require_once ABSPATH . 'wp-admin/includes/theme.php';4191 4192	$api = themes_api(4193		'theme_information',4194		array(4195			'slug'   => $slug,4196			'fields' => array( 'sections' => false ),4197		)4198	);4199 4200	if ( is_wp_error( $api ) ) {4201		$status['errorMessage'] = $api->get_error_message();4202		wp_send_json_error( $status );4203	}4204 4205	$skin     = new WP_Ajax_Upgrader_Skin();4206	$upgrader = new Theme_Upgrader( $skin );4207	$result   = $upgrader->install( $api->download_link );4208 4209	if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {4210		$status['debug'] = $skin->get_upgrade_messages();4211	}4212 4213	if ( is_wp_error( $result ) ) {4214		$status['errorCode']    = $result->get_error_code();4215		$status['errorMessage'] = $result->get_error_message();4216		wp_send_json_error( $status );4217	} elseif ( is_wp_error( $skin->result ) ) {4218		$status['errorCode']    = $skin->result->get_error_code();4219		$status['errorMessage'] = $skin->result->get_error_message();4220		wp_send_json_error( $status );4221	} elseif ( $skin->get_errors()->has_errors() ) {4222		$status['errorMessage'] = $skin->get_error_messages();4223		wp_send_json_error( $status );4224	} elseif ( is_null( $result ) ) {4225		global $wp_filesystem;4226 4227		$status['errorCode']    = 'unable_to_connect_to_filesystem';4228		$status['errorMessage'] = __( 'Unable to connect to the filesystem. Please confirm your credentials.' );4229 4230		// Pass through the error from WP_Filesystem if one was raised.4231		if ( $wp_filesystem instanceof WP_Filesystem_Base && is_wp_error( $wp_filesystem->errors ) && $wp_filesystem->errors->has_errors() ) {4232			$status['errorMessage'] = esc_html( $wp_filesystem->errors->get_error_message() );4233		}4234 4235		wp_send_json_error( $status );4236	}4237 4238	$status['themeName'] = wp_get_theme( $slug )->get( 'Name' );4239 4240	if ( current_user_can( 'switch_themes' ) ) {4241		if ( is_multisite() ) {4242			$status['activateUrl'] = add_query_arg(4243				array(

History

Introduced in 4.6.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 7.0.4 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.