WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru
функция не описана

Theme_Upgrader::upgrade() public WP 2.8.0

Upgrade a theme.

Это метод класса: Theme_Upgrader{}

Хуков нет.

Возвращает

true/false/WP_Error. True if the upgrade was successful, false or a WP_Error object otherwise.

Использование

$Theme_Upgrader = new Theme_Upgrader();
$Theme_Upgrader->upgrade( $theme, $args );
$theme(строка) (обязательный)
The theme slug.
$args(массив)

Other arguments for upgrading a theme.

  • clear_update_cache(true/false)
    Whether to clear the update cache if successful.
    По умолчанию: true

По умолчанию: empty array

Список изменений

С версии 2.8.0 Введена.
С версии 3.7.0 The $args parameter was added, making clearing the update cache optional.

Код Theme_Upgrader::upgrade() WP 5.5.1

wp-admin/includes/class-theme-upgrader.php
<?php
public function upgrade( $theme, $args = array() ) {
	$defaults    = array(
		'clear_update_cache' => true,
	);
	$parsed_args = wp_parse_args( $args, $defaults );

	$this->init();
	$this->upgrade_strings();

	// Is an update available?
	$current = get_site_transient( 'update_themes' );
	if ( ! isset( $current->response[ $theme ] ) ) {
		$this->skin->before();
		$this->skin->set_result( false );
		$this->skin->error( 'up_to_date' );
		$this->skin->after();
		return false;
	}

	$r = $current->response[ $theme ];

	add_filter( 'upgrader_pre_install', array( $this, 'current_before' ), 10, 2 );
	add_filter( 'upgrader_post_install', array( $this, 'current_after' ), 10, 2 );
	add_filter( 'upgrader_clear_destination', array( $this, 'delete_old_theme' ), 10, 4 );
	if ( $parsed_args['clear_update_cache'] ) {
		// Clear cache so wp_update_themes() knows about the new theme.
		add_action( 'upgrader_process_complete', 'wp_clean_themes_cache', 9, 0 );
	}

	$this->run(
		array(
			'package'           => $r['package'],
			'destination'       => get_theme_root( $theme ),
			'clear_destination' => true,
			'clear_working'     => true,
			'hook_extra'        => array(
				'theme'  => $theme,
				'type'   => 'theme',
				'action' => 'update',
			),
		)
	);

	remove_action( 'upgrader_process_complete', 'wp_clean_themes_cache', 9 );
	remove_filter( 'upgrader_pre_install', array( $this, 'current_before' ) );
	remove_filter( 'upgrader_post_install', array( $this, 'current_after' ) );
	remove_filter( 'upgrader_clear_destination', array( $this, 'delete_old_theme' ) );

	if ( ! $this->result || is_wp_error( $this->result ) ) {
		return $this->result;
	}

	wp_clean_themes_cache( $parsed_args['clear_update_cache'] );

	// Ensure any future auto-update failures trigger a failure email by removing
	// the last failure notification from the list when themes update successfully.
	$past_failure_emails = get_option( 'auto_plugin_theme_update_emails', array() );

	if ( isset( $past_failure_emails[ $theme ] ) ) {
		unset( $past_failure_emails[ $theme ] );
		update_option( 'auto_plugin_theme_update_emails', $past_failure_emails );
	}

	return true;
}