do_action( 'upgrader_process_complete', WP_Upgrader $this, array $hook_extra )

Fires when the upgrader process is complete.

Description

See also ‘upgrader_package_options’.

Parameters

$this

(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'
    (bool) 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.

More Information

The upgrader_process_complete action hook is run when the download process for a plugin install or update finishes.

Use with caution: When you use the upgrader_process_complete action hook in your plugin and your plugin is the one which under upgrade, then this action will run the old version of your plugin.

Source

File: wp-admin/includes/class-wp-upgrader.php

View on Trac

Used By

Used By Description
wp-admin/includes/class-language-pack-upgrader.php: Language_Pack_Upgrader::bulk_upgrade()

Bulk upgrade language packs.
wp-admin/includes/class-core-upgrader.php: Core_Upgrader::upgrade()

Upgrade WordPress core.
wp-admin/includes/class-theme-upgrader.php: Theme_Upgrader::bulk_upgrade()

Upgrade several themes at once.
wp-admin/includes/class-plugin-upgrader.php: Plugin_Upgrader::bulk_upgrade()

Bulk upgrade several plugins at once.
wp-admin/includes/class-wp-upgrader.php: WP_Upgrader::run()

Run an upgrade/installation.

Changelog

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

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/upgrader_process_complete