<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* Upgrader API: Automatic_Upgrader_Skin class

[2] Fix | Delete

*

[3] Fix | Delete

* @package WordPress

[4] Fix | Delete

* @subpackage Upgrader

[5] Fix | Delete

* @since 4.6.0

[6] Fix | Delete

*/

[7] Fix | Delete

[8] Fix | Delete

/**

[9] Fix | Delete

* Upgrader Skin for Automatic WordPress Upgrades.

[10] Fix | Delete

*

[11] Fix | Delete

* This skin is designed to be used when no output is intended, all output

[12] Fix | Delete

* is captured and stored for the caller to process and log/email/discard.

[13] Fix | Delete

*

[14] Fix | Delete

* @since 3.7.0

[15] Fix | Delete

* @since 4.6.0 Moved to its own file from wp-admin/includes/class-wp-upgrader-skins.php.

[16] Fix | Delete

*

[17] Fix | Delete

* @see Bulk_Upgrader_Skin

[18] Fix | Delete

*/

[19] Fix | Delete

class Automatic_Upgrader_Skin extends WP_Upgrader_Skin {

[20] Fix | Delete

protected $messages = array();

[21] Fix | Delete

[22] Fix | Delete

/**

[23] Fix | Delete

* Determines whether the upgrader needs FTP/SSH details in order to connect

[24] Fix | Delete

* to the filesystem.

[25] Fix | Delete

*

[26] Fix | Delete

* @since 3.7.0

[27] Fix | Delete

* @since 4.6.0 The `$context` parameter default changed from `false` to an empty string.

[28] Fix | Delete

*

[29] Fix | Delete

* @see request_filesystem_credentials()

[30] Fix | Delete

*

[31] Fix | Delete

* @param bool|WP_Error $error Optional. Whether the current request has failed to connect,

[32] Fix | Delete

* or an error object. Default false.

[33] Fix | Delete

* @param string $context Optional. Full path to the directory that is tested

[34] Fix | Delete

* for being writable. Default empty.

[35] Fix | Delete

* @param bool $allow_relaxed_file_ownership Optional. Whether to allow Group/World writable. Default false.

[36] Fix | Delete

* @return bool True on success, false on failure.

[37] Fix | Delete

*/

[38] Fix | Delete

public function request_filesystem_credentials( $error = false, $context = '', $allow_relaxed_file_ownership = false ) {

[39] Fix | Delete

if ( $context ) {

[40] Fix | Delete

$this->options['context'] = $context;

[41] Fix | Delete

}

[42] Fix | Delete

/*

[43] Fix | Delete

* TODO: Fix up request_filesystem_credentials(), or split it, to allow us to request a no-output version.

[44] Fix | Delete

* This will output a credentials form in event of failure. We don't want that, so just hide with a buffer.

[45] Fix | Delete

*/

[46] Fix | Delete

ob_start();

[47] Fix | Delete

$result = parent::request_filesystem_credentials( $error, $context, $allow_relaxed_file_ownership );

[48] Fix | Delete

ob_end_clean();

[49] Fix | Delete

return $result;

[50] Fix | Delete

}

[51] Fix | Delete

[52] Fix | Delete

/**

[53] Fix | Delete

* Retrieves the upgrade messages.

[54] Fix | Delete

*

[55] Fix | Delete

* @since 3.7.0

[56] Fix | Delete

*

[57] Fix | Delete

* @return string[] Messages during an upgrade.

[58] Fix | Delete

*/

[59] Fix | Delete

public function get_upgrade_messages() {

[60] Fix | Delete

return $this->messages;

[61] Fix | Delete

}

[62] Fix | Delete

[63] Fix | Delete

/**

[64] Fix | Delete

* Stores a message about the upgrade.

[65] Fix | Delete

*

[66] Fix | Delete

* @since 3.7.0

[67] Fix | Delete

* @since 5.9.0 Renamed `$data` to `$feedback` for PHP 8 named parameter support.

[68] Fix | Delete

*

[69] Fix | Delete

* @param string|array|WP_Error $feedback Message data.

[70] Fix | Delete

* @param mixed ...$args Optional text replacements.

[71] Fix | Delete

*/

[72] Fix | Delete

public function feedback( $feedback, ...$args ) {

[73] Fix | Delete

if ( is_wp_error( $feedback ) ) {

[74] Fix | Delete

$string = $feedback->get_error_message();

[75] Fix | Delete

} elseif ( is_array( $feedback ) ) {

[76] Fix | Delete

return;

[77] Fix | Delete

} else {

[78] Fix | Delete

$string = $feedback;

[79] Fix | Delete

}

[80] Fix | Delete

[81] Fix | Delete

if ( ! empty( $this->upgrader->strings[ $string ] ) ) {

[82] Fix | Delete

$string = $this->upgrader->strings[ $string ];

[83] Fix | Delete

}

[84] Fix | Delete

[85] Fix | Delete

if ( str_contains( $string, '%' ) ) {

[86] Fix | Delete

if ( ! empty( $args ) ) {

[87] Fix | Delete

$string = vsprintf( $string, $args );

[88] Fix | Delete

}

[89] Fix | Delete

}

[90] Fix | Delete

[91] Fix | Delete

$string = trim( $string );

[92] Fix | Delete

[93] Fix | Delete

// Only allow basic HTML in the messages, as it'll be used in emails/logs rather than direct browser output.

[94] Fix | Delete

$string = wp_kses(

[95] Fix | Delete

$string,

[96] Fix | Delete

array(

[97] Fix | Delete

'a' => array(

[98] Fix | Delete

'href' => true,

[99] Fix | Delete

),

[100] Fix | Delete

'br' => true,

[101] Fix | Delete

'em' => true,

[102] Fix | Delete

'strong' => true,

[103] Fix | Delete

)

[104] Fix | Delete

);

[105] Fix | Delete

[106] Fix | Delete

if ( empty( $string ) ) {

[107] Fix | Delete

return;

[108] Fix | Delete

}

[109] Fix | Delete

[110] Fix | Delete

$this->messages[] = $string;

[111] Fix | Delete

}

[112] Fix | Delete

[113] Fix | Delete

/**

[114] Fix | Delete

* Creates a new output buffer.

[115] Fix | Delete

*

[116] Fix | Delete

* @since 3.7.0

[117] Fix | Delete

*/

[118] Fix | Delete

public function header() {

[119] Fix | Delete

ob_start();

[120] Fix | Delete

}

[121] Fix | Delete

[122] Fix | Delete

/**

[123] Fix | Delete

* Retrieves the buffered content, deletes the buffer, and processes the output.

[124] Fix | Delete

*

[125] Fix | Delete

* @since 3.7.0

[126] Fix | Delete

*/

[127] Fix | Delete

public function footer() {

[128] Fix | Delete

$output = ob_get_clean();

[129] Fix | Delete

if ( ! empty( $output ) ) {

[130] Fix | Delete

$this->feedback( $output );

[131] Fix | Delete

}

[132] Fix | Delete

}

[133] Fix | Delete

}

[134] Fix | Delete

[135] Fix | Delete