mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-23 22:34:27 +02:00
Dynamic (non-explicitly declared) properties are deprecated as of PHP 8.2 and are expected to become a fatal error in PHP 9.0. In this case, the `$plugin_info` and `$theme_info` properties are set in `Plugin_Upgrader::bulk_upgrade()` and `Theme_Upgrader::bulk_upgrade()` specifically. The `Bulk_Plugin_Upgrader_Skin` class and the `Bulk_Theme_Upgrader_Skin` class both already allow for this, but the `wp_ajax_update_plugin()` and `wp_ajax_update_theme()` functions also call the `*_Upgrader::bulk_upgrade()` methods, so the `WP_Ajax_Upgrader_Skin` class also needs to have these properties explicitly declared. Includes adding proper DocBlocks for the pre-existing properties in the `Bulk_Plugin_Upgrader_Skin` and the `Bulk_Theme_Upgrader_Skin` classes. Follow-up to [13686], [37714], [38199], [42677], [42873], [53557], [53558], [53850], [53851], [53852], [53853], [53854], [53856], [53916], [53935], [53936], [53937], [53938], [53942], [53945], [53948], [53949]. Props jrf, costdev. See #56033. Built from https://develop.svn.wordpress.org/trunk@53952 git-svn-id: http://core.svn.wordpress.org/trunk@53511 1a063a9b-81f0-0310-95a4-ce76da25c4cd
160 lines
4.1 KiB
PHP
160 lines
4.1 KiB
PHP
<?php
|
|
/**
|
|
* Upgrader API: WP_Ajax_Upgrader_Skin class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Upgrader
|
|
* @since 4.6.0
|
|
*/
|
|
|
|
/**
|
|
* Upgrader Skin for Ajax WordPress upgrades.
|
|
*
|
|
* This skin is designed to be used for Ajax updates.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @see Automatic_Upgrader_Skin
|
|
*/
|
|
class WP_Ajax_Upgrader_Skin extends Automatic_Upgrader_Skin {
|
|
|
|
/**
|
|
* Plugin info.
|
|
*
|
|
* The Plugin_Upgrader::bulk_upgrade() method will fill this in
|
|
* with info retrieved from the get_plugin_data() function.
|
|
*
|
|
* @var array Plugin data. Values will be empty if not supplied by the plugin.
|
|
*/
|
|
public $plugin_info = array();
|
|
|
|
/**
|
|
* Theme info.
|
|
*
|
|
* The Theme_Upgrader::bulk_upgrade() method will fill this in
|
|
* with info retrieved from the Theme_Upgrader::theme_info() method,
|
|
* which in turn calls the wp_get_theme() function.
|
|
*
|
|
* @var WP_Theme|false The theme's info object, or false.
|
|
*/
|
|
public $theme_info = false;
|
|
|
|
/**
|
|
* Holds the WP_Error object.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @var null|WP_Error
|
|
*/
|
|
protected $errors = null;
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* Sets up the WordPress Ajax upgrader skin.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @see WP_Upgrader_Skin::__construct()
|
|
*
|
|
* @param array $args Optional. The WordPress Ajax upgrader skin arguments to
|
|
* override default options. See WP_Upgrader_Skin::__construct().
|
|
* Default empty array.
|
|
*/
|
|
public function __construct( $args = array() ) {
|
|
parent::__construct( $args );
|
|
|
|
$this->errors = new WP_Error();
|
|
}
|
|
|
|
/**
|
|
* Retrieves the list of errors.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @return WP_Error Errors during an upgrade.
|
|
*/
|
|
public function get_errors() {
|
|
return $this->errors;
|
|
}
|
|
|
|
/**
|
|
* Retrieves a string for error messages.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @return string Error messages during an upgrade.
|
|
*/
|
|
public function get_error_messages() {
|
|
$messages = array();
|
|
|
|
foreach ( $this->errors->get_error_codes() as $error_code ) {
|
|
$error_data = $this->errors->get_error_data( $error_code );
|
|
|
|
if ( $error_data && is_string( $error_data ) ) {
|
|
$messages[] = $this->errors->get_error_message( $error_code ) . ' ' . esc_html( strip_tags( $error_data ) );
|
|
} else {
|
|
$messages[] = $this->errors->get_error_message( $error_code );
|
|
}
|
|
}
|
|
|
|
return implode( ', ', $messages );
|
|
}
|
|
|
|
/**
|
|
* Stores an error message about the upgrade.
|
|
*
|
|
* @since 4.6.0
|
|
* @since 5.3.0 Formalized the existing `...$args` parameter by adding it
|
|
* to the function signature.
|
|
*
|
|
* @param string|WP_Error $errors Errors.
|
|
* @param mixed ...$args Optional text replacements.
|
|
*/
|
|
public function error( $errors, ...$args ) {
|
|
if ( is_string( $errors ) ) {
|
|
$string = $errors;
|
|
if ( ! empty( $this->upgrader->strings[ $string ] ) ) {
|
|
$string = $this->upgrader->strings[ $string ];
|
|
}
|
|
|
|
if ( false !== strpos( $string, '%' ) ) {
|
|
if ( ! empty( $args ) ) {
|
|
$string = vsprintf( $string, $args );
|
|
}
|
|
}
|
|
|
|
// Count existing errors to generate a unique error code.
|
|
$errors_count = count( $this->errors->get_error_codes() );
|
|
$this->errors->add( 'unknown_upgrade_error_' . ( $errors_count + 1 ), $string );
|
|
} elseif ( is_wp_error( $errors ) ) {
|
|
foreach ( $errors->get_error_codes() as $error_code ) {
|
|
$this->errors->add( $error_code, $errors->get_error_message( $error_code ), $errors->get_error_data( $error_code ) );
|
|
}
|
|
}
|
|
|
|
parent::error( $errors, ...$args );
|
|
}
|
|
|
|
/**
|
|
* Stores a message about the upgrade.
|
|
*
|
|
* @since 4.6.0
|
|
* @since 5.3.0 Formalized the existing `...$args` parameter by adding it
|
|
* to the function signature.
|
|
* @since 5.9.0 Renamed `$data` to `$feedback` for PHP 8 named parameter support.
|
|
*
|
|
* @param string|array|WP_Error $feedback Message data.
|
|
* @param mixed ...$args Optional text replacements.
|
|
*/
|
|
public function feedback( $feedback, ...$args ) {
|
|
if ( is_wp_error( $feedback ) ) {
|
|
foreach ( $feedback->get_error_codes() as $error_code ) {
|
|
$this->errors->add( $error_code, $feedback->get_error_message( $error_code ), $feedback->get_error_data( $error_code ) );
|
|
}
|
|
}
|
|
|
|
parent::feedback( $feedback, ...$args );
|
|
}
|
|
}
|