enmi-conf.org: wp/wp-admin/includes/class-wp-ajax-upgrader-skin.php@a86126ab1dd4 (annotated)

7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	1	<?php
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	2	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	3	* Upgrader API: WP_Ajax_Upgrader_Skin class
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	4	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	5	* @package WordPress
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	6	* @subpackage Upgrader
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	7	* @since 4.6.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	8	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	9
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	10	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	11	* Upgrader Skin for Ajax WordPress upgrades.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	12	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	13	* This skin is designed to be used for Ajax updates.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	14	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	15	* @since 4.6.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	16	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	17	* @see Automatic_Upgrader_Skin
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	18	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	19	class WP_Ajax_Upgrader_Skin extends Automatic_Upgrader_Skin {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	20
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	21	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	22	* Holds the WP_Error object.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	23	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	24	* @since 4.6.0
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	25	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	26	* @var null\|WP_Error
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	27	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	28	protected $errors = null;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	29
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	30	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	31	* Constructor.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	32	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	33	* Sets up the WordPress Ajax upgrader skin.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	34	*
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	35	* @since 4.6.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	36	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	37	* @see WP_Upgrader_Skin::__construct()
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	38	*
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	39	* @param array $args Optional. The WordPress Ajax upgrader skin arguments to
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	40	* override default options. See WP_Upgrader_Skin::__construct().
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	41	* Default empty array.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	42	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	43	public function __construct( $args = array() ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	44	parent::__construct( $args );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	45
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	46	$this->errors = new WP_Error();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	47	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	48
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	49	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	50	* Retrieves the list of errors.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	51	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	52	* @since 4.6.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	53	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	54	* @return WP_Error Errors during an upgrade.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	55	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	56	public function get_errors() {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	57	return $this->errors;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	58	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	59
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	60	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	61	* Retrieves a string for error messages.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	62	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	63	* @since 4.6.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	64	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	65	* @return string Error messages during an upgrade.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	66	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	67	public function get_error_messages() {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	68	$messages = array();
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	69
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	70	foreach ( $this->errors->get_error_codes() as $error_code ) {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	71	$error_data = $this->errors->get_error_data( $error_code );
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	72
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	73	if ( $error_data && is_string( $error_data ) ) {
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	74	$messages[] = $this->errors->get_error_message( $error_code ) . ' ' . esc_html( strip_tags( $error_data ) );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	75	} else {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	76	$messages[] = $this->errors->get_error_message( $error_code );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	77	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	78	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	79
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	80	return implode( ', ', $messages );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	81	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	82
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	83	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	84	* Stores a log entry for an error.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	85	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	86	* @since 4.6.0
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	87	* @since 5.3.0 Formalized the existing `...$args` parameter by adding it
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	88	* to the function signature.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	89	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	90	* @param string\|WP_Error $errors Errors.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	91	* @param mixed ...$args Optional text replacements.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	92	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	93	public function error( $errors, ...$args ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	94	if ( is_string( $errors ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	95	$string = $errors;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	96	if ( ! empty( $this->upgrader->strings[ $string ] ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	97	$string = $this->upgrader->strings[ $string ];
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	98	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	99
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	100	if ( false !== strpos( $string, '%' ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	101	if ( ! empty( $args ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	102	$string = vsprintf( $string, $args );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	103	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	104	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	105
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	106	// Count existing errors to generate a unique error code.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	107	$errors_count = count( $this->errors->get_error_codes() );
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	108	$this->errors->add( 'unknown_upgrade_error_' . ( $errors_count + 1 ), $string );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	109	} elseif ( is_wp_error( $errors ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	110	foreach ( $errors->get_error_codes() as $error_code ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	111	$this->errors->add( $error_code, $errors->get_error_message( $error_code ), $errors->get_error_data( $error_code ) );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	112	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	113	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	114
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	115	parent::error( $errors, ...$args );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	116	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	117
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	118	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	119	* Stores a log entry.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	120	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	121	* @since 4.6.0
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	122	* @since 5.3.0 Formalized the existing `...$args` parameter by adding it
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	123	* to the function signature.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	124	*
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	125	* @param string\|array\|WP_Error $data Log entry data.
a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	126	* @param mixed ...$args Optional text replacements.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	127	*/
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	128	public function feedback( $data, ...$args ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	129	if ( is_wp_error( $data ) ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	130	foreach ( $data->get_error_codes() as $error_code ) {
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	131	$this->errors->add( $error_code, $data->get_error_message( $error_code ), $data->get_error_data( $error_code ) );
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	132	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	133	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	134
16 a86126ab1dd4 update enmi-conf ymh <ymh.work@gmail.com> parents: 9 diff changeset	135	parent::feedback( $data, ...$args );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	136	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	137	}

author	ymh <ymh.work@gmail.com>
	Tue, 15 Dec 2020 13:49:49 +0100
changeset 16	a86126ab1dd4
parent 9	177826044cd9
child 18	be944660c56a
permissions	-rw-r--r--