[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

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

Upgrade API: WP_Upgrader class Requires skin classes and WP_Upgrader subclasses for backward compatibility.

File Size: 1236 lines (45 kb)
Included or required: 18 times
Referenced: 0 times
Includes or requires: 17 files
 wp-admin/includes/class-automatic-upgrader-skin.php
 wp-admin/includes/class-language-pack-upgrader-skin.php
 wp-admin/includes/class-bulk-theme-upgrader-skin.php
 wp-admin/includes/class-bulk-plugin-upgrader-skin.php
 wp-admin/includes/class-plugin-upgrader-skin.php
 wp-admin/includes/class-plugin-installer-skin.php
 wp-admin/includes/class-plugin-upgrader.php
 wp-admin/includes/class-file-upload-upgrader.php
 wp-admin/includes/class-theme-upgrader.php
 wp-admin/includes/class-theme-installer-skin.php
 wp-admin/includes/class-theme-upgrader-skin.php
 wp-admin/includes/class-wp-upgrader-skin.php
 wp-admin/includes/class-wp-automatic-updater.php
 wp-admin/includes/class-wp-ajax-upgrader-skin.php
 wp-admin/includes/class-language-pack-upgrader.php
 wp-admin/includes/class-core-upgrader.php
 wp-admin/includes/class-bulk-upgrader-skin.php

Defines 1 class

WP_Upgrader:: (17 methods):
  __construct()
  init()
  schedule_temp_backup_cleanup()
  generic_strings()
  fs_connect()
  download_package()
  unpack_package()
  flatten_dirlist()
  clear_destination()
  install_package()
  run()
  maintenance_mode()
  create_lock()
  release_lock()
  move_to_temp_backup_dir()
  restore_temp_backup()
  delete_temp_backup()


Class: WP_Upgrader  - X-Ref

Core class used for upgrading/installing a local set of files via
the Filesystem Abstraction classes from a Zip file.

__construct( $skin = null )   X-Ref
Construct the upgrader with a skin.

param: WP_Upgrader_Skin $skin The upgrader skin to use. Default is a WP_Upgrader_Skin

init()   X-Ref
Initializes the upgrader.

This will set the relationship between the skin being used and this upgrader,
and also add the generic strings to `WP_Upgrader::$strings`.

Additionally, it will schedule a weekly task to clean up the temporary backup directory.


schedule_temp_backup_cleanup()   X-Ref
Schedules the cleanup of the temporary backup directory.


generic_strings()   X-Ref
Adds the generic strings to WP_Upgrader::$strings.


fs_connect( $directories = array()   X-Ref
Connects to the filesystem.

param: string[] $directories                  Optional. Array of directories. If any of these do
param: bool     $allow_relaxed_file_ownership Whether to allow relaxed file ownership.
return: bool|WP_Error True if able to connect, false or a WP_Error otherwise.

download_package( $package, $check_signatures = false, $hook_extra = array()   X-Ref
Downloads a package.

param: string $package          The URI of the package. If this is the full path to an
param: bool   $check_signatures Whether to validate file signatures. Default false.
param: array  $hook_extra       Extra arguments to pass to the filter hooks. Default empty array.
return: string|WP_Error The full path to the downloaded package file, or a WP_Error object.

unpack_package( $package, $delete_package = true )   X-Ref
Unpacks a compressed package file.

param: string $package        Full path to the package file.
param: bool   $delete_package Optional. Whether to delete the package file after attempting
return: string|WP_Error The path to the unpacked contents, or a WP_Error on failure.

flatten_dirlist( $nested_files, $path = '' )   X-Ref
Flattens the results of WP_Filesystem_Base::dirlist() for iterating over.

param: array  $nested_files Array of files as returned by WP_Filesystem_Base::dirlist().
param: string $path         Relative path to prepend to child nodes. Optional.
return: array A flattened array of the $nested_files specified.

clear_destination( $remote_destination )   X-Ref
Clears the directory where this item is going to be installed into.

param: string $remote_destination The location on the remote filesystem to be cleared.
return: true|WP_Error True upon success, WP_Error on failure.

install_package( $args = array()   X-Ref
Install a package.

Copies the contents of a package from a source directory, and installs them in
a destination directory. Optionally removes the source. It can also optionally
clear out the destination folder if it already exists.

param: array|string $args {
return: array|WP_Error The result (also stored in `WP_Upgrader::$result`), or a WP_Error on failure.

run( $options )   X-Ref
Runs an upgrade/installation.

Attempts to download the package (if it is not a local file), unpack it, and
install it in the destination folder.

param: array $options {
return: array|false|WP_Error The result from self::install_package() on success, otherwise a WP_Error,

maintenance_mode( $enable = false )   X-Ref
Toggles maintenance mode for the site.

Creates/deletes the maintenance file to enable/disable maintenance mode.

param: bool $enable True to enable maintenance mode, false to disable.

create_lock( $lock_name, $release_timeout = null )   X-Ref
Creates a lock using WordPress options.

param: string $lock_name       The name of this unique lock.
param: int    $release_timeout Optional. The duration in seconds to respect an existing lock.
return: bool False if a lock couldn't be created or if the lock is still valid. True otherwise.

release_lock( $lock_name )   X-Ref
Releases an upgrader lock.

param: string $lock_name The name of this unique lock.
return: bool True if the lock was successfully released. False on failure.

move_to_temp_backup_dir( $args )   X-Ref
Moves the plugin or theme being updated into a temporary backup directory.

param: string[] $args {
return: bool|WP_Error True on success, false on early exit, otherwise WP_Error.

restore_temp_backup()   X-Ref
Restores the plugin or theme from temporary backup.

return: bool|WP_Error True on success, false on early exit, otherwise WP_Error.

delete_temp_backup()   X-Ref
Deletes a temporary backup.

return: bool|WP_Error True on success, false on early exit, otherwise WP_Error.



Generated : Fri Mar 29 08:20:02 2024 Cross-referenced by PHPXref