upgrader_source_selection │ filter-hook │ WP 2.8.0

Filters the source file location for the upgrade package.

Usage

add_filter( 'upgrader_source_selection', 'wp_kama_upgrader_source_selection_filter', 10, 4 );

/**
 * Function for `upgrader_source_selection` filter-hook.
 * 
 * @param string|WP_Error $source        File source location or a WP_Error object.
 * @param string          $remote_source Remote file source location.
 * @param WP_Upgrader     $upgrader      WP_Upgrader instance.
 * @param array           $hook_extra    Extra arguments passed to hooked filters.
 *
 * @return string|WP_Error
 */
function wp_kama_upgrader_source_selection_filter( $source, $remote_source, $upgrader, $hook_extra ){

	// filter...
	return $source;
}

$source(string|WP_Error)

File source location or a WP_Error object.

$remote_source(string)

Remote file source location.

$upgrader(WP_Upgrader)

WP_Upgrader instance.

$hook_extra(array)

Extra arguments passed to hooked filters.

Changelog

Where the hook is called

$source = apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] );

Where the hook is used in WordPress

add_filter( 'upgrader_source_selection', array( $this, 'check_package' ), 10, 2 );

remove_filter( 'upgrader_source_selection', array( $this, 'check_package' ) );

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

remove_filter( 'upgrader_source_selection', array( $this, 'check_package' ) );

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

remove_filter( 'upgrader_source_selection', array( $this, 'check_package' ) );

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

remove_filter( 'upgrader_source_selection', array( $this, 'check_package' ) );

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

remove_filter( 'upgrader_source_selection', array( $this, 'check_package' ) );