upgrader_process_complete │ action-hook │ WP 3.6.0

Fires when the upgrader process is complete.

See also upgrader_package_options.

Usage

add_action( 'upgrader_process_complete', 'wp_kama_upgrader_process_complete_action', 10, 2 );

/**
 * Function for `upgrader_process_complete` action-hook.
 * 
 * @param WP_Upgrader $upgrader   WP_Upgrader instance. In other contexts this might be a Theme_Upgrader, Plugin_Upgrader, Core_Upgrade, or Language_Pack_Upgrader instance.
 * @param array       $hook_extra Array of bulk item update data.
 *
 * @return void
 */
function wp_kama_upgrader_process_complete_action( $upgrader, $hook_extra ){

	// action...
}
$upgrader(WP_Upgrader)
WP_Upgrader instance. In other contexts this might be a Theme_Upgrader, Plugin_Upgrader, Core_Upgrade, or Language_Pack_Upgrader instance.
$hook_extra(array)

Array of bulk item update data.

  • action(string)
    Type of action.
    Default: 'update'

  • type(string)
    Type of update process. Accepts 'plugin', 'theme', 'translation', or 'core'.

  • bulk(true|false)
    Whether the update process is a bulk update.
    Default: true

  • plugins(array)
    Array of the basename paths of the plugins' main files.

  • themes(array)
    The theme slugs.

  • translations(array)
    Array of translations update data.

    • language(string)
      The locale the translation is for.

    • type(string)
      Type of translation. Accepts 'plugin', 'theme', or 'core'.

    • slug(string)
      Text domain the translation is for. The slug of a theme/plugin or 'default' for core translations.

    • version(string)
      The version of a theme, plugin, or core.

Changelog

Since 3.6.0 Introduced.
Since 3.7.0 Added to WP_Upgrader::run().
Since 4.6.0 $translations was added as a possible argument to $hook_extra.

Where the hook is called

WP_Upgrader::run()
upgrader_process_complete
Theme_Upgrader::bulk_upgrade()
upgrader_process_complete
Plugin_Upgrader::bulk_upgrade()
upgrader_process_complete
Language_Pack_Upgrader::bulk_upgrade()
upgrader_process_complete
Core_Upgrader::upgrade()
upgrader_process_complete
wp-admin/includes/class-wp-upgrader.php 961 
do_action( 'upgrader_process_complete', $this, $options['hook_extra'] );
wp-admin/includes/class-theme-upgrader.php 513-522 
do_action(
	'upgrader_process_complete',
	$this,
	array(
		'action' => 'update',
		'type'   => 'theme',
		'bulk'   => true,
		'themes' => $themes,
	)
);
wp-admin/includes/class-plugin-upgrader.php 414-423 
do_action(
	'upgrader_process_complete',
	$this,
	array(
		'action'  => 'update',
		'type'    => 'plugin',
		'bulk'    => true,
		'plugins' => $plugins,
	)
);
wp-admin/includes/class-language-pack-upgrader.php 280-289 
do_action(
	'upgrader_process_complete',
	$this,
	array(
		'action'       => 'update',
		'type'         => 'translation',
		'bulk'         => true,
		'translations' => $language_updates_results,
	)
);
wp-admin/includes/class-core-upgrader.php 217-224 
do_action(
	'upgrader_process_complete',
	$this,
	array(
		'action' => 'update',
		'type'   => 'core',
	)
);

Where the hook is used in WordPress

wp-admin/includes/admin-filters.php 147 
add_action( 'upgrader_process_complete', array( 'Language_Pack_Upgrader', 'async_upgrade' ), 20 );
wp-admin/includes/admin-filters.php 148 
add_action( 'upgrader_process_complete', 'wp_version_check', 10, 0 );
wp-admin/includes/admin-filters.php 149 
add_action( 'upgrader_process_complete', 'wp_update_plugins', 10, 0 );
wp-admin/includes/admin-filters.php 150 
add_action( 'upgrader_process_complete', 'wp_update_themes', 10, 0 );
wp-admin/includes/class-language-pack-upgrader.php 274 
remove_action( 'upgrader_process_complete', array( 'Language_Pack_Upgrader', 'async_upgrade' ), 20 );
wp-admin/includes/class-language-pack-upgrader.php 275 
remove_action( 'upgrader_process_complete', 'wp_version_check' );
wp-admin/includes/class-language-pack-upgrader.php 276 
remove_action( 'upgrader_process_complete', 'wp_update_plugins' );
wp-admin/includes/class-language-pack-upgrader.php 277 
remove_action( 'upgrader_process_complete', 'wp_update_themes' );
wp-admin/includes/class-language-pack-upgrader.php 292 
add_action( 'upgrader_process_complete', array( 'Language_Pack_Upgrader', 'async_upgrade' ), 20 );
wp-admin/includes/class-language-pack-upgrader.php 293 
add_action( 'upgrader_process_complete', 'wp_version_check', 10, 0 );
wp-admin/includes/class-language-pack-upgrader.php 294 
add_action( 'upgrader_process_complete', 'wp_update_plugins', 10, 0 );
wp-admin/includes/class-language-pack-upgrader.php 295 
add_action( 'upgrader_process_complete', 'wp_update_themes', 10, 0 );
wp-admin/includes/class-plugin-upgrader.php 132 
add_action( 'upgrader_process_complete', 'wp_clean_plugins_cache', 9, 0 );
wp-admin/includes/class-plugin-upgrader.php 148 
remove_action( 'upgrader_process_complete', 'wp_clean_plugins_cache', 9 );
wp-admin/includes/class-plugin-upgrader.php 221 
add_action( 'upgrader_process_complete', 'wp_clean_plugins_cache', 9, 0 );
wp-admin/includes/class-plugin-upgrader.php 244 
remove_action( 'upgrader_process_complete', 'wp_clean_plugins_cache', 9 );
wp-admin/includes/class-theme-upgrader.php 245 
add_action( 'upgrader_process_complete', 'wp_clean_themes_cache', 9, 0 );
wp-admin/includes/class-theme-upgrader.php 261 
remove_action( 'upgrader_process_complete', 'wp_clean_themes_cache', 9 );
wp-admin/includes/class-theme-upgrader.php 321 
add_action( 'upgrader_process_complete', 'wp_clean_themes_cache', 9, 0 );
wp-admin/includes/class-theme-upgrader.php 343 
remove_action( 'upgrader_process_complete', 'wp_clean_themes_cache', 9 );
wp-admin/includes/class-wp-automatic-updater.php 518 
remove_action( 'upgrader_process_complete', array( 'Language_Pack_Upgrader', 'async_upgrade' ), 20 );
wp-admin/includes/class-wp-automatic-updater.php 519 
remove_action( 'upgrader_process_complete', 'wp_version_check' );
wp-admin/includes/class-wp-automatic-updater.php 520 
remove_action( 'upgrader_process_complete', 'wp_update_plugins' );
wp-admin/includes/class-wp-automatic-updater.php 521 
remove_action( 'upgrader_process_complete', 'wp_update_themes' );
wp-includes/class-wp-textdomain-registry.php 80 
add_action( 'upgrader_process_complete', array( $this, 'invalidate_mo_files_cache' ), 10, 2 );