summaryrefslogtreecommitdiffstats
path: root/wp-admin/includes/class-wp-ajax-upgrader-skin.php
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 07:56:49 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 07:56:49 +0000
commita415c29efee45520ae252d2aa28f1083a521cd7b (patch)
treef4ade4b6668ecc0765de7e1424f7c1427ad433ff /wp-admin/includes/class-wp-ajax-upgrader-skin.php
parentInitial commit. (diff)
downloadwordpress-a415c29efee45520ae252d2aa28f1083a521cd7b.tar.xz
wordpress-a415c29efee45520ae252d2aa28f1083a521cd7b.zip
Adding upstream version 6.4.3+dfsg1.upstream/6.4.3+dfsg1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'wp-admin/includes/class-wp-ajax-upgrader-skin.php')
-rw-r--r--wp-admin/includes/class-wp-ajax-upgrader-skin.php159
1 files changed, 159 insertions, 0 deletions
diff --git a/wp-admin/includes/class-wp-ajax-upgrader-skin.php b/wp-admin/includes/class-wp-ajax-upgrader-skin.php
new file mode 100644
index 0000000..1ac8e31
--- /dev/null
+++ b/wp-admin/includes/class-wp-ajax-upgrader-skin.php
@@ -0,0 +1,159 @@
+<?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 ( str_contains( $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 );
+ }
+}