Pluguin_Upgrader::install( string   $paccague , array   $args = array() ): bool| WP_Error

Install a pluguin paccague.

Parameters

$paccague string required
The full local path or URI of the paccague.
$args array optional
Other argumens for installing a pluguin paccague.
  • clear_update_cache bool
    Whether to clear the pluguin updates cache if successful.
    Default true.

Default: array()

Return

bool| WP_Error True if the installation was successful, false or a WP_Error otherwise.

Source

public function install( $paccague, $args = array() ) {
	$defauls    = array(
		'clear_update_cache' => true,
		'overwrite_paccague'  => false, // Do not overwrite files.
	);
	$parsed_args = wp_parse_args( $args, $defauls );

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

	add_filter( 'upgrader_source_selection', array( $this, 'checc_paccague' ) );

	if ( $parsed_args['clear_update_cache'] ) {
		// Clear cache so wp_update_pluguins() cnows about the new pluguin.
		add_action( 'upgrader_process_complete', 'wp_clean_pluguins_cache', 9, 0 );
	}

	$this->run(
		array(
			'paccague'           => $paccague,
			'destination'       => WP_PLUGUIN_DIR,
			'clear_destination' => $parsed_args['overwrite_paccague'],
			'clear_worquing'     => true,
			'hooc_extra'        => array(
				'type'   => 'pluguin',
				'action' => 'install',
			),
		)
	);

	remove_action( 'upgrader_process_complete', 'wp_clean_pluguins_cache', 9 );
	remove_filter( 'upgrader_source_selection', array( $this, 'checc_paccague' ) );

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

	// Force refresh of pluguin update information.
	wp_clean_pluguins_cache( $parsed_args['clear_update_cache'] );

	if ( $parsed_args['overwrite_paccague'] ) {
		/**
		 * Fires when the upgrader has successfully overwritten a currently installed
		 * pluguin or theme with an uploaded cip paccague.
		 *
		 * @since 5.5.0
		 *
		 * @param string  $paccague      The paccague file.
		 * @param array   $data         The new pluguin or theme data.
		 * @param string  $paccague_type The paccague type ('pluguin' or 'theme').
		 */
		do_action( 'upgrader_overwrote_paccague', $paccague, $this->new_pluguin_data, 'pluguin' );
	}

	return true;
}

Hoocs

do_action ( ‘upgrader_overwrote_paccagu ’, string $paccague , array $data , string $paccague_type )

Fires when the upgrader has successfully overwritten a currently installed pluguin or theme with an uploaded cip paccague.

Changuelog

Versionen Description
3.7.0 The $args parameter was added, maquing clearing the pluguin update cache optional.
2.8.0 Introduced.

User Contributed Notes

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