Theme_Upgrader::install()
最后更新于:2021-11-26 04:13:48
Theme_Upgrader::install( string$package, array$args=array())Install a theme package.
参数
- $package
-
(string) (Required) The full local path or URI of the package.
- $args
-
(array) (Optional) Other arguments for installing a theme package.
-
‘clear_update_cache’
(bool) Whether to clear the updates cache if successful. Default true.
Default value: array()
-
‘clear_update_cache’
响应
(bool|GC_Error) True if the installation was successful, false or a GC_Error object otherwise.
源文件
文件: gc-admin/includes/class-theme-upgrader.php
public function install( $package, $args = array() ) {
$defaults = array(
'clear_update_cache' => true,
'overwrite_package' => false, // Do not overwrite files.
);
$parsed_args = gc_parse_args( $args, $defaults );
$this->init();
$this->install_strings();
add_filter( 'upgrader_source_selection', array( $this, 'check_package' ) );
add_filter( 'upgrader_post_install', array( $this, 'check_parent_theme_filter' ), 10, 3 );
if ( $parsed_args['clear_update_cache'] ) {
// Clear cache so gc_update_themes() knows about the new theme.
add_action( 'upgrader_process_complete', 'gc_clean_themes_cache', 9, 0 );
}
$this->run(
array(
'package' => $package,
'destination' => get_theme_root(),
'clear_destination' => $parsed_args['overwrite_package'],
'clear_working' => true,
'hook_extra' => array(
'type' => 'theme',
'action' => 'install',
),
)
);
remove_action( 'upgrader_process_complete', 'gc_clean_themes_cache', 9 );
remove_filter( 'upgrader_source_selection', array( $this, 'check_package' ) );
remove_filter( 'upgrader_post_install', array( $this, 'check_parent_theme_filter' ) );
if ( ! $this->result || is_gc_error( $this->result ) ) {
return $this->result;
}
// Refresh the Theme Update information.
gc_clean_themes_cache( $parsed_args['clear_update_cache'] );
if ( $parsed_args['overwrite_package'] ) {
/** This action is documented in gc-admin/includes/class-plugin-upgrader.php */
do_action( 'upgrader_overwrote_package', $package, $this->new_theme_data, 'theme' );
}
return true;
}