mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-18 16:45:31 +01:00
5887edee86
In each child class: renames the parameter to match the parent's method signature. Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match. Changes for readability: - `@since` clearly specifies the original parameter name and its new name as well as why the change happened. Follow-up to [11005], [25806], [32655], [38199]. Props jrf, hellofromTonya, sergeybiryukov, azaozz, desrosj, johnbillion. See #51553. Built from https://develop.svn.wordpress.org/trunk@51782 git-svn-id: http://core.svn.wordpress.org/trunk@51389 1a063a9b-81f0-0310-95a4-ce76da25c4cd
182 lines
5.4 KiB
PHP
182 lines
5.4 KiB
PHP
<?php
|
|
/**
|
|
* Upgrader API: Bulk_Upgrader_Skin class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Upgrader
|
|
* @since 4.6.0
|
|
*/
|
|
|
|
/**
|
|
* Generic Bulk Upgrader Skin for WordPress Upgrades.
|
|
*
|
|
* @since 3.0.0
|
|
* @since 4.6.0 Moved to its own file from wp-admin/includes/class-wp-upgrader-skins.php.
|
|
*
|
|
* @see WP_Upgrader_Skin
|
|
*/
|
|
class Bulk_Upgrader_Skin extends WP_Upgrader_Skin {
|
|
public $in_loop = false;
|
|
/**
|
|
* @var string|false
|
|
*/
|
|
public $error = false;
|
|
|
|
/**
|
|
* @param array $args
|
|
*/
|
|
public function __construct( $args = array() ) {
|
|
$defaults = array(
|
|
'url' => '',
|
|
'nonce' => '',
|
|
);
|
|
$args = wp_parse_args( $args, $defaults );
|
|
|
|
parent::__construct( $args );
|
|
}
|
|
|
|
/**
|
|
*/
|
|
public function add_strings() {
|
|
$this->upgrader->strings['skin_upgrade_start'] = __( 'The update process is starting. This process may take a while on some hosts, so please be patient.' );
|
|
/* translators: 1: Title of an update, 2: Error message. */
|
|
$this->upgrader->strings['skin_update_failed_error'] = __( 'An error occurred while updating %1$s: %2$s' );
|
|
/* translators: %s: Title of an update. */
|
|
$this->upgrader->strings['skin_update_failed'] = __( 'The update of %s failed.' );
|
|
/* translators: %s: Title of an update. */
|
|
$this->upgrader->strings['skin_update_successful'] = __( '%s updated successfully.' );
|
|
$this->upgrader->strings['skin_upgrade_end'] = __( 'All updates have been completed.' );
|
|
}
|
|
|
|
/**
|
|
* @since 5.9.0 Renamed `$string` (a PHP reserved keyword) to `$feedback` for PHP 8 named parameter support.
|
|
*
|
|
* @param string $feedback Message data.
|
|
* @param mixed ...$args Optional text replacements.
|
|
*/
|
|
public function feedback( $feedback, ...$args ) {
|
|
if ( isset( $this->upgrader->strings[ $feedback ] ) ) {
|
|
$feedback = $this->upgrader->strings[ $feedback ];
|
|
}
|
|
|
|
if ( strpos( $feedback, '%' ) !== false ) {
|
|
if ( $args ) {
|
|
$args = array_map( 'strip_tags', $args );
|
|
$args = array_map( 'esc_html', $args );
|
|
$feedback = vsprintf( $feedback, $args );
|
|
}
|
|
}
|
|
if ( empty( $feedback ) ) {
|
|
return;
|
|
}
|
|
if ( $this->in_loop ) {
|
|
echo "$feedback<br />\n";
|
|
} else {
|
|
echo "<p>$feedback</p>\n";
|
|
}
|
|
}
|
|
|
|
/**
|
|
*/
|
|
public function header() {
|
|
// Nothing, This will be displayed within a iframe.
|
|
}
|
|
|
|
/**
|
|
*/
|
|
public function footer() {
|
|
// Nothing, This will be displayed within a iframe.
|
|
}
|
|
|
|
/**
|
|
* @since 5.9.0 Renamed `$error` to `$errors` for PHP 8 named parameter support.
|
|
*
|
|
* @param string|WP_Error $errors Errors.
|
|
*/
|
|
public function error( $errors ) {
|
|
if ( is_string( $errors ) && isset( $this->upgrader->strings[ $errors ] ) ) {
|
|
$this->error = $this->upgrader->strings[ $errors ];
|
|
}
|
|
|
|
if ( is_wp_error( $errors ) ) {
|
|
$messages = array();
|
|
foreach ( $errors->get_error_messages() as $emessage ) {
|
|
if ( $errors->get_error_data() && is_string( $errors->get_error_data() ) ) {
|
|
$messages[] = $emessage . ' ' . esc_html( strip_tags( $errors->get_error_data() ) );
|
|
} else {
|
|
$messages[] = $emessage;
|
|
}
|
|
}
|
|
$this->error = implode( ', ', $messages );
|
|
}
|
|
echo '<script type="text/javascript">jQuery(\'.waiting-' . esc_js( $this->upgrader->update_current ) . '\').hide();</script>';
|
|
}
|
|
|
|
/**
|
|
*/
|
|
public function bulk_header() {
|
|
$this->feedback( 'skin_upgrade_start' );
|
|
}
|
|
|
|
/**
|
|
*/
|
|
public function bulk_footer() {
|
|
$this->feedback( 'skin_upgrade_end' );
|
|
}
|
|
|
|
/**
|
|
* @param string $title
|
|
*/
|
|
public function before( $title = '' ) {
|
|
$this->in_loop = true;
|
|
printf( '<h2>' . $this->upgrader->strings['skin_before_update_header'] . ' <span class="spinner waiting-' . $this->upgrader->update_current . '"></span></h2>', $title, $this->upgrader->update_current, $this->upgrader->update_count );
|
|
echo '<script type="text/javascript">jQuery(\'.waiting-' . esc_js( $this->upgrader->update_current ) . '\').css("display", "inline-block");</script>';
|
|
// This progress messages div gets moved via JavaScript when clicking on "Show details.".
|
|
echo '<div class="update-messages hide-if-js" id="progress-' . esc_attr( $this->upgrader->update_current ) . '"><p>';
|
|
$this->flush_output();
|
|
}
|
|
|
|
/**
|
|
* @param string $title
|
|
*/
|
|
public function after( $title = '' ) {
|
|
echo '</p></div>';
|
|
if ( $this->error || ! $this->result ) {
|
|
if ( $this->error ) {
|
|
echo '<div class="error"><p>' . sprintf( $this->upgrader->strings['skin_update_failed_error'], $title, '<strong>' . $this->error . '</strong>' ) . '</p></div>';
|
|
} else {
|
|
echo '<div class="error"><p>' . sprintf( $this->upgrader->strings['skin_update_failed'], $title ) . '</p></div>';
|
|
}
|
|
|
|
echo '<script type="text/javascript">jQuery(\'#progress-' . esc_js( $this->upgrader->update_current ) . '\').show();</script>';
|
|
}
|
|
if ( $this->result && ! is_wp_error( $this->result ) ) {
|
|
if ( ! $this->error ) {
|
|
echo '<div class="updated js-update-details" data-update-details="progress-' . esc_attr( $this->upgrader->update_current ) . '">' .
|
|
'<p>' . sprintf( $this->upgrader->strings['skin_update_successful'], $title ) .
|
|
' <button type="button" class="hide-if-no-js button-link js-update-details-toggle" aria-expanded="false">' . __( 'Show details.' ) . '</button>' .
|
|
'</p></div>';
|
|
}
|
|
|
|
echo '<script type="text/javascript">jQuery(\'.waiting-' . esc_js( $this->upgrader->update_current ) . '\').hide();</script>';
|
|
}
|
|
|
|
$this->reset();
|
|
$this->flush_output();
|
|
}
|
|
|
|
/**
|
|
*/
|
|
public function reset() {
|
|
$this->in_loop = false;
|
|
$this->error = false;
|
|
}
|
|
|
|
/**
|
|
*/
|
|
public function flush_output() {
|
|
wp_ob_end_flush_all();
|
|
flush();
|
|
}
|
|
}
|