wppaste
WordPress

apply_filters( 'upgrader_source_selection', string $source, string $remote_source, WP_Upgrader $upgrader, array $hook_extra )

Since
2.8.0, 4.4.0
Filters the source file location for the upgrade package.

Compatibility

WordPress
since 4.4.0
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$sourcestring
File source location.
$remote_sourcestring
Remote file source location.
$upgraderWP_Upgrader
WP_Upgrader instance.
$hook_extraarray
Extra arguments passed to hooked filters.

Where this hook fires · 1

  • wp-admin/includes/class-wp-upgrader.php:601WP_Upgrader::install_package()

Source code

		 *		 * @param string      $source        File source location.		 * @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.		 */		$source = apply_filters( 'upgrader_source_selection', $source, $remote_source, $this, $args['hook_extra'] ); 		if ( is_wp_error( $source ) ) {			return $source;		} 		if ( ! empty( $args['hook_extra']['temp_backup'] ) ) {

Changelog

Introduced in 2.8.0. One change between 6.7.7 and 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

7.0.4
Parameter $source retyped from string to string|WP_Error.verified against source
4.4.0
The $hook_extra parameter became available.from the docblock
2.8.0
Introduced.from the docblock

About this page

Parsed data
Generated from the wordpress-develop 6.8.8 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.