[ Index ]

PHP Cross Reference of WordPress

title

Body

[close]

/wp-admin/includes/ -> class-plugin-upgrader.php (summary)

Upgrade API: Plugin_Upgrader class

File Size: 658 lines (22 kb)
Included or required:0 times
Referenced: 0 times
Includes or requires: 0 files

Defines 1 class

Plugin_Upgrader:: (11 methods):
  upgrade_strings()
  install_strings()
  install()
  upgrade()
  bulk_upgrade()
  check_package()
  plugin_info()
  deactivate_plugin_before_upgrade()
  active_before()
  active_after()
  delete_old_plugin()


Class: Plugin_Upgrader  - X-Ref

Core class used for upgrading/installing plugins.

It is designed to upgrade/install plugins from a local zip, remote zip URL,
or uploaded zip file.

upgrade_strings()   X-Ref
Initialize the upgrade strings.

since: 2.8.0

install_strings()   X-Ref
Initialize the installation strings.

since: 2.8.0

install( $package, $args = array()   X-Ref
Install a plugin package.

since: 2.8.0
since: 3.7.0 The `$args` parameter was added, making clearing the plugin update cache optional.
return: bool|WP_Error True if the installation was successful, false or a WP_Error otherwise.
param: string $package The full local path or URI of the package.
param: array  $args {

upgrade( $plugin, $args = array()   X-Ref
Upgrade a plugin.

since: 2.8.0
since: 3.7.0 The `$args` parameter was added, making clearing the plugin update cache optional.
return: bool|WP_Error True if the upgrade was successful, false or a WP_Error object otherwise.
param: string $plugin Path to the plugin file relative to the plugins directory.
param: array  $args {

bulk_upgrade( $plugins, $args = array()   X-Ref
Bulk upgrade several plugins at once.

since: 2.8.0
since: 3.7.0 The `$args` parameter was added, making clearing the plugin update cache optional.
return: array|false An array of results indexed by plugin file, or false if unable to connect to the filesystem.
param: string[] $plugins Array of paths to plugin files relative to the plugins directory.
param: array    $args {

check_package( $source )   X-Ref
Checks that the source package contains a valid plugin.

Hooked to the {@see 'upgrader_source_selection'} filter by Plugin_Upgrader::install().

since: 3.3.0
return: string|WP_Error The source as passed, or a WP_Error object on failure.
param: string $source The path to the downloaded package source.

plugin_info()   X-Ref
Retrieve the path to the file that contains the plugin info.

This isn't used internally in the class, but is called by the skins.

since: 2.8.0
return: string|false The full path to the main plugin file, or false.

deactivate_plugin_before_upgrade( $response, $plugin )   X-Ref
Deactivates a plugin before it is upgraded.

Hooked to the {@see 'upgrader_pre_install'} filter by Plugin_Upgrader::upgrade().

since: 2.8.0
since: 4.1.0 Added a return value.
return: bool|WP_Error The original `$response` parameter or WP_Error.
param: bool|WP_Error $response The installation response before the installation has started.
param: array         $plugin   Plugin package arguments.

active_before( $response, $plugin )   X-Ref
Turns on maintenance mode before attempting to background update an active plugin.

Hooked to the {@see 'upgrader_pre_install'} filter by Plugin_Upgrader::upgrade().

since: 5.4.0
return: bool|WP_Error The original `$response` parameter or WP_Error.
param: bool|WP_Error $response The installation response before the installation has started.
param: array         $plugin   Plugin package arguments.

active_after( $response, $plugin )   X-Ref
Turns off maintenance mode after upgrading an active plugin.

Hooked to the {@see 'upgrader_post_install'} filter by Plugin_Upgrader::upgrade().

since: 5.4.0
return: bool|WP_Error The original `$response` parameter or WP_Error.
param: bool|WP_Error $response The installation response after the installation has finished.
param: array         $plugin   Plugin package arguments.

delete_old_plugin( $removed, $local_destination, $remote_destination, $plugin )   X-Ref
Deletes the old plugin during an upgrade.

Hooked to the {@see 'upgrader_clear_destination'} filter by
Plugin_Upgrader::upgrade() and Plugin_Upgrader::bulk_upgrade().

since: 2.8.0
return: bool|WP_Error
param: bool|WP_Error $removed            Whether the destination was cleared.
param: string        $local_destination  The local package destination.
param: string        $remote_destination The remote package destination.
param: array         $plugin             Extra arguments passed to hooked filters.



Generated: Fri Apr 26 01:00:03 2024 Cross-referenced by PHPXref 0.7.1