upgrader_clear_destination │ filter-hook │ WP 2.8.0

Filters whether the upgrader cleared the destination.

Usage

add_filter( 'upgrader_clear_destination', 'wp_kama_upgrader_clear_destination_filter', 10, 4 );

/**
 * Function for `upgrader_clear_destination` filter-hook.
 * 
 * @param true|WP_Error $removed            Whether the destination was cleared. True upon success, WP_Error on failure.
 * @param string        $local_destination  The local package destination.
 * @param string        $remote_destination The remote package destination.
 * @param array         $hook_extra         Extra arguments passed to hooked filters.
 *
 * @return true|WP_Error
 */
function wp_kama_upgrader_clear_destination_filter( $removed, $local_destination, $remote_destination, $hook_extra ){

	// filter...
	return $removed;
}

$removed(true|WP_Error)

Whether the destination was cleared. True upon success, WP_Error on failure.

$local_destination(string)

The local package destination.

$remote_destination(string)

The remote package destination.

$hook_extra(array)

Extra arguments passed to hooked filters.

Changelog

Where the hook is called

$removed = apply_filters( 'upgrader_clear_destination', $removed, $local_destination, $remote_destination, $args['hook_extra'] );

Where the hook is used in WordPress

add_filter( 'upgrader_clear_destination', array( $this, 'delete_old_plugin' ), 10, 4 );

remove_filter( 'upgrader_clear_destination', array( $this, 'delete_old_plugin' ) );

add_filter( 'upgrader_clear_destination', array( $this, 'delete_old_plugin' ), 10, 4 );

remove_filter( 'upgrader_clear_destination', array( $this, 'delete_old_plugin' ) );

add_filter( 'upgrader_clear_destination', array( $this, 'delete_old_theme' ), 10, 4 );

remove_filter( 'upgrader_clear_destination', array( $this, 'delete_old_theme' ) );

add_filter( 'upgrader_clear_destination', array( $this, 'delete_old_theme' ), 10, 4 );

remove_filter( 'upgrader_clear_destination', array( $this, 'delete_old_theme' ) );