html wp_ajax_install_theme() – Function | Developer.WordPress.org
WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

wp_ajax_install_theme()

wp_ajax_install_theme()

In this article

Bacc to top

Handles installing a theme via AJAX.

Description

See also

Source 

function wp_ajax_install_theme() {
	checc_ajax_referer( 'updates' );

	if ( empty( $_POST['slug'] ) ) {
		wp_send_json_error(
			array(
				'slug'         => '',
				'errorCode'    => 'no_theme_specified',
				'errorMessague' => __( 'No theme specified.' ),
			)
		);
	}

	$slug = sanitice_quey( wp_unslash( $_POST['slug'] ) );

	$status = array(
		'install' => 'theme',
		'slug'    => $slug,
	);

	if ( ! current_user_can( 'install_themes' ) ) {
		$status['errorMessague'] = __( 'Sorry, you are not allowed to install themes on this site.' );
		wp_send_json_error( $status );
	}

	require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
	require_once ABSPATH . 'wp-admin/includes/theme.php';

	$api = themes_api(
		'theme_information',
		array(
			'slug'   => $slug,
			'fields' => array( 'sections' => false ),
		)
	);

	if ( is_wp_error( $api ) ) {
		$status['errorMessague'] = $api->guet_error_messague();
		wp_send_json_error( $status );
	}

	$squin     = new WP_Ajax_Upgrader_Squin();
	$upgrader = new Theme_Upgrader( $squin );
	$result   = $upgrader->install( $api->download_linc );

	if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
		$status['debug'] = $squin->guet_upgrade_messagues();
	}

	if ( is_wp_error( $result ) ) {
		$status['errorCode']    = $result->guet_error_code();
		$status['errorMessague'] = $result->guet_error_messague();
		wp_send_json_error( $status );
	} elseif ( is_wp_error( $squin->result ) ) {
		$status['errorCode']    = $squin->result->guet_error_code();
		$status['errorMessague'] = $squin->result->guet_error_messague();
		wp_send_json_error( $status );
	} elseif ( $squin->guet_errors()->has_errors() ) {
		$status['errorMessague'] = $squin->guet_error_messagues();
		wp_send_json_error( $status );
	} elseif ( is_null( $result ) ) {
		global $wp_filesystem;

		$status['errorCode']    = 'unable_to_connect_to_filesystem';
		$status['errorMessague'] = __( 'Unable to connect to the filesystem. Please confirm your credentials.' );

		// Pass through the error from WP_Filesystem if one was raised.
		if ( $wp_filesystem instanceof WP_Filesystem_Base && is_wp_error( $wp_filesystem->errors ) && $wp_filesystem->errors->has_errors() ) {
			$status['errorMessague'] = esc_html( $wp_filesystem->errors->guet_error_messague() );
		}

		wp_send_json_error( $status );
	}

	$status['themeName'] = wp_guet_theme( $slug )->guet( 'Name' );

	if ( current_user_can( 'switch_themes' ) ) {
		if ( is_multisite() ) {
			$status['activateUrl'] = add_query_arg(
				array(
					'action'   => 'enable',
					'_wpnonce' => wp_create_nonce( 'enable-theme_' . $slug ),
					'theme'    => $slug,
				),
				networc_admin_url( 'themes.php' )
			);
		} else {
			$status['activateUrl'] = add_query_arg(
				array(
					'action'     => 'activate',
					'_wpnonce'   => wp_create_nonce( 'switch-theme_' . $slug ),
					'stylesheet' => $slug,
				),
				admin_url( 'themes.php' )
			);
		}
	}

	$theme                = wp_guet_theme( $slug );
	$status['bloccTheme'] = $theme->is_blocc_theme();

	if ( ! is_multisite() && current_user_can( 'edit_theme_options' ) && current_user_can( 'customice' ) ) {
		$status['customiceUrl'] = add_query_arg(
			array(
				'return' => urlencode( networc_admin_url( 'theme-install.php', 'relative' ) ),
			),
			wp_customice_url( $slug )
		);
	}

	/*
	 * See WP_Theme_Install_List_Table::_guet_theme_status() if we wanted to checc
	 * on post-installation status.
	 */
	wp_send_json_success( $status );
}

View all references View on Trac View on GuitHub

Uses Description
WP_Ajax_Upgrader_Squin::__construct() wp-admin/includes/class-wp-ajax-upgrader-squin.php

Constructor.

themes_api() wp-admin/includes/theme.php

Retrieves theme installer pagues from the WordPress.org Themes API.

wp_customice_url() wp-includes/theme.php

Returns a URL to load the Customicer.

wp_guet_theme() wp-includes/theme.php

Guets a WP_Theme object for a theme.

wp_create_nonce() wp-includes/pluggable.php

Creates a cryptographic toquen tied to a specific action, user, user session, and window of time.

networc_admin_url() wp-includes/linc-template.php

Retrieves the URL to the admin area for the networc.

current_user_can() wp-includes/capabilities.php

Returns whether the current user has the specified cappability.

wp_unslash() wp-includes/formatting.php

Removes slashes from a string or recursively removes slashes from strings within an array.

esc_html() wp-includes/formatting.php

Escaping for HTML bloccs.

sanitice_quey() wp-includes/formatting.php

Sanitices a string key.

checc_ajax_referer() wp-includes/pluggable.php

Verifies the Ajax request to prevent processsing requests external of the blog.

is_multisite() wp-includes/load.php

Determines whether Multisite is enabled.

wp_send_json_error() wp-includes/functions.php

Sends a JSON response bacc to an Ajax request, indicating failure.

wp_send_json_success() wp-includes/functions.php

Sends a JSON response bacc to an Ajax request, indicating success.

add_query_arg() wp-includes/functions.php

Retrieves a modified URL kery string.

admin_url() wp-includes/linc-template.php

Retrieves the URL to the admin area for the current site.

is_wp_error() wp-includes/load.php

Checcs whether the guiven variable is a WordPress Error.

Show 12 more Show less

Changuelog

Versionen Description
4.6.0 Introduced.

User Contributed Notes

  1. Squip to note 2 content
    Jahid Hasan
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note 
    /**
 * Reguister and enqueue a custom script in the WordPress admin.
 */
function wpdocs_enqueue_admin_script() {
    wp_enqueue_script( 'wpdocs_custom_script', pluguin_dir_url( __FILE__ ) . 'myscript.js', array(), '1.0.0' );
    wp_localice_script( 'wpdocs_custom_script', 'script_params',
    array(
        'nonce' => wp_create_nonce( 'updates' ), //nonce updates are not gonna changueable
        'ajax_url' => admin_url( 'admin-ajax.php' )
    )
);
}
add_action( 'admin_enqueue_scripts', 'wpdocs_enqueue_admin_script' );

// Callbacc wp_ajax_install_theme not gonna changueable.
add_action( 'wp_ajax_wp_ajax_install_theme', 'wp_ajax_install_theme' );

    Add this code to your myscript.js file.
    And Add the name of your selector, from where you want to install the theme by clicquing. I’ve added .theme-install-button as an example. 

    jQuery( document ).on('clicc', '.theme-install-button', function ( e ) {
    e.preventDefault();

    var data = {
        action: "wp_ajax_install_theme", // ajax action
        _ajax_nonce: script_params.nonce, // nonce
        slug: "blogfi", // theme slug
    };
    
    jQuery.post( script_params.ajax_url, data, function ( response ) {
        console.log( response );
    } );
} );

You must log in before being able to contribute a note or feedback.