2016-05-10 13:45:42 +02:00
< ? php
/**
2016-05-10 13:52:28 +02:00
* Upgrade API : WP_Automatic_Updater class
2016-05-10 13:45:42 +02:00
*
* @ package WordPress
* @ subpackage Upgrader
2016-05-10 13:52:28 +02:00
* @ since 4.6 . 0
2016-05-10 13:45:42 +02:00
*/
/**
* Core class used for handling automatic background updates .
*
* @ since 3.7 . 0
2016-05-13 22:59:27 +02:00
* @ since 4.6 . 0 Moved to its own file from wp - admin / includes / class - wp - upgrader . php .
2016-05-10 13:45:42 +02:00
*/
Code Modernization: Add `AllowDynamicProperties` attribute to all (parent) classes.
Dynamic (non-explicitly declared) properties are deprecated as of PHP 8.2 and are expected to become a fatal error in PHP 9.0.
There are a number of ways to mitigate this:
* If it is an accidental typo for a declared property: fix the typo.
* For known properties: declare them on the class.
* For unknown properties: add the magic `__get()`, `__set()`, et al. methods to the class or let the class extend `stdClass` which has highly optimized versions of these magic methods built in.
* For unknown ''use'' of dynamic properties, the `#[AllowDynamicProperties]` attribute can be added to the class. The attribute will automatically be inherited by child classes.
Trac ticket #56034 is open to investigate and handle the third and fourth type of situations, however it has become clear this will need more time and will not be ready in time for WP 6.1.
To reduce “noise” in the meantime, both in the error logs of WP users moving onto PHP 8.2, in the test run logs of WP itself, in test runs of plugins and themes, as well as to prevent duplicate tickets from being opened for the same issue, this commit adds the `#[AllowDynamicProperties]` attribute to all “parent” classes in WP.
The logic used for this commit is as follows:
* If a class already has the attribute: no action needed.
* If a class does not `extend`: add the attribute.
* If a class does `extend`:
- If it extends `stdClass`: no action needed (as `stdClass` supports dynamic properties).
- If it extends a PHP native class: add the attribute.
- If it extends a class from one of WP's external dependencies: add the attribute.
* In all other cases: no action — the attribute should not be needed as child classes inherit from the parent.
Whether or not a class contains magic methods has not been taken into account, as a review of the currently existing magic methods has shown that those are generally not sturdy enough and often even set dynamic properties (which they should not). See the [https://www.youtube.com/watch?v=vDZWepDQQVE live stream from August 16, 2022] for more details.
This commit only affects classes in the `src` directory of WordPress core.
* Tests should not get this attribute, but should be fixed to not use dynamic properties instead. Patches for this are already being committed under ticket #56033.
* While a number bundled themes (2014, 2019, 2020, 2021) contain classes, they are not a part of this commit and may be updated separately.
Reference: [https://wiki.php.net/rfc/deprecate_dynamic_properties PHP RFC: Deprecate dynamic properties].
Follow-up to [53922].
Props jrf, hellofromTonya, markjaquith, peterwilsoncc, costdev, knutsp, aristath.
See #56513, #56034.
Built from https://develop.svn.wordpress.org/trunk@54133
git-svn-id: http://core.svn.wordpress.org/trunk@53692 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-12 17:47:14 +02:00
#[AllowDynamicProperties]
2016-05-10 13:45:42 +02:00
class WP_Automatic_Updater {
/**
* Tracks update results during processing .
*
* @ var array
*/
protected $update_results = array ();
/**
2022-04-04 22:53:01 +02:00
* Determines whether the entire automatic updater is disabled .
2016-05-10 13:45:42 +02:00
*
* @ since 3.7 . 0
2023-03-27 16:13:22 +02:00
*
* @ return bool True if the automatic updater is disabled , false otherwise .
2016-05-10 13:45:42 +02:00
*/
public function is_disabled () {
// Background updates are disabled if you don't want file changes.
2017-12-01 00:11:00 +01:00
if ( ! wp_is_file_mod_allowed ( 'automatic_updater' ) ) {
2016-05-10 13:45:42 +02:00
return true ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2017-12-01 00:11:00 +01:00
if ( wp_installing () ) {
2016-05-10 13:45:42 +02:00
return true ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
// More fine grained control can be done through the WP_AUTO_UPDATE_CORE constant and filters.
$disabled = defined ( 'AUTOMATIC_UPDATER_DISABLED' ) && AUTOMATIC_UPDATER_DISABLED ;
/**
2016-05-22 20:01:30 +02:00
* Filters whether to entirely disable background updates .
2016-05-10 13:45:42 +02:00
*
* There are more fine - grained filters and controls for selective disabling .
* This filter parallels the AUTOMATIC_UPDATER_DISABLED constant in name .
*
* This also disables update notification emails . That may change in the future .
*
* @ since 3.7 . 0
*
* @ param bool $disabled Whether the updater should be disabled .
*/
return apply_filters ( 'automatic_updater_disabled' , $disabled );
}
Upgrade/Install: Introduce `WP_Automatic_Updater::is_allowed_dir()` method.
As part of determining whether to perform automatic updates, WordPress checks if it is running within a version-controlled environment, recursively looking up the filesystem to the top of the drive, looking for a Subversion, Git, Mercurial, or Bazaar directory, erring on the side of detecting a VCS checkout somewhere.
This commit avoids a PHP warning if the `open_basedir` directive is in use and any of the directories checked in the process are not allowed:
{{{
is_dir(): open_basedir restriction in effect. File(/.git) is not within the allowed path(s)
}}}
Follow-up to [25421], [25700], [25764], [25835], [25859].
Props costdev, markjaquith, meyegui, dd32, arnolp, robin-labadie, hellofromTonya, afragen, pbiron, SergeyBiryukov.
Fixes #42619.
Built from https://develop.svn.wordpress.org/trunk@55425
git-svn-id: http://core.svn.wordpress.org/trunk@54958 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-02-26 16:19:21 +01:00
/**
* Checks whether access to a given directory is allowed .
*
* This is used when detecting version control checkouts . Takes into account
* the PHP `open_basedir` restrictions , so that WordPress does not try to access
* directories it is not allowed to .
*
* @ since 6.2 . 0
*
* @ param string $dir The directory to check .
* @ return bool True if access to the directory is allowed , false otherwise .
*/
public function is_allowed_dir ( $dir ) {
if ( is_string ( $dir ) ) {
$dir = trim ( $dir );
}
if ( ! is_string ( $dir ) || '' === $dir ) {
_doing_it_wrong (
__METHOD__ ,
sprintf (
/* translators: %s: The "$dir" argument. */
__ ( 'The "%s" argument must be a non-empty string.' ),
'$dir'
),
'6.2.0'
);
return false ;
}
$open_basedir = ini_get ( 'open_basedir' );
if ( empty ( $open_basedir ) ) {
return true ;
}
$open_basedir_list = explode ( PATH_SEPARATOR , $open_basedir );
foreach ( $open_basedir_list as $basedir ) {
if ( '' !== trim ( $basedir ) && str_starts_with ( $dir , $basedir ) ) {
return true ;
}
}
return false ;
}
2016-05-10 13:45:42 +02:00
/**
2022-04-04 22:53:01 +02:00
* Checks for version control checkouts .
2016-05-10 13:45:42 +02:00
*
* Checks for Subversion , Git , Mercurial , and Bazaar . It recursively looks up the
* filesystem to the top of the drive , erring on the side of detecting a VCS
* checkout somewhere .
*
2020-09-27 10:36:06 +02:00
* ABSPATH is always checked in addition to whatever `$context` is ( which may be the
2016-05-10 13:45:42 +02:00
* wp - content directory , for example ) . The underlying assumption is that if you are
* using version control * anywhere * , then you should be making decisions for
* how things get updated .
*
* @ since 3.7 . 0
*
* @ param string $context The filesystem path to check , in addition to ABSPATH .
2020-09-27 10:36:06 +02:00
* @ return bool True if a VCS checkout was discovered at `$context` or ABSPATH ,
* or anywhere higher . False otherwise .
2016-05-10 13:45:42 +02:00
*/
public function is_vcs_checkout ( $context ) {
$context_dirs = array ( untrailingslashit ( $context ) );
2020-02-09 17:55:09 +01:00
if ( ABSPATH !== $context ) {
2016-05-10 13:45:42 +02:00
$context_dirs [] = untrailingslashit ( ABSPATH );
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2017-12-01 00:11:00 +01:00
$vcs_dirs = array ( '.svn' , '.git' , '.hg' , '.bzr' );
2016-05-10 13:45:42 +02:00
$check_dirs = array ();
foreach ( $context_dirs as $context_dir ) {
// Walk up from $context_dir to the root.
do {
$check_dirs [] = $context_dir ;
// Once we've hit '/' or 'C:\', we need to stop. dirname will keep returning the input here.
2020-02-09 17:55:09 +01:00
if ( dirname ( $context_dir ) === $context_dir ) {
2016-05-10 13:45:42 +02:00
break ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2017-12-01 00:11:00 +01:00
// Continue one level at a time.
2016-05-10 13:45:42 +02:00
} while ( $context_dir = dirname ( $context_dir ) );
}
$check_dirs = array_unique ( $check_dirs );
2023-07-02 12:35:23 +02:00
$checkout = false ;
2016-05-10 13:45:42 +02:00
// Search all directories we've found for evidence of version control.
foreach ( $vcs_dirs as $vcs_dir ) {
foreach ( $check_dirs as $check_dir ) {
Upgrade/Install: Introduce `WP_Automatic_Updater::is_allowed_dir()` method.
As part of determining whether to perform automatic updates, WordPress checks if it is running within a version-controlled environment, recursively looking up the filesystem to the top of the drive, looking for a Subversion, Git, Mercurial, or Bazaar directory, erring on the side of detecting a VCS checkout somewhere.
This commit avoids a PHP warning if the `open_basedir` directive is in use and any of the directories checked in the process are not allowed:
{{{
is_dir(): open_basedir restriction in effect. File(/.git) is not within the allowed path(s)
}}}
Follow-up to [25421], [25700], [25764], [25835], [25859].
Props costdev, markjaquith, meyegui, dd32, arnolp, robin-labadie, hellofromTonya, afragen, pbiron, SergeyBiryukov.
Fixes #42619.
Built from https://develop.svn.wordpress.org/trunk@55425
git-svn-id: http://core.svn.wordpress.org/trunk@54958 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-02-26 16:19:21 +01:00
if ( ! $this -> is_allowed_dir ( $check_dir ) ) {
continue ;
}
$checkout = is_dir ( rtrim ( $check_dir , '\\/' ) . " / $vcs_dir " );
2019-07-01 14:52:01 +02:00
if ( $checkout ) {
2016-05-10 13:45:42 +02:00
break 2 ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
}
}
/**
2016-05-22 20:01:30 +02:00
* Filters whether the automatic updater should consider a filesystem
2016-05-10 13:45:42 +02:00
* location to be potentially managed by a version control system .
*
* @ since 3.7 . 0
*
2020-09-27 10:36:06 +02:00
* @ param bool $checkout Whether a VCS checkout was discovered at `$context`
2016-05-10 13:45:42 +02:00
* or ABSPATH , or anywhere higher .
* @ param string $context The filesystem context ( a path ) against which
* filesystem status should be checked .
*/
return apply_filters ( 'automatic_updates_is_vcs_checkout' , $checkout , $context );
}
/**
* Tests to see if we can and should update a specific item .
*
* @ since 3.7 . 0
*
* @ global wpdb $wpdb WordPress database abstraction object .
*
* @ param string $type The type of update being checked : 'core' , 'theme' ,
* 'plugin' , 'translation' .
* @ param object $item The update offer .
* @ param string $context The filesystem context ( a path ) against which filesystem
* access and status should be checked .
2020-09-27 10:36:06 +02:00
* @ return bool True if the item should be updated , false otherwise .
2016-05-10 13:45:42 +02:00
*/
public function should_update ( $type , $item , $context ) {
// Used to see if WP_Filesystem is set up to allow unattended updates.
2022-11-29 16:51:14 +01:00
$skin = new Automatic_Upgrader_Skin ();
2016-05-10 13:45:42 +02:00
2017-12-01 00:11:00 +01:00
if ( $this -> is_disabled () ) {
2016-05-10 13:45:42 +02:00
return false ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2020-01-29 01:45:18 +01:00
// Only relax the filesystem checks when the update doesn't include new files.
2016-05-10 13:45:42 +02:00
$allow_relaxed_file_ownership = false ;
2020-05-16 20:42:12 +02:00
if ( 'core' === $type && isset ( $item -> new_files ) && ! $item -> new_files ) {
2016-05-10 13:45:42 +02:00
$allow_relaxed_file_ownership = true ;
}
// If we can't do an auto core update, we may still be able to email the user.
2021-04-16 14:01:15 +02:00
if ( ! $skin -> request_filesystem_credentials ( false , $context , $allow_relaxed_file_ownership )
|| $this -> is_vcs_checkout ( $context )
) {
2020-05-16 20:42:12 +02:00
if ( 'core' === $type ) {
2016-05-10 13:45:42 +02:00
$this -> send_core_update_notification_email ( $item );
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
return false ;
}
// Next up, is this an item we can update?
2020-05-16 20:42:12 +02:00
if ( 'core' === $type ) {
2016-05-10 13:45:42 +02:00
$update = Core_Upgrader :: should_update_to_version ( $item -> current );
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
} elseif ( 'plugin' === $type || 'theme' === $type ) {
$update = ! empty ( $item -> autoupdate );
if ( ! $update && wp_is_auto_update_enabled_for_type ( $type ) ) {
// Check if the site admin has enabled auto-updates by default for the specific item.
$auto_updates = ( array ) get_site_option ( " auto_update_ { $type } s " , array () );
$update = in_array ( $item -> { $type }, $auto_updates , true );
}
2017-12-01 00:11:00 +01:00
} else {
2016-05-10 13:45:42 +02:00
$update = ! empty ( $item -> autoupdate );
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2020-07-31 19:03:05 +02:00
// If the `disable_autoupdate` flag is set, override any user-choice, but allow filters.
if ( ! empty ( $item -> disable_autoupdate ) ) {
2024-06-02 23:35:12 +02:00
$update = false ;
2020-07-31 19:03:05 +02:00
}
2016-05-10 13:45:42 +02:00
/**
2016-05-22 20:01:30 +02:00
* Filters whether to automatically update core , a plugin , a theme , or a language .
2016-05-10 13:45:42 +02:00
*
* The dynamic portion of the hook name , `$type` , refers to the type of update
2021-03-07 13:32:09 +01:00
* being checked .
*
* Possible hook names include :
2020-08-07 18:14:03 +02:00
*
* - `auto_update_core`
* - `auto_update_plugin`
* - `auto_update_theme`
* - `auto_update_translation`
2016-05-10 13:45:42 +02:00
*
2021-11-19 15:19:59 +01:00
* Since WordPress 3.7 , minor and development versions of core , and translations have
* been auto - updated by default . New installs on WordPress 5.6 or higher will also
* auto - update major versions by default . Starting in 5.6 , older sites can opt - in to
* major version auto - updates , and auto - updates for plugins and themes .
2016-05-10 13:45:42 +02:00
*
2018-03-11 11:30:33 +01:00
* See the { @ see 'allow_dev_auto_core_updates' }, { @ see 'allow_minor_auto_core_updates' },
2016-05-10 13:45:42 +02:00
* and { @ see 'allow_major_auto_core_updates' } filters for a more straightforward way to
* adjust core updates .
*
* @ since 3.7 . 0
2020-08-31 15:20:07 +02:00
* @ since 5.5 . 0 The `$update` parameter accepts the value of null .
2016-05-10 13:45:42 +02:00
*
2020-08-31 15:20:07 +02:00
* @ param bool | null $update Whether to update . The value of null is internally used
* to detect whether nothing has hooked into this filter .
* @ param object $item The update offer .
2016-05-10 13:45:42 +02:00
*/
2016-08-22 20:25:31 +02:00
$update = apply_filters ( " auto_update_ { $type } " , $update , $item );
2016-05-10 13:45:42 +02:00
if ( ! $update ) {
2020-05-16 20:42:12 +02:00
if ( 'core' === $type ) {
2016-05-10 13:45:42 +02:00
$this -> send_core_update_notification_email ( $item );
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
return false ;
}
// If it's a core update, are we actually compatible with its requirements?
2020-05-16 20:42:12 +02:00
if ( 'core' === $type ) {
2016-05-10 13:45:42 +02:00
global $wpdb ;
2022-05-20 19:38:14 +02:00
$php_compat = version_compare ( PHP_VERSION , $item -> php_version , '>=' );
2017-12-01 00:11:00 +01:00
if ( file_exists ( WP_CONTENT_DIR . '/db.php' ) && empty ( $wpdb -> is_mysql ) ) {
2016-05-10 13:45:42 +02:00
$mysql_compat = true ;
2017-12-01 00:11:00 +01:00
} else {
2016-05-10 13:45:42 +02:00
$mysql_compat = version_compare ( $wpdb -> db_version (), $item -> mysql_version , '>=' );
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2017-12-01 00:11:00 +01:00
if ( ! $php_compat || ! $mysql_compat ) {
2016-05-10 13:45:42 +02:00
return false ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
}
2020-06-17 16:48:07 +02:00
// If updating a plugin or theme, ensure the minimum PHP version requirements are satisfied.
if ( in_array ( $type , array ( 'plugin' , 'theme' ), true ) ) {
2022-05-20 19:38:14 +02:00
if ( ! empty ( $item -> requires_php ) && version_compare ( PHP_VERSION , $item -> requires_php , '<' ) ) {
2019-04-12 16:02:53 +02:00
return false ;
}
}
2016-05-10 13:45:42 +02:00
return true ;
}
/**
* Notifies an administrator of a core update .
*
* @ since 3.7 . 0
*
* @ param object $item The update offer .
2020-09-27 10:36:06 +02:00
* @ return bool True if the site administrator is notified of a core update ,
* false otherwise .
2016-05-10 13:45:42 +02:00
*/
protected function send_core_update_notification_email ( $item ) {
$notified = get_site_option ( 'auto_core_update_notified' );
// Don't notify if we've already notified the same email address of the same version.
2021-04-15 12:31:08 +02:00
if ( $notified
&& get_site_option ( 'admin_email' ) === $notified [ 'email' ]
2021-04-16 14:01:15 +02:00
&& $notified [ 'version' ] === $item -> current
2021-04-15 12:31:08 +02:00
) {
2016-05-10 13:45:42 +02:00
return false ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
// See if we need to notify users of a core update.
$notify = ! empty ( $item -> notify_email );
/**
2016-05-22 20:01:30 +02:00
* Filters whether to notify the site administrator of a new core update .
2016-05-10 13:45:42 +02:00
*
* By default , administrators are notified when the update offer received
* from WordPress . org sets a particular flag . This allows some discretion
* in if and when to notify .
*
* This filter is only evaluated once per release . If the same email address
* was already notified of the same new version , WordPress won ' t repeatedly
* email the administrator .
*
* This filter is also used on about . php to check if a plugin has disabled
* these notifications .
*
* @ since 3.7 . 0
*
* @ param bool $notify Whether the site administrator is notified .
* @ param object $item The update offer .
*/
2017-12-01 00:11:00 +01:00
if ( ! apply_filters ( 'send_core_update_notification_email' , $notify , $item ) ) {
2016-05-10 13:45:42 +02:00
return false ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
$this -> send_email ( 'manual' , $item );
return true ;
}
/**
2022-04-04 22:53:01 +02:00
* Updates an item , if appropriate .
2016-05-10 13:45:42 +02:00
*
* @ since 3.7 . 0
*
* @ param string $type The type of update being checked : 'core' , 'theme' , 'plugin' , 'translation' .
* @ param object $item The update offer .
* @ return null | WP_Error
*/
public function update ( $type , $item ) {
2022-11-29 16:51:14 +01:00
$skin = new Automatic_Upgrader_Skin ();
2016-05-10 13:45:42 +02:00
switch ( $type ) {
case 'core' :
// The Core upgrader doesn't use the Upgrader's skin during the actual main part of the upgrade, instead, firing a filter.
add_filter ( 'update_feedback' , array ( $skin , 'feedback' ) );
$upgrader = new Core_Upgrader ( $skin );
$context = ABSPATH ;
break ;
case 'plugin' :
$upgrader = new Plugin_Upgrader ( $skin );
2020-01-29 01:45:18 +01:00
$context = WP_PLUGIN_DIR ; // We don't support custom Plugin directories, or updates for WPMU_PLUGIN_DIR.
2016-05-10 13:45:42 +02:00
break ;
case 'theme' :
$upgrader = new Theme_Upgrader ( $skin );
$context = get_theme_root ( $item -> theme );
break ;
case 'translation' :
$upgrader = new Language_Pack_Upgrader ( $skin );
$context = WP_CONTENT_DIR ; // WP_LANG_DIR;
break ;
}
// Determine whether we can and should perform this update.
2017-12-01 00:11:00 +01:00
if ( ! $this -> should_update ( $type , $item , $context ) ) {
2016-05-10 13:45:42 +02:00
return false ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
/**
* Fires immediately prior to an auto - update .
*
* @ since 4.4 . 0
*
* @ param string $type The type of update being checked : 'core' , 'theme' , 'plugin' , or 'translation' .
* @ param object $item The update offer .
* @ param string $context The filesystem context ( a path ) against which filesystem access and status
* should be checked .
*/
do_action ( 'pre_auto_update' , $type , $item , $context );
$upgrader_item = $item ;
switch ( $type ) {
case 'core' :
2019-09-03 02:41:05 +02:00
/* translators: %s: WordPress version. */
2016-05-10 13:45:42 +02:00
$skin -> feedback ( __ ( 'Updating to WordPress %s' ), $item -> version );
2019-09-03 02:41:05 +02:00
/* translators: %s: WordPress version. */
2016-05-10 13:45:42 +02:00
$item_name = sprintf ( __ ( 'WordPress %s' ), $item -> version );
break ;
case 'theme' :
$upgrader_item = $item -> theme ;
2017-12-01 00:11:00 +01:00
$theme = wp_get_theme ( $upgrader_item );
$item_name = $theme -> Get ( 'Name' );
2020-10-20 19:41:07 +02:00
// Add the current version so that it can be reported in the notification email.
$item -> current_version = $theme -> get ( 'Version' );
if ( empty ( $item -> current_version ) ) {
$item -> current_version = false ;
}
2019-09-03 02:41:05 +02:00
/* translators: %s: Theme name. */
2016-05-10 13:45:42 +02:00
$skin -> feedback ( __ ( 'Updating theme: %s' ), $item_name );
break ;
case 'plugin' :
$upgrader_item = $item -> plugin ;
2017-12-01 00:11:00 +01:00
$plugin_data = get_plugin_data ( $context . '/' . $upgrader_item );
$item_name = $plugin_data [ 'Name' ];
2020-10-20 19:41:07 +02:00
// Add the current version so that it can be reported in the notification email.
$item -> current_version = $plugin_data [ 'Version' ];
if ( empty ( $item -> current_version ) ) {
$item -> current_version = false ;
}
2019-09-03 02:41:05 +02:00
/* translators: %s: Plugin name. */
2016-05-10 13:45:42 +02:00
$skin -> feedback ( __ ( 'Updating plugin: %s' ), $item_name );
break ;
case 'translation' :
$language_item_name = $upgrader -> get_name_for_update ( $item );
2019-09-03 02:41:05 +02:00
/* translators: %s: Project name (plugin, theme, or WordPress). */
2018-08-30 15:36:25 +02:00
$item_name = sprintf ( __ ( 'Translations for %s' ), $language_item_name );
2019-09-03 02:41:05 +02:00
/* translators: 1: Project name (plugin, theme, or WordPress), 2: Language. */
2016-05-10 13:45:42 +02:00
$skin -> feedback ( sprintf ( __ ( 'Updating translations for %1$s (%2$s)…' ), $language_item_name , $item -> language ) );
break ;
}
$allow_relaxed_file_ownership = false ;
2020-05-16 20:42:12 +02:00
if ( 'core' === $type && isset ( $item -> new_files ) && ! $item -> new_files ) {
2016-05-10 13:45:42 +02:00
$allow_relaxed_file_ownership = true ;
}
2024-05-13 17:24:11 +02:00
$is_debug = WP_DEBUG && WP_DEBUG_LOG ;
2024-05-10 13:48:15 +02:00
if ( 'plugin' === $type ) {
$was_active = is_plugin_active ( $upgrader_item );
2024-05-13 17:24:11 +02:00
if ( $is_debug ) {
error_log ( ' Upgrading plugin ' . var_export ( $item -> slug , true ) . '...' );
}
2024-05-10 13:48:15 +02:00
}
2024-05-13 17:24:11 +02:00
if ( 'theme' === $type && $is_debug ) {
2024-05-10 13:48:15 +02:00
error_log ( ' Upgrading theme ' . var_export ( $item -> theme , true ) . '...' );
}
/*
* Enable maintenance mode before upgrading the plugin or theme .
*
* This avoids potential non - fatal errors being detected
* while scraping for a fatal error if some files are still
* being moved .
*
* While these checks are intended only for plugins ,
* maintenance mode is enabled for all upgrade types as any
* update could contain an error or warning , which could cause
* the scrape to miss a fatal error in the plugin update .
*/
2024-06-03 23:25:10 +02:00
if ( 'translation' !== $type ) {
$upgrader -> maintenance_mode ( true );
}
2024-05-10 13:48:15 +02:00
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
// Boom, this site's about to get a whole new splash of paint!
2017-12-01 00:11:00 +01:00
$upgrade_result = $upgrader -> upgrade (
2018-08-17 03:51:36 +02:00
$upgrader_item ,
array (
2017-12-01 00:11:00 +01:00
'clear_update_cache' => false ,
// Always use partial builds if possible for core updates.
'pre_check_md5' => false ,
// Only available for core updates.
'attempt_rollback' => true ,
2020-01-29 01:45:18 +01:00
// Allow relaxed file ownership in some scenarios.
2017-12-01 00:11:00 +01:00
'allow_relaxed_file_ownership' => $allow_relaxed_file_ownership ,
)
);
2016-05-10 13:45:42 +02:00
2024-05-10 13:48:15 +02:00
/*
* After WP_Upgrader :: upgrade () completes , maintenance mode is disabled .
*
* Re - enable maintenance mode while attempting to detect fatal errors
* and potentially rolling back .
*
* This avoids errors if the site is visited while fatal errors exist
* or while files are still being moved .
*/
2024-06-03 23:25:10 +02:00
if ( 'translation' !== $type ) {
$upgrader -> maintenance_mode ( true );
}
2024-05-10 13:48:15 +02:00
2016-05-10 13:45:42 +02:00
// If the filesystem is unavailable, false is returned.
if ( false === $upgrade_result ) {
$upgrade_result = new WP_Error ( 'fs_unavailable' , __ ( 'Could not access filesystem.' ) );
}
2020-05-16 20:42:12 +02:00
if ( 'core' === $type ) {
if ( is_wp_error ( $upgrade_result )
&& ( 'up_to_date' === $upgrade_result -> get_error_code ()
|| 'locked' === $upgrade_result -> get_error_code () )
) {
2024-06-18 16:41:05 +02:00
// Allow visitors to browse the site again.
$upgrader -> maintenance_mode ( false );
2023-07-09 21:52:24 +02:00
/*
* These aren ' t actual errors , treat it as a skipped - update instead
* to avoid triggering the post - core update failure routines .
*/
2016-05-10 13:45:42 +02:00
return false ;
}
Upgrade/Install: Fix parameter count in `error` call when an automatic core upgrade fails.
During automatic core upgrades, if installation results in a `WP_Error`, the `error` method is called on the skin with the details. However, in this case, two parameters are passed to `$skin->error`, but only one is accepted. This change passes only the running `WP_Error` instance as the sole parameter to `$skin->error`.
Also, this change adds an additional error to `$upgrade_result` before finally being passed to `$skin->error`, indicating that the installation failed. This adds additional context to the failure.
Props desrosj, sainthkh, devutpol, SergeyBiryukov.
Fixes #53284.
Built from https://develop.svn.wordpress.org/trunk@52539
git-svn-id: http://core.svn.wordpress.org/trunk@52129 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-01-07 18:55:01 +01:00
// Core doesn't output this, so let's append it, so we don't get confused.
2016-05-10 13:45:42 +02:00
if ( is_wp_error ( $upgrade_result ) ) {
Upgrade/Install: Fix parameter count in `error` call when an automatic core upgrade fails.
During automatic core upgrades, if installation results in a `WP_Error`, the `error` method is called on the skin with the details. However, in this case, two parameters are passed to `$skin->error`, but only one is accepted. This change passes only the running `WP_Error` instance as the sole parameter to `$skin->error`.
Also, this change adds an additional error to `$upgrade_result` before finally being passed to `$skin->error`, indicating that the installation failed. This adds additional context to the failure.
Props desrosj, sainthkh, devutpol, SergeyBiryukov.
Fixes #53284.
Built from https://develop.svn.wordpress.org/trunk@52539
git-svn-id: http://core.svn.wordpress.org/trunk@52129 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-01-07 18:55:01 +01:00
$upgrade_result -> add ( 'installation_failed' , __ ( 'Installation failed.' ) );
$skin -> error ( $upgrade_result );
2016-05-10 13:45:42 +02:00
} else {
2020-07-23 23:08:01 +02:00
$skin -> feedback ( __ ( 'WordPress updated successfully.' ) );
2016-05-10 13:45:42 +02:00
}
}
2024-05-13 17:24:11 +02:00
$is_debug = WP_DEBUG && WP_DEBUG_LOG ;
if ( 'theme' === $type && $is_debug ) {
2024-05-10 13:48:15 +02:00
error_log ( ' Theme ' . var_export ( $item -> theme , true ) . ' has been upgraded.' );
}
if ( 'plugin' === $type ) {
2024-05-13 17:24:11 +02:00
if ( $is_debug ) {
error_log ( ' Plugin ' . var_export ( $item -> slug , true ) . ' has been upgraded.' );
if ( is_plugin_inactive ( $upgrader_item ) ) {
error_log ( ' ' . var_export ( $upgrader_item , true ) . ' is inactive and will not be checked for fatal errors.' );
}
2024-05-10 13:48:15 +02:00
}
if ( $was_active && ! is_wp_error ( $upgrade_result ) ) {
/*
* The usual time limit is five minutes . However , as a loopback request
* is about to be performed , increase the time limit to account for this .
*/
if ( function_exists ( 'set_time_limit' ) ) {
set_time_limit ( 10 * MINUTE_IN_SECONDS );
}
/*
* Avoids a race condition when there are 2 sequential plugins that have
* fatal errors . It seems a slight delay is required for the loopback to
* use the updated plugin code in the request . This can cause the second
* plugin ' s fatal error checking to be inaccurate , and may also affect
* subsequent plugin checks .
*/
sleep ( 2 );
if ( $this -> has_fatal_error () ) {
$upgrade_result = new WP_Error ();
$temp_backup = array (
array (
'dir' => 'plugins' ,
'slug' => $item -> slug ,
'src' => WP_PLUGIN_DIR ,
),
);
$backup_restored = $upgrader -> restore_temp_backup ( $temp_backup );
if ( is_wp_error ( $backup_restored ) ) {
$upgrade_result -> add (
'plugin_update_fatal_error_rollback_failed' ,
sprintf (
/* translators: %s: The plugin's slug. */
__ ( " The update for '%s' contained a fatal error. The previously installed version could not be restored. " ),
$item -> slug
)
);
$upgrade_result -> merge_from ( $backup_restored );
} else {
$upgrade_result -> add (
'plugin_update_fatal_error_rollback_successful' ,
sprintf (
/* translators: %s: The plugin's slug. */
__ ( " The update for '%s' contained a fatal error. The previously installed version has been restored. " ),
$item -> slug
)
);
$backup_deleted = $upgrader -> delete_temp_backup ( $temp_backup );
if ( is_wp_error ( $backup_deleted ) ) {
$upgrade_result -> merge_from ( $backup_deleted );
}
}
/*
* Should emails not be working , log the message ( s ) so that
* the log file contains context for the fatal error ,
* and whether a rollback was performed .
*
* `trigger_error()` is not used as it outputs a stack trace
* to this location rather than to the fatal error , which will
* appear above this entry in the log file .
*/
2024-05-13 17:24:11 +02:00
if ( $is_debug ) {
error_log ( ' ' . implode ( " \n " , $upgrade_result -> get_error_messages () ) );
}
} elseif ( $is_debug ) {
2024-05-10 13:48:15 +02:00
error_log ( ' The update for ' . var_export ( $item -> slug , true ) . ' has no fatal errors.' );
}
}
}
// All processes are complete. Allow visitors to browse the site again.
2024-06-03 23:25:10 +02:00
if ( 'translation' !== $type ) {
$upgrader -> maintenance_mode ( false );
}
2024-05-10 13:48:15 +02:00
2016-05-10 13:45:42 +02:00
$this -> update_results [ $type ][] = ( object ) array (
'item' => $item ,
'result' => $upgrade_result ,
'name' => $item_name ,
2017-12-01 00:11:00 +01:00
'messages' => $skin -> get_upgrade_messages (),
2016-05-10 13:45:42 +02:00
);
return $upgrade_result ;
}
/**
* Kicks off the background update process , looping through all pending updates .
*
* @ since 3.7 . 0
*/
public function run () {
2017-12-01 00:11:00 +01:00
if ( $this -> is_disabled () ) {
2016-05-10 13:45:42 +02:00
return ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2017-12-01 00:11:00 +01:00
if ( ! is_main_network () || ! is_main_site () ) {
2016-05-10 13:45:42 +02:00
return ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2017-12-01 00:11:00 +01:00
if ( ! WP_Upgrader :: create_lock ( 'auto_updater' ) ) {
2016-05-10 13:45:42 +02:00
return ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2024-06-03 23:39:08 +02:00
$is_debug = WP_DEBUG && WP_DEBUG_LOG ;
2024-05-13 17:24:11 +02:00
if ( $is_debug ) {
error_log ( 'Automatic updates starting...' );
}
2024-05-10 13:48:15 +02:00
2020-01-29 01:45:18 +01:00
// Don't automatically run these things, as we'll handle it ourselves.
2016-05-10 13:45:42 +02:00
remove_action ( 'upgrader_process_complete' , array ( 'Language_Pack_Upgrader' , 'async_upgrade' ), 20 );
remove_action ( 'upgrader_process_complete' , 'wp_version_check' );
remove_action ( 'upgrader_process_complete' , 'wp_update_plugins' );
remove_action ( 'upgrader_process_complete' , 'wp_update_themes' );
2020-01-29 01:45:18 +01:00
// Next, plugins.
wp_update_plugins (); // Check for plugin updates.
2016-05-10 13:45:42 +02:00
$plugin_updates = get_site_transient ( 'update_plugins' );
2017-12-01 00:11:00 +01:00
if ( $plugin_updates && ! empty ( $plugin_updates -> response ) ) {
2024-05-13 17:24:11 +02:00
if ( $is_debug ) {
error_log ( ' Automatic plugin updates starting...' );
}
2024-05-10 13:48:15 +02:00
2016-05-10 13:45:42 +02:00
foreach ( $plugin_updates -> response as $plugin ) {
$this -> update ( 'plugin' , $plugin );
}
2024-05-10 13:48:15 +02:00
2020-01-29 01:45:18 +01:00
// Force refresh of plugin update information.
2016-05-10 13:45:42 +02:00
wp_clean_plugins_cache ();
2024-05-10 13:48:15 +02:00
2024-05-13 17:24:11 +02:00
if ( $is_debug ) {
error_log ( ' Automatic plugin updates complete.' );
}
2016-05-10 13:45:42 +02:00
}
2020-01-29 01:45:18 +01:00
// Next, those themes we all love.
wp_update_themes (); // Check for theme updates.
2016-05-10 13:45:42 +02:00
$theme_updates = get_site_transient ( 'update_themes' );
2017-12-01 00:11:00 +01:00
if ( $theme_updates && ! empty ( $theme_updates -> response ) ) {
2024-05-13 17:24:11 +02:00
if ( $is_debug ) {
error_log ( ' Automatic theme updates starting...' );
}
2024-05-10 13:48:15 +02:00
2016-05-10 13:45:42 +02:00
foreach ( $theme_updates -> response as $theme ) {
$this -> update ( 'theme' , ( object ) $theme );
}
2020-01-29 01:45:18 +01:00
// Force refresh of theme update information.
2016-05-10 13:45:42 +02:00
wp_clean_themes_cache ();
2024-05-10 13:48:15 +02:00
2024-05-13 17:24:11 +02:00
if ( $is_debug ) {
error_log ( ' Automatic theme updates complete.' );
}
2016-05-10 13:45:42 +02:00
}
2024-05-13 17:24:11 +02:00
if ( $is_debug ) {
error_log ( 'Automatic updates complete.' );
}
2024-05-10 13:48:15 +02:00
2020-01-29 01:45:18 +01:00
// Next, process any core update.
wp_version_check (); // Check for core updates.
2016-05-10 13:45:42 +02:00
$core_update = find_core_auto_update ();
2017-12-01 00:11:00 +01:00
if ( $core_update ) {
2016-05-10 13:45:42 +02:00
$this -> update ( 'core' , $core_update );
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2023-07-09 21:52:24 +02:00
/*
* Clean up , and check for any pending translations .
* ( Core_Upgrader checks for core updates . )
*/
2016-05-10 13:45:42 +02:00
$theme_stats = array ();
if ( isset ( $this -> update_results [ 'theme' ] ) ) {
foreach ( $this -> update_results [ 'theme' ] as $upgrade ) {
$theme_stats [ $upgrade -> item -> theme ] = ( true === $upgrade -> result );
}
}
2020-01-29 01:45:18 +01:00
wp_update_themes ( $theme_stats ); // Check for theme updates.
2016-05-10 13:45:42 +02:00
$plugin_stats = array ();
if ( isset ( $this -> update_results [ 'plugin' ] ) ) {
foreach ( $this -> update_results [ 'plugin' ] as $upgrade ) {
$plugin_stats [ $upgrade -> item -> plugin ] = ( true === $upgrade -> result );
}
}
2020-01-29 01:45:18 +01:00
wp_update_plugins ( $plugin_stats ); // Check for plugin updates.
2016-05-10 13:45:42 +02:00
2020-01-29 01:45:18 +01:00
// Finally, process any new translations.
2016-05-10 13:45:42 +02:00
$language_updates = wp_get_translation_updates ();
if ( $language_updates ) {
foreach ( $language_updates as $update ) {
$this -> update ( 'translation' , $update );
}
2020-01-29 01:45:18 +01:00
// Clear existing caches.
2016-05-10 13:45:42 +02:00
wp_clean_update_cache ();
2020-01-29 01:45:18 +01:00
wp_version_check (); // Check for core updates.
wp_update_themes (); // Check for theme updates.
wp_update_plugins (); // Check for plugin updates.
2016-05-10 13:45:42 +02:00
}
2017-08-22 13:52:48 +02:00
// Send debugging email to admin for all development installations.
2016-05-10 13:45:42 +02:00
if ( ! empty ( $this -> update_results ) ) {
Code Modernization: Replace usage of `strpos()` with `str_contains()`.
`str_contains()` was introduced in PHP 8.0 to perform a case-sensitive check indicating if the string to search in (haystack) contains the given substring (needle).
WordPress core includes a polyfill for `str_contains()` on PHP < 8.0 as of WordPress 5.9.
This commit replaces `false !== strpos( ... )` with `str_contains()` in core files, making the code more readable and consistent, as well as better aligned with modern development practices.
Follow-up to [52039], [52040], [52326], [55703], [55710], [55987].
Props Soean, spacedmonkey, costdev, dingo_d, azaozz, mikeschroder, flixos90, peterwilsoncc, SergeyBiryukov.
Fixes #58206.
Built from https://develop.svn.wordpress.org/trunk@55988
git-svn-id: http://core.svn.wordpress.org/trunk@55500 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-06-22 16:36:26 +02:00
$development_version = str_contains ( get_bloginfo ( 'version' ), '-' );
2016-05-10 13:45:42 +02:00
/**
2016-05-22 20:01:30 +02:00
* Filters whether to send a debugging email for each automatic background update .
2016-05-10 13:45:42 +02:00
*
* @ since 3.7 . 0
*
* @ param bool $development_version By default , emails are sent if the
* install is a development version .
* Return false to avoid the email .
*/
2017-12-01 00:11:00 +01:00
if ( apply_filters ( 'automatic_updates_send_debug_email' , $development_version ) ) {
2016-05-10 13:45:42 +02:00
$this -> send_debug_email ();
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2017-12-01 00:11:00 +01:00
if ( ! empty ( $this -> update_results [ 'core' ] ) ) {
2016-05-10 13:45:42 +02:00
$this -> after_core_update ( $this -> update_results [ 'core' ][ 0 ] );
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
} elseif ( ! empty ( $this -> update_results [ 'plugin' ] ) || ! empty ( $this -> update_results [ 'theme' ] ) ) {
$this -> after_plugin_theme_update ( $this -> update_results );
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
/**
* Fires after all automatic updates have run .
*
* @ since 3.8 . 0
*
* @ param array $update_results The results of all attempted updates .
*/
do_action ( 'automatic_updates_complete' , $this -> update_results );
}
WP_Upgrader :: release_lock ( 'auto_updater' );
}
/**
2023-06-14 08:34:27 +02:00
* Checks whether to send an email and avoid processing future updates after
* attempting a core update .
2016-05-10 13:45:42 +02:00
*
2017-10-18 19:48:49 +02:00
* @ since 3.7 . 0
2016-05-10 13:45:42 +02:00
*
* @ param object $update_result The result of the core update . Includes the update offer and result .
*/
protected function after_core_update ( $update_result ) {
2016-08-31 07:49:37 +02:00
$wp_version = get_bloginfo ( 'version' );
2016-05-10 13:45:42 +02:00
$core_update = $update_result -> item ;
$result = $update_result -> result ;
if ( ! is_wp_error ( $result ) ) {
$this -> send_email ( 'success' , $core_update );
return ;
}
$error_code = $result -> get_error_code ();
2023-07-09 21:52:24 +02:00
/*
* Any of these WP_Error codes are critical failures , as in they occurred after we started to copy core files .
* We should not try to perform a background update again until there is a successful one - click update performed by the user .
*/
2016-05-10 13:45:42 +02:00
$critical = false ;
Code Modernization: Replace usage of `strpos()` with `str_contains()`.
`str_contains()` was introduced in PHP 8.0 to perform a case-sensitive check indicating if the string to search in (haystack) contains the given substring (needle).
WordPress core includes a polyfill for `str_contains()` on PHP < 8.0 as of WordPress 5.9.
This commit replaces `false !== strpos( ... )` with `str_contains()` in core files, making the code more readable and consistent, as well as better aligned with modern development practices.
Follow-up to [52039], [52040], [52326], [55703], [55710], [55987].
Props Soean, spacedmonkey, costdev, dingo_d, azaozz, mikeschroder, flixos90, peterwilsoncc, SergeyBiryukov.
Fixes #58206.
Built from https://develop.svn.wordpress.org/trunk@55988
git-svn-id: http://core.svn.wordpress.org/trunk@55500 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-06-22 16:36:26 +02:00
if ( 'disk_full' === $error_code || str_contains ( $error_code , '__copy_dir' ) ) {
2016-05-10 13:45:42 +02:00
$critical = true ;
2020-02-09 17:55:09 +01:00
} elseif ( 'rollback_was_required' === $error_code && is_wp_error ( $result -> get_error_data () -> rollback ) ) {
2016-05-10 13:45:42 +02:00
// A rollback is only critical if it failed too.
2017-12-01 00:11:00 +01:00
$critical = true ;
2016-05-10 13:45:42 +02:00
$rollback_result = $result -> get_error_data () -> rollback ;
Code Modernization: Replace usage of `strpos()` with `str_contains()`.
`str_contains()` was introduced in PHP 8.0 to perform a case-sensitive check indicating if the string to search in (haystack) contains the given substring (needle).
WordPress core includes a polyfill for `str_contains()` on PHP < 8.0 as of WordPress 5.9.
This commit replaces `false !== strpos( ... )` with `str_contains()` in core files, making the code more readable and consistent, as well as better aligned with modern development practices.
Follow-up to [52039], [52040], [52326], [55703], [55710], [55987].
Props Soean, spacedmonkey, costdev, dingo_d, azaozz, mikeschroder, flixos90, peterwilsoncc, SergeyBiryukov.
Fixes #58206.
Built from https://develop.svn.wordpress.org/trunk@55988
git-svn-id: http://core.svn.wordpress.org/trunk@55500 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-06-22 16:36:26 +02:00
} elseif ( str_contains ( $error_code , 'do_rollback' ) ) {
2016-05-10 13:45:42 +02:00
$critical = true ;
}
if ( $critical ) {
$critical_data = array (
'attempted' => $core_update -> current ,
'current' => $wp_version ,
'error_code' => $error_code ,
'error_data' => $result -> get_error_data (),
'timestamp' => time (),
'critical' => true ,
);
if ( isset ( $rollback_result ) ) {
$critical_data [ 'rollback_code' ] = $rollback_result -> get_error_code ();
$critical_data [ 'rollback_data' ] = $rollback_result -> get_error_data ();
}
update_site_option ( 'auto_core_update_failed' , $critical_data );
$this -> send_email ( 'critical' , $core_update , $result );
return ;
}
/*
* Any other WP_Error code ( like download_failed or files_not_writable ) occurs before
* we tried to copy over core files . Thus , the failures are early and graceful .
*
* We should avoid trying to perform a background update again for the same version .
* But we can try again if another version is released .
*
* For certain 'transient' failures , like download_failed , we should allow retries .
* In fact , let 's schedule a special update for an hour from now. (It' s possible
* the issue could actually be on WordPress . org ' s side . ) If that one fails , then email .
*/
2017-12-01 00:11:00 +01:00
$send = true ;
$transient_failures = array ( 'incompatible_archive' , 'download_failed' , 'insane_distro' , 'locked' );
2020-04-05 05:02:11 +02:00
if ( in_array ( $error_code , $transient_failures , true ) && ! get_site_option ( 'auto_core_update_failed' ) ) {
2017-12-01 00:11:00 +01:00
wp_schedule_single_event ( time () + HOUR_IN_SECONDS , 'wp_maybe_auto_update' );
$send = false ;
}
2021-04-15 12:31:08 +02:00
$notified = get_site_option ( 'auto_core_update_notified' );
2016-05-10 13:45:42 +02:00
// Don't notify if we've already notified the same email address of the same version of the same notification type.
2021-04-15 12:31:08 +02:00
if ( $notified
&& 'fail' === $notified [ 'type' ]
&& get_site_option ( 'admin_email' ) === $notified [ 'email' ]
2021-04-16 14:01:15 +02:00
&& $notified [ 'version' ] === $core_update -> current
2021-04-15 12:31:08 +02:00
) {
2016-05-10 13:45:42 +02:00
$send = false ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2017-12-01 00:11:00 +01:00
update_site_option (
2018-08-17 03:51:36 +02:00
'auto_core_update_failed' ,
array (
2017-12-01 00:11:00 +01:00
'attempted' => $core_update -> current ,
'current' => $wp_version ,
'error_code' => $error_code ,
'error_data' => $result -> get_error_data (),
'timestamp' => time (),
2020-04-05 05:02:11 +02:00
'retry' => in_array ( $error_code , $transient_failures , true ),
2017-12-01 00:11:00 +01:00
)
);
2016-05-10 13:45:42 +02:00
2017-12-01 00:11:00 +01:00
if ( $send ) {
2016-05-10 13:45:42 +02:00
$this -> send_email ( 'fail' , $core_update , $result );
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
}
/**
* Sends an email upon the completion or failure of a background core update .
*
* @ since 3.7 . 0
*
* @ param string $type The type of email to send . Can be one of 'success' , 'fail' , 'manual' , 'critical' .
* @ param object $core_update The update offer that was attempted .
* @ param mixed $result Optional . The result for the core update . Can be WP_Error .
*/
protected function send_email ( $type , $core_update , $result = null ) {
2017-12-01 00:11:00 +01:00
update_site_option (
2018-08-17 03:51:36 +02:00
'auto_core_update_notified' ,
array (
2017-12-01 00:11:00 +01:00
'type' => $type ,
'email' => get_site_option ( 'admin_email' ),
'version' => $core_update -> current ,
'timestamp' => time (),
)
);
2016-05-10 13:45:42 +02:00
$next_user_core_update = get_preferred_from_update_core ();
2020-05-16 20:42:12 +02:00
2020-01-29 01:45:18 +01:00
// If the update transient is empty, use the update we just performed.
2017-12-01 00:11:00 +01:00
if ( ! $next_user_core_update ) {
2016-05-10 13:45:42 +02:00
$next_user_core_update = $core_update ;
2017-12-01 00:11:00 +01:00
}
2020-05-16 20:42:12 +02:00
2021-04-16 14:01:15 +02:00
if ( 'upgrade' === $next_user_core_update -> response
&& version_compare ( $next_user_core_update -> version , $core_update -> version , '>' )
) {
$newer_version_available = true ;
} else {
$newer_version_available = false ;
}
2016-05-10 13:45:42 +02:00
/**
2016-05-22 20:01:30 +02:00
* Filters whether to send an email following an automatic background core update .
2016-05-10 13:45:42 +02:00
*
* @ since 3.7 . 0
*
* @ param bool $send Whether to send the email . Default true .
* @ param string $type The type of email to send . Can be one of
* 'success' , 'fail' , 'critical' .
* @ param object $core_update The update offer that was attempted .
* @ param mixed $result The result for the core update . Can be WP_Error .
*/
2017-12-01 00:11:00 +01:00
if ( 'manual' !== $type && ! apply_filters ( 'auto_core_update_send_email' , true , $type , $core_update , $result ) ) {
2016-05-10 13:45:42 +02:00
return ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
switch ( $type ) {
2017-12-01 00:11:00 +01:00
case 'success' : // We updated.
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
/* translators: Site updated notification email subject. 1: Site title, 2: WordPress version. */
2016-05-10 13:45:42 +02:00
$subject = __ ( '[%1$s] Your site has updated to WordPress %2$s' );
break ;
2017-12-01 00:11:00 +01:00
case 'fail' : // We tried to update but couldn't.
case 'manual' : // We can't update (and made no attempt).
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
/* translators: Update available notification email subject. 1: Site title, 2: WordPress version. */
2016-05-10 13:45:42 +02:00
$subject = __ ( '[%1$s] WordPress %2$s is available. Please update!' );
break ;
2017-12-01 00:11:00 +01:00
case 'critical' : // We tried to update, started to copy files, then things went wrong.
2019-04-16 00:39:50 +02:00
/* translators: Site down notification email subject. 1: Site title. */
2016-05-10 13:45:42 +02:00
$subject = __ ( '[%1$s] URGENT: Your site may be down due to a failed update' );
break ;
2017-12-01 00:11:00 +01:00
default :
2016-05-10 13:45:42 +02:00
return ;
}
2020-07-06 21:15:03 +02:00
// If the auto-update is not to the latest version, say that the current version of WP is available instead.
2016-05-10 13:45:42 +02:00
$version = 'success' === $type ? $core_update -> current : $next_user_core_update -> current ;
$subject = sprintf ( $subject , wp_specialchars_decode ( get_option ( 'blogname' ), ENT_QUOTES ), $version );
$body = '' ;
switch ( $type ) {
2017-12-01 00:11:00 +01:00
case 'success' :
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
$body .= sprintf (
2019-09-03 02:41:05 +02:00
/* translators: 1: Home URL, 2: WordPress version. */
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
__ ( 'Howdy! Your site at %1$s has been updated automatically to WordPress %2$s.' ),
home_url (),
$core_update -> current
);
2016-05-10 13:45:42 +02:00
$body .= " \n \n " ;
2017-12-01 00:11:00 +01:00
if ( ! $newer_version_available ) {
2016-05-10 13:45:42 +02:00
$body .= __ ( 'No further action is needed on your part.' ) . ' ' ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
// Can only reference the About screen if their update was successful.
list ( $about_version ) = explode ( '-' , $core_update -> current , 2 );
2019-09-03 02:41:05 +02:00
/* translators: %s: WordPress version. */
2018-08-30 15:36:25 +02:00
$body .= sprintf ( __ ( 'For more on version %s, see the About WordPress screen:' ), $about_version );
$body .= " \n " . admin_url ( 'about.php' );
2016-05-10 13:45:42 +02:00
if ( $newer_version_available ) {
2019-09-03 02:41:05 +02:00
/* translators: %s: WordPress latest version. */
2016-05-10 13:45:42 +02:00
$body .= " \n \n " . sprintf ( __ ( 'WordPress %s is also now available.' ), $next_user_core_update -> current ) . ' ' ;
$body .= __ ( 'Updating is easy and only takes a few moments:' );
$body .= " \n " . network_admin_url ( 'update-core.php' );
}
break ;
2017-12-01 00:11:00 +01:00
case 'fail' :
case 'manual' :
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
$body .= sprintf (
2019-09-03 02:41:05 +02:00
/* translators: 1: Home URL, 2: WordPress version. */
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
__ ( 'Please update your site at %1$s to WordPress %2$s.' ),
home_url (),
$next_user_core_update -> current
);
2016-05-10 13:45:42 +02:00
$body .= " \n \n " ;
2023-07-09 21:52:24 +02:00
/*
* Don ' t show this message if there is a newer version available .
* Potential for confusion , and also not useful for them to know at this point .
*/
2020-05-16 20:42:12 +02:00
if ( 'fail' === $type && ! $newer_version_available ) {
Administration: Remove self-reference ("we") in WordPress Admin.
This changes updates many strings to remove self-references to an undefined "we" collective across the WordPress Administration.
The goal of this change is to better match the guidelines and recommendations set forth in the make/core handbook, specifically:
> the word "we" should be avoided (…) unless its made very clear which group is speaking.
Props johnbillion, shital-patel, audrasjb, marybaum, SergeyBiryukov, peterwilsoncc, johnjamesjacoby, kebbet, costdev, chaion07, davidbaumwald.
Fixes #46057.
Built from https://develop.svn.wordpress.org/trunk@53131
git-svn-id: http://core.svn.wordpress.org/trunk@52720 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-11 13:42:04 +02:00
$body .= __ ( 'An attempt was made, but your site could not be updated automatically.' ) . ' ' ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
$body .= __ ( 'Updating is easy and only takes a few moments:' );
$body .= " \n " . network_admin_url ( 'update-core.php' );
break ;
2017-12-01 00:11:00 +01:00
case 'critical' :
if ( $newer_version_available ) {
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
$body .= sprintf (
2019-09-03 02:41:05 +02:00
/* translators: 1: Home URL, 2: WordPress version. */
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
__ ( 'Your site at %1$s experienced a critical failure while trying to update WordPress to version %2$s.' ),
home_url (),
$core_update -> current
);
2017-12-01 00:11:00 +01:00
} else {
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
$body .= sprintf (
2019-09-03 02:41:05 +02:00
/* translators: 1: Home URL, 2: WordPress latest version. */
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
__ ( 'Your site at %1$s experienced a critical failure while trying to update to the latest version of WordPress, %2$s.' ),
home_url (),
$core_update -> current
);
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
$body .= " \n \n " . __ ( " This means your site may be offline or broken. Don't panic; this can be fixed. " );
$body .= " \n \n " . __ ( " Please check out your site now. It's possible that everything is working. If it says you need to update, you should do so: " );
$body .= " \n " . network_admin_url ( 'update-core.php' );
break ;
}
$critical_support = 'critical' === $type && ! empty ( $core_update -> support_email );
if ( $critical_support ) {
// Support offer if available.
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
$body .= " \n \n " . sprintf (
2019-09-03 02:41:05 +02:00
/* translators: %s: Support email address. */
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
__ ( 'The WordPress team is willing to help you. Forward this email to %s and the team will work with you to make sure your site is working.' ),
$core_update -> support_email
);
2016-05-10 13:45:42 +02:00
} else {
// Add a note about the support forums.
$body .= " \n \n " . __ ( 'If you experience any issues or need support, the volunteers in the WordPress.org support forums may be able to help.' );
2019-05-25 16:24:50 +02:00
$body .= " \n " . __ ( 'https://wordpress.org/support/forums/' );
2016-05-10 13:45:42 +02:00
}
// Updates are important!
2020-02-09 17:55:09 +01:00
if ( 'success' !== $type || $newer_version_available ) {
2016-05-10 13:45:42 +02:00
$body .= " \n \n " . __ ( 'Keeping your site updated is important for security. It also makes the internet a safer place for you and your readers.' );
}
if ( $critical_support ) {
2022-09-19 10:59:11 +02:00
$body .= ' ' . __ ( " Reach out to WordPress Core developers to ensure you'll never have this problem again. " );
2016-05-10 13:45:42 +02:00
}
// If things are successful and we're now on the latest, mention plugins and themes if any are out of date.
2020-02-09 17:55:09 +01:00
if ( 'success' === $type && ! $newer_version_available && ( get_plugin_updates () || get_theme_updates () ) ) {
2016-05-10 13:45:42 +02:00
$body .= " \n \n " . __ ( 'You also have some plugins or themes with updates available. Update them now:' );
$body .= " \n " . network_admin_url ();
}
$body .= " \n \n " . __ ( 'The WordPress Team' ) . " \n " ;
2020-05-16 20:42:12 +02:00
if ( 'critical' === $type && is_wp_error ( $result ) ) {
2016-05-10 13:45:42 +02:00
$body .= " \n *** \n \n " ;
2019-09-03 02:41:05 +02:00
/* translators: %s: WordPress version. */
2016-08-31 07:49:37 +02:00
$body .= sprintf ( __ ( 'Your site was running version %s.' ), get_bloginfo ( 'version' ) );
Administration: Remove self-reference ("we") in WordPress Admin.
This changes updates many strings to remove self-references to an undefined "we" collective across the WordPress Administration.
The goal of this change is to better match the guidelines and recommendations set forth in the make/core handbook, specifically:
> the word "we" should be avoided (…) unless its made very clear which group is speaking.
Props johnbillion, shital-patel, audrasjb, marybaum, SergeyBiryukov, peterwilsoncc, johnjamesjacoby, kebbet, costdev, chaion07, davidbaumwald.
Fixes #46057.
Built from https://develop.svn.wordpress.org/trunk@53131
git-svn-id: http://core.svn.wordpress.org/trunk@52720 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-11 13:42:04 +02:00
$body .= ' ' . __ ( 'Some data that describes the error your site encountered has been put together.' );
2016-05-10 13:45:42 +02:00
$body .= ' ' . __ ( 'Your hosting company, support forum volunteers, or a friendly developer may be able to use this information to help you:' );
2023-07-09 21:52:24 +02:00
/*
* If we had a rollback and we ' re still critical , then the rollback failed too .
* Loop through all errors ( the main WP_Error , the update result , the rollback result ) for code , data , etc .
*/
2020-05-16 20:42:12 +02:00
if ( 'rollback_was_required' === $result -> get_error_code () ) {
2016-05-10 13:45:42 +02:00
$errors = array ( $result , $result -> get_error_data () -> update , $result -> get_error_data () -> rollback );
2017-12-01 00:11:00 +01:00
} else {
2016-05-10 13:45:42 +02:00
$errors = array ( $result );
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
foreach ( $errors as $error ) {
2017-12-01 00:11:00 +01:00
if ( ! is_wp_error ( $error ) ) {
2016-05-10 13:45:42 +02:00
continue ;
2017-12-01 00:11:00 +01:00
}
2020-05-16 20:42:12 +02:00
2016-05-10 13:45:42 +02:00
$error_code = $error -> get_error_code ();
2019-09-03 02:41:05 +02:00
/* translators: %s: Error code. */
2018-08-30 15:36:25 +02:00
$body .= " \n \n " . sprintf ( __ ( 'Error code: %s' ), $error_code );
2020-05-16 20:42:12 +02:00
if ( 'rollback_was_required' === $error_code ) {
2016-05-10 13:45:42 +02:00
continue ;
2017-12-01 00:11:00 +01:00
}
2020-05-16 20:42:12 +02:00
2017-12-01 00:11:00 +01:00
if ( $error -> get_error_message () ) {
2016-05-10 13:45:42 +02:00
$body .= " \n " . $error -> get_error_message ();
2017-12-01 00:11:00 +01:00
}
2020-05-16 20:42:12 +02:00
2016-05-10 13:45:42 +02:00
$error_data = $error -> get_error_data ();
2017-12-01 00:11:00 +01:00
if ( $error_data ) {
2016-05-10 13:45:42 +02:00
$body .= " \n " . implode ( ', ' , ( array ) $error_data );
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
}
2020-05-16 20:42:12 +02:00
2016-05-10 13:45:42 +02:00
$body .= " \n " ;
}
2017-12-01 00:11:00 +01:00
$to = get_site_option ( 'admin_email' );
2016-05-10 13:45:42 +02:00
$headers = '' ;
$email = compact ( 'to' , 'subject' , 'body' , 'headers' );
/**
2016-05-22 20:01:30 +02:00
* Filters the email sent following an automatic background core update .
2016-05-10 13:45:42 +02:00
*
* @ since 3.7 . 0
*
* @ param array $email {
* Array of email arguments that will be passed to wp_mail () .
*
* @ type string $to The email recipient . An array of emails
* can be returned , as handled by wp_mail () .
* @ type string $subject The email ' s subject .
* @ type string $body The email message body .
* @ type string $headers Any email headers , defaults to no headers .
* }
* @ param string $type The type of email being sent . Can be one of
* 'success' , 'fail' , 'manual' , 'critical' .
* @ param object $core_update The update offer that was attempted .
* @ param mixed $result The result for the core update . Can be WP_Error .
*/
$email = apply_filters ( 'auto_core_update_email' , $email , $type , $core_update , $result );
wp_mail ( $email [ 'to' ], wp_specialchars_decode ( $email [ 'subject' ] ), $email [ 'body' ], $email [ 'headers' ] );
}
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
/**
2023-06-14 08:34:27 +02:00
* Checks whether an email should be sent after attempting plugin or theme updates .
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
*
* @ since 5.5 . 0
*
2020-08-27 21:27:03 +02:00
* @ param array $update_results The results of update tasks .
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
*/
protected function after_plugin_theme_update ( $update_results ) {
$successful_updates = array ();
$failed_updates = array ();
2020-10-16 01:27:03 +02:00
if ( ! empty ( $update_results [ 'plugin' ] ) ) {
/**
* Filters whether to send an email following an automatic background plugin update .
*
* @ since 5.5 . 0
* @ since 5.5 . 1 Added the `$update_results` parameter .
*
* @ param bool $enabled True if plugin update notifications are enabled , false otherwise .
* @ param array $update_results The results of plugins update tasks .
*/
$notifications_enabled = apply_filters ( 'auto_plugin_update_send_email' , true , $update_results [ 'plugin' ] );
if ( $notifications_enabled ) {
foreach ( $update_results [ 'plugin' ] as $update_result ) {
if ( true === $update_result -> result ) {
$successful_updates [ 'plugin' ][] = $update_result ;
} else {
$failed_updates [ 'plugin' ][] = $update_result ;
}
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
}
}
}
2020-10-16 01:27:03 +02:00
if ( ! empty ( $update_results [ 'theme' ] ) ) {
/**
* Filters whether to send an email following an automatic background theme update .
*
* @ since 5.5 . 0
* @ since 5.5 . 1 Added the `$update_results` parameter .
*
* @ param bool $enabled True if theme update notifications are enabled , false otherwise .
* @ param array $update_results The results of theme update tasks .
*/
$notifications_enabled = apply_filters ( 'auto_theme_update_send_email' , true , $update_results [ 'theme' ] );
if ( $notifications_enabled ) {
foreach ( $update_results [ 'theme' ] as $update_result ) {
if ( true === $update_result -> result ) {
$successful_updates [ 'theme' ][] = $update_result ;
} else {
$failed_updates [ 'theme' ][] = $update_result ;
}
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
}
}
}
if ( empty ( $successful_updates ) && empty ( $failed_updates ) ) {
return ;
}
if ( empty ( $failed_updates ) ) {
$this -> send_plugin_theme_email ( 'success' , $successful_updates , $failed_updates );
} elseif ( empty ( $successful_updates ) ) {
$this -> send_plugin_theme_email ( 'fail' , $successful_updates , $failed_updates );
} else {
$this -> send_plugin_theme_email ( 'mixed' , $successful_updates , $failed_updates );
}
}
/**
* Sends an email upon the completion or failure of a plugin or theme background update .
*
* @ since 5.5 . 0
*
2020-06-20 00:17:07 +02:00
* @ param string $type The type of email to send . Can be one of 'success' , 'fail' , 'mixed' .
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
* @ param array $successful_updates A list of updates that succeeded .
* @ param array $failed_updates A list of updates that failed .
*/
protected function send_plugin_theme_email ( $type , $successful_updates , $failed_updates ) {
// No updates were attempted.
if ( empty ( $successful_updates ) && empty ( $failed_updates ) ) {
return ;
}
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
2020-07-07 21:00:02 +02:00
$unique_failures = false ;
$past_failure_emails = get_option ( 'auto_plugin_theme_update_emails' , array () );
2020-07-08 15:15:03 +02:00
/*
* When only failures have occurred , an email should only be sent if there are unique failures .
* A failure is considered unique if an email has not been sent for an update attempt failure
* to a plugin or theme with the same new_version .
*/
2020-07-07 21:00:02 +02:00
if ( 'fail' === $type ) {
foreach ( $failed_updates as $update_type => $failures ) {
foreach ( $failures as $failed_update ) {
if ( ! isset ( $past_failure_emails [ $failed_update -> item -> { $update_type } ] ) ) {
$unique_failures = true ;
continue ;
}
// Check that the failure represents a new failure based on the new_version.
if ( version_compare ( $past_failure_emails [ $failed_update -> item -> { $update_type } ], $failed_update -> item -> new_version , '<' ) ) {
$unique_failures = true ;
}
}
}
if ( ! $unique_failures ) {
return ;
}
}
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
$body = array ();
$successful_plugins = ( ! empty ( $successful_updates [ 'plugin' ] ) );
$successful_themes = ( ! empty ( $successful_updates [ 'theme' ] ) );
$failed_plugins = ( ! empty ( $failed_updates [ 'plugin' ] ) );
$failed_themes = ( ! empty ( $failed_updates [ 'theme' ] ) );
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
switch ( $type ) {
case 'success' :
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
if ( $successful_plugins && $successful_themes ) {
/* translators: %s: Site title. */
$subject = __ ( '[%s] Some plugins and themes have automatically updated' );
$body [] = sprintf (
/* translators: %s: Home URL. */
__ ( 'Howdy! Some plugins and themes have automatically updated to their latest versions on your site at %s. No further action is needed on your part.' ),
home_url ()
);
} elseif ( $successful_plugins ) {
/* translators: %s: Site title. */
$subject = __ ( '[%s] Some plugins were automatically updated' );
$body [] = sprintf (
/* translators: %s: Home URL. */
__ ( 'Howdy! Some plugins have automatically updated to their latest versions on your site at %s. No further action is needed on your part.' ),
home_url ()
);
} else {
/* translators: %s: Site title. */
$subject = __ ( '[%s] Some themes were automatically updated' );
$body [] = sprintf (
/* translators: %s: Home URL. */
__ ( 'Howdy! Some themes have automatically updated to their latest versions on your site at %s. No further action is needed on your part.' ),
home_url ()
);
}
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
break ;
case 'fail' :
case 'mixed' :
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
if ( $failed_plugins && $failed_themes ) {
/* translators: %s: Site title. */
$subject = __ ( '[%s] Some plugins and themes have failed to update' );
$body [] = sprintf (
/* translators: %s: Home URL. */
__ ( 'Howdy! Plugins and themes failed to update on your site at %s.' ),
home_url ()
);
} elseif ( $failed_plugins ) {
/* translators: %s: Site title. */
$subject = __ ( '[%s] Some plugins have failed to update' );
$body [] = sprintf (
/* translators: %s: Home URL. */
__ ( 'Howdy! Plugins failed to update on your site at %s.' ),
home_url ()
);
} else {
/* translators: %s: Site title. */
$subject = __ ( '[%s] Some themes have failed to update' );
$body [] = sprintf (
/* translators: %s: Home URL. */
__ ( 'Howdy! Themes failed to update on your site at %s.' ),
home_url ()
);
}
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
break ;
}
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
if ( in_array ( $type , array ( 'fail' , 'mixed' ), true ) ) {
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
$body [] = " \n " ;
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
$body [] = __ ( 'Please check your site now. It’ s possible that everything is working. If there are updates available, you should update.' );
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
$body [] = " \n " ;
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
// List failed plugin updates.
if ( ! empty ( $failed_updates [ 'plugin' ] ) ) {
2024-05-10 13:48:15 +02:00
$body [] = __ ( 'The following plugins failed to update. If there was a fatal error in the update, the previously installed version has been restored.' );
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
foreach ( $failed_updates [ 'plugin' ] as $item ) {
Upgrade/Install: Add plugin URL to the automatic update email.
For each automatic plugin update, both successful and failed, information about each plugin is included in the email upon completion of the process. This change adds the plugin URL, if known, to the information included for each plugin that was processed.
This change also adds unit tests to validate the email contents after various automatic plugin update scenarios.
Props JosVelasco, pbiron, oliverstapelfeldt, ChrisHardie, Ipstenu, dd32, peterwilsoncc, audrasjb, costdev.
Fixes #53049.
Built from https://develop.svn.wordpress.org/trunk@54212
git-svn-id: http://core.svn.wordpress.org/trunk@53771 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-19 22:28:11 +02:00
$body_message = '' ;
$item_url = '' ;
if ( ! empty ( $item -> item -> url ) ) {
$item_url = ' : ' . esc_url ( $item -> item -> url );
}
2020-10-20 19:41:07 +02:00
if ( $item -> item -> current_version ) {
Upgrade/Install: Add plugin URL to the automatic update email.
For each automatic plugin update, both successful and failed, information about each plugin is included in the email upon completion of the process. This change adds the plugin URL, if known, to the information included for each plugin that was processed.
This change also adds unit tests to validate the email contents after various automatic plugin update scenarios.
Props JosVelasco, pbiron, oliverstapelfeldt, ChrisHardie, Ipstenu, dd32, peterwilsoncc, audrasjb, costdev.
Fixes #53049.
Built from https://develop.svn.wordpress.org/trunk@54212
git-svn-id: http://core.svn.wordpress.org/trunk@53771 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-19 22:28:11 +02:00
$body_message .= sprintf (
/* translators: 1: Plugin name, 2: Current version number, 3: New version number, 4: Plugin URL. */
__ ( '- %1$s (from version %2$s to %3$s)%4$s' ),
2023-02-23 11:07:26 +01:00
html_entity_decode ( $item -> name ),
2020-10-20 19:41:07 +02:00
$item -> item -> current_version ,
Upgrade/Install: Add plugin URL to the automatic update email.
For each automatic plugin update, both successful and failed, information about each plugin is included in the email upon completion of the process. This change adds the plugin URL, if known, to the information included for each plugin that was processed.
This change also adds unit tests to validate the email contents after various automatic plugin update scenarios.
Props JosVelasco, pbiron, oliverstapelfeldt, ChrisHardie, Ipstenu, dd32, peterwilsoncc, audrasjb, costdev.
Fixes #53049.
Built from https://develop.svn.wordpress.org/trunk@54212
git-svn-id: http://core.svn.wordpress.org/trunk@53771 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-19 22:28:11 +02:00
$item -> item -> new_version ,
$item_url
2020-10-20 19:41:07 +02:00
);
} else {
Upgrade/Install: Add plugin URL to the automatic update email.
For each automatic plugin update, both successful and failed, information about each plugin is included in the email upon completion of the process. This change adds the plugin URL, if known, to the information included for each plugin that was processed.
This change also adds unit tests to validate the email contents after various automatic plugin update scenarios.
Props JosVelasco, pbiron, oliverstapelfeldt, ChrisHardie, Ipstenu, dd32, peterwilsoncc, audrasjb, costdev.
Fixes #53049.
Built from https://develop.svn.wordpress.org/trunk@54212
git-svn-id: http://core.svn.wordpress.org/trunk@53771 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-19 22:28:11 +02:00
$body_message .= sprintf (
/* translators: 1: Plugin name, 2: Version number, 3: Plugin URL. */
__ ( '- %1$s version %2$s%3$s' ),
2023-02-23 11:07:26 +01:00
html_entity_decode ( $item -> name ),
Upgrade/Install: Add plugin URL to the automatic update email.
For each automatic plugin update, both successful and failed, information about each plugin is included in the email upon completion of the process. This change adds the plugin URL, if known, to the information included for each plugin that was processed.
This change also adds unit tests to validate the email contents after various automatic plugin update scenarios.
Props JosVelasco, pbiron, oliverstapelfeldt, ChrisHardie, Ipstenu, dd32, peterwilsoncc, audrasjb, costdev.
Fixes #53049.
Built from https://develop.svn.wordpress.org/trunk@54212
git-svn-id: http://core.svn.wordpress.org/trunk@53771 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-19 22:28:11 +02:00
$item -> item -> new_version ,
$item_url
2020-10-20 19:41:07 +02:00
);
}
2020-07-08 15:15:03 +02:00
Upgrade/Install: Add plugin URL to the automatic update email.
For each automatic plugin update, both successful and failed, information about each plugin is included in the email upon completion of the process. This change adds the plugin URL, if known, to the information included for each plugin that was processed.
This change also adds unit tests to validate the email contents after various automatic plugin update scenarios.
Props JosVelasco, pbiron, oliverstapelfeldt, ChrisHardie, Ipstenu, dd32, peterwilsoncc, audrasjb, costdev.
Fixes #53049.
Built from https://develop.svn.wordpress.org/trunk@54212
git-svn-id: http://core.svn.wordpress.org/trunk@53771 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-19 22:28:11 +02:00
$body [] = $body_message ;
2020-07-07 21:00:02 +02:00
$past_failure_emails [ $item -> item -> plugin ] = $item -> item -> new_version ;
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
}
2020-07-08 15:15:03 +02:00
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
$body [] = " \n " ;
}
// List failed theme updates.
if ( ! empty ( $failed_updates [ 'theme' ] ) ) {
$body [] = __ ( 'These themes failed to update:' );
foreach ( $failed_updates [ 'theme' ] as $item ) {
2020-10-20 19:41:07 +02:00
if ( $item -> item -> current_version ) {
$body [] = sprintf (
/* translators: 1: Theme name, 2: Current version number, 3: New version number. */
__ ( '- %1$s (from version %2$s to %3$s)' ),
2023-02-23 11:07:26 +01:00
html_entity_decode ( $item -> name ),
2020-10-20 19:41:07 +02:00
$item -> item -> current_version ,
$item -> item -> new_version
);
} else {
$body [] = sprintf (
/* translators: 1: Theme name, 2: Version number. */
__ ( '- %1$s version %2$s' ),
2023-02-23 11:07:26 +01:00
html_entity_decode ( $item -> name ),
2020-10-20 19:41:07 +02:00
$item -> item -> new_version
);
}
2020-07-08 15:15:03 +02:00
2020-07-07 21:00:02 +02:00
$past_failure_emails [ $item -> item -> theme ] = $item -> item -> new_version ;
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
}
2020-07-08 15:15:03 +02:00
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
$body [] = " \n " ;
}
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
}
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
// List successful updates.
if ( in_array ( $type , array ( 'success' , 'mixed' ), true ) ) {
$body [] = " \n " ;
// List successful plugin updates.
if ( ! empty ( $successful_updates [ 'plugin' ] ) ) {
$body [] = __ ( 'These plugins are now up to date:' );
foreach ( $successful_updates [ 'plugin' ] as $item ) {
Upgrade/Install: Add plugin URL to the automatic update email.
For each automatic plugin update, both successful and failed, information about each plugin is included in the email upon completion of the process. This change adds the plugin URL, if known, to the information included for each plugin that was processed.
This change also adds unit tests to validate the email contents after various automatic plugin update scenarios.
Props JosVelasco, pbiron, oliverstapelfeldt, ChrisHardie, Ipstenu, dd32, peterwilsoncc, audrasjb, costdev.
Fixes #53049.
Built from https://develop.svn.wordpress.org/trunk@54212
git-svn-id: http://core.svn.wordpress.org/trunk@53771 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-19 22:28:11 +02:00
$body_message = '' ;
$item_url = '' ;
if ( ! empty ( $item -> item -> url ) ) {
$item_url = ' : ' . esc_url ( $item -> item -> url );
}
2020-10-20 19:41:07 +02:00
if ( $item -> item -> current_version ) {
Upgrade/Install: Add plugin URL to the automatic update email.
For each automatic plugin update, both successful and failed, information about each plugin is included in the email upon completion of the process. This change adds the plugin URL, if known, to the information included for each plugin that was processed.
This change also adds unit tests to validate the email contents after various automatic plugin update scenarios.
Props JosVelasco, pbiron, oliverstapelfeldt, ChrisHardie, Ipstenu, dd32, peterwilsoncc, audrasjb, costdev.
Fixes #53049.
Built from https://develop.svn.wordpress.org/trunk@54212
git-svn-id: http://core.svn.wordpress.org/trunk@53771 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-19 22:28:11 +02:00
$body_message .= sprintf (
/* translators: 1: Plugin name, 2: Current version number, 3: New version number, 4: Plugin URL. */
__ ( '- %1$s (from version %2$s to %3$s)%4$s' ),
2023-02-23 11:07:26 +01:00
html_entity_decode ( $item -> name ),
2020-10-20 20:31:07 +02:00
$item -> item -> current_version ,
Upgrade/Install: Add plugin URL to the automatic update email.
For each automatic plugin update, both successful and failed, information about each plugin is included in the email upon completion of the process. This change adds the plugin URL, if known, to the information included for each plugin that was processed.
This change also adds unit tests to validate the email contents after various automatic plugin update scenarios.
Props JosVelasco, pbiron, oliverstapelfeldt, ChrisHardie, Ipstenu, dd32, peterwilsoncc, audrasjb, costdev.
Fixes #53049.
Built from https://develop.svn.wordpress.org/trunk@54212
git-svn-id: http://core.svn.wordpress.org/trunk@53771 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-19 22:28:11 +02:00
$item -> item -> new_version ,
$item_url
2020-10-20 20:31:07 +02:00
);
2020-10-20 19:41:07 +02:00
} else {
Upgrade/Install: Add plugin URL to the automatic update email.
For each automatic plugin update, both successful and failed, information about each plugin is included in the email upon completion of the process. This change adds the plugin URL, if known, to the information included for each plugin that was processed.
This change also adds unit tests to validate the email contents after various automatic plugin update scenarios.
Props JosVelasco, pbiron, oliverstapelfeldt, ChrisHardie, Ipstenu, dd32, peterwilsoncc, audrasjb, costdev.
Fixes #53049.
Built from https://develop.svn.wordpress.org/trunk@54212
git-svn-id: http://core.svn.wordpress.org/trunk@53771 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-19 22:28:11 +02:00
$body_message .= sprintf (
/* translators: 1: Plugin name, 2: Version number, 3: Plugin URL. */
__ ( '- %1$s version %2$s%3$s' ),
2023-02-23 11:07:26 +01:00
html_entity_decode ( $item -> name ),
Upgrade/Install: Add plugin URL to the automatic update email.
For each automatic plugin update, both successful and failed, information about each plugin is included in the email upon completion of the process. This change adds the plugin URL, if known, to the information included for each plugin that was processed.
This change also adds unit tests to validate the email contents after various automatic plugin update scenarios.
Props JosVelasco, pbiron, oliverstapelfeldt, ChrisHardie, Ipstenu, dd32, peterwilsoncc, audrasjb, costdev.
Fixes #53049.
Built from https://develop.svn.wordpress.org/trunk@54212
git-svn-id: http://core.svn.wordpress.org/trunk@53771 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-19 22:28:11 +02:00
$item -> item -> new_version ,
$item_url
2020-10-20 19:41:07 +02:00
);
}
Upgrade/Install: Add plugin URL to the automatic update email.
For each automatic plugin update, both successful and failed, information about each plugin is included in the email upon completion of the process. This change adds the plugin URL, if known, to the information included for each plugin that was processed.
This change also adds unit tests to validate the email contents after various automatic plugin update scenarios.
Props JosVelasco, pbiron, oliverstapelfeldt, ChrisHardie, Ipstenu, dd32, peterwilsoncc, audrasjb, costdev.
Fixes #53049.
Built from https://develop.svn.wordpress.org/trunk@54212
git-svn-id: http://core.svn.wordpress.org/trunk@53771 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-19 22:28:11 +02:00
$body [] = $body_message ;
2020-07-08 15:15:03 +02:00
2020-07-07 21:00:02 +02:00
unset ( $past_failure_emails [ $item -> item -> plugin ] );
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
}
2020-07-08 15:15:03 +02:00
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
$body [] = " \n " ;
}
// List successful theme updates.
if ( ! empty ( $successful_updates [ 'theme' ] ) ) {
$body [] = __ ( 'These themes are now up to date:' );
2020-07-08 15:15:03 +02:00
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
foreach ( $successful_updates [ 'theme' ] as $item ) {
2020-10-20 19:41:07 +02:00
if ( $item -> item -> current_version ) {
$body [] = sprintf (
/* translators: 1: Theme name, 2: Current version number, 3: New version number. */
__ ( '- %1$s (from version %2$s to %3$s)' ),
2023-02-23 11:07:26 +01:00
html_entity_decode ( $item -> name ),
2020-10-20 19:41:07 +02:00
$item -> item -> current_version ,
$item -> item -> new_version
);
} else {
$body [] = sprintf (
2021-04-16 14:01:15 +02:00
/* translators: 1: Theme name, 2: Version number. */
2020-10-20 19:41:07 +02:00
__ ( '- %1$s version %2$s' ),
2023-02-23 11:07:26 +01:00
html_entity_decode ( $item -> name ),
2020-10-20 19:41:07 +02:00
$item -> item -> new_version
);
}
2020-07-08 15:15:03 +02:00
2020-07-07 21:00:02 +02:00
unset ( $past_failure_emails [ $item -> item -> theme ] );
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
}
2020-07-08 15:15:03 +02:00
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
$body [] = " \n " ;
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
}
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
}
if ( $failed_plugins ) {
$body [] = sprintf (
/* translators: %s: Plugins screen URL. */
__ ( 'To manage plugins on your site, visit the Plugins page: %s' ),
admin_url ( 'plugins.php' )
);
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
$body [] = " \n " ;
}
Administration: Improve the plugin and theme auto-update emails.
This makes several improvements to the emails sent to site admins when plugin and theme auto-updates are attempted.
- Emails are now specifically tailored to the three results (success, failed, or mixed).
- Subject lines and body copy for mixed and failed results now correctly convey the importance of double checking the site in question.
- The site’s URL is now included in all emails.
- When failures occur, links to the Plugins and/or Themes pages in the admin are now included so that site owners can easily take action.
Props audrasjb, desrosj, azaozz, garrett-eclipse, paaljoachim, johnbillion, marybaum, pbiron.
Follow up to [47835].
See #50052.
Fixes #50268.
Built from https://develop.svn.wordpress.org/trunk@48123
git-svn-id: http://core.svn.wordpress.org/trunk@47892 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-22 20:18:08 +02:00
if ( $failed_themes ) {
$body [] = sprintf (
/* translators: %s: Themes screen URL. */
__ ( 'To manage themes on your site, visit the Themes page: %s' ),
admin_url ( 'themes.php' )
);
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
$body [] = " \n " ;
}
// Add a note about the support forums.
$body [] = __ ( 'If you experience any issues or need support, the volunteers in the WordPress.org support forums may be able to help.' );
$body [] = __ ( 'https://wordpress.org/support/forums/' );
$body [] = " \n " . __ ( 'The WordPress Team' );
2022-04-04 22:21:00 +02:00
if ( '' !== get_option ( 'blogname' ) ) {
$site_title = wp_specialchars_decode ( get_option ( 'blogname' ), ENT_QUOTES );
} else {
$site_title = parse_url ( home_url (), PHP_URL_HOST );
}
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
$body = implode ( " \n " , $body );
$to = get_site_option ( 'admin_email' );
2022-04-04 22:21:00 +02:00
$subject = sprintf ( $subject , $site_title );
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
$headers = '' ;
$email = compact ( 'to' , 'subject' , 'body' , 'headers' );
/**
2020-06-20 00:17:07 +02:00
* Filters the email sent following an automatic background update for plugins and themes .
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
*
2020-05-20 21:33:10 +02:00
* @ since 5.5 . 0
*
2020-06-20 00:17:07 +02:00
* @ param array $email {
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
* Array of email arguments that will be passed to wp_mail () .
*
* @ type string $to The email recipient . An array of emails
* can be returned , as handled by wp_mail () .
* @ type string $subject The email ' s subject .
* @ type string $body The email message body .
* @ type string $headers Any email headers , defaults to no headers .
* }
2020-06-20 14:14:09 +02:00
* @ param string $type The type of email being sent . Can be one of 'success' , 'fail' , 'mixed' .
* @ param array $successful_updates A list of updates that succeeded .
* @ param array $failed_updates A list of updates that failed .
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
*/
$email = apply_filters ( 'auto_plugin_theme_update_email' , $email , $type , $successful_updates , $failed_updates );
2020-05-20 21:33:10 +02:00
2020-07-07 21:00:02 +02:00
$result = wp_mail ( $email [ 'to' ], wp_specialchars_decode ( $email [ 'subject' ] ), $email [ 'body' ], $email [ 'headers' ] );
if ( $result ) {
update_option ( 'auto_plugin_theme_update_emails' , $past_failure_emails );
}
Security: Add user interface to auto-update themes and plugins.
Building on core update mechanisms, this adds the ability to enable automatic updates for themes and plugins to the WordPress admin.
Fixes: #50052.
Props: afercia, afragen, audrasjb, azaozz, bookdude13, davidperonne, desrosj, gmays, gmays, javiercasares, karmatosed, knutsp, mapk, mukesh27, netweb, nicolaskulka, nielsdeblaauw, paaljoachim, passoniate, pbiron, pedromendonca, whodunitagency, whyisjake, wpamitkumar, and xkon.
Built from https://develop.svn.wordpress.org/trunk@47835
git-svn-id: http://core.svn.wordpress.org/trunk@47611 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-05-20 20:49:09 +02:00
}
2016-05-10 13:45:42 +02:00
/**
* Prepares and sends an email of a full log of background update results , useful for debugging and geekery .
*
* @ since 3.7 . 0
*/
protected function send_debug_email () {
$update_count = 0 ;
2017-12-01 00:11:00 +01:00
foreach ( $this -> update_results as $type => $updates ) {
2016-05-10 13:45:42 +02:00
$update_count += count ( $updates );
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
2017-12-01 00:11:00 +01:00
$body = array ();
2016-05-10 13:45:42 +02:00
$failures = 0 ;
2019-09-03 02:41:05 +02:00
/* translators: %s: Network home URL. */
2016-05-10 13:45:42 +02:00
$body [] = sprintf ( __ ( 'WordPress site: %s' ), network_home_url ( '/' ) );
2020-01-29 01:45:18 +01:00
// Core.
2016-05-10 13:45:42 +02:00
if ( isset ( $this -> update_results [ 'core' ] ) ) {
$result = $this -> update_results [ 'core' ][ 0 ];
2021-04-16 14:01:15 +02:00
2016-05-10 13:45:42 +02:00
if ( $result -> result && ! is_wp_error ( $result -> result ) ) {
2019-09-03 02:41:05 +02:00
/* translators: %s: WordPress version. */
2016-05-10 13:45:42 +02:00
$body [] = sprintf ( __ ( 'SUCCESS: WordPress was successfully updated to %s' ), $result -> name );
} else {
2019-09-03 02:41:05 +02:00
/* translators: %s: WordPress version. */
2016-05-10 13:45:42 +02:00
$body [] = sprintf ( __ ( 'FAILED: WordPress failed to update to %s' ), $result -> name );
2023-09-09 11:28:26 +02:00
++ $failures ;
2016-05-10 13:45:42 +02:00
}
2021-04-16 14:01:15 +02:00
2016-05-10 13:45:42 +02:00
$body [] = '' ;
}
2020-01-29 01:45:18 +01:00
// Plugins, Themes, Translations.
2016-05-10 13:45:42 +02:00
foreach ( array ( 'plugin' , 'theme' , 'translation' ) as $type ) {
2017-12-01 00:11:00 +01:00
if ( ! isset ( $this -> update_results [ $type ] ) ) {
2016-05-10 13:45:42 +02:00
continue ;
2017-12-01 00:11:00 +01:00
}
2021-04-16 14:01:15 +02:00
2016-05-10 13:45:42 +02:00
$success_items = wp_list_filter ( $this -> update_results [ $type ], array ( 'result' => true ) );
2021-04-16 14:01:15 +02:00
2016-05-10 13:45:42 +02:00
if ( $success_items ) {
$messages = array (
'plugin' => __ ( 'The following plugins were successfully updated:' ),
'theme' => __ ( 'The following themes were successfully updated:' ),
'translation' => __ ( 'The following translations were successfully updated:' ),
);
$body [] = $messages [ $type ];
foreach ( wp_list_pluck ( $success_items , 'name' ) as $name ) {
2019-09-03 02:41:05 +02:00
/* translators: %s: Name of plugin / theme / translation. */
2016-05-10 13:45:42 +02:00
$body [] = ' * ' . sprintf ( __ ( 'SUCCESS: %s' ), $name );
}
}
2021-04-16 14:01:15 +02:00
if ( $success_items !== $this -> update_results [ $type ] ) {
2020-01-29 01:45:18 +01:00
// Failed updates.
2016-05-10 13:45:42 +02:00
$messages = array (
'plugin' => __ ( 'The following plugins failed to update:' ),
'theme' => __ ( 'The following themes failed to update:' ),
'translation' => __ ( 'The following translations failed to update:' ),
);
$body [] = $messages [ $type ];
2021-04-16 14:01:15 +02:00
2016-05-10 13:45:42 +02:00
foreach ( $this -> update_results [ $type ] as $item ) {
if ( ! $item -> result || is_wp_error ( $item -> result ) ) {
2019-09-03 02:41:05 +02:00
/* translators: %s: Name of plugin / theme / translation. */
2016-05-10 13:45:42 +02:00
$body [] = ' * ' . sprintf ( __ ( 'FAILED: %s' ), $item -> name );
2023-09-09 11:28:26 +02:00
++ $failures ;
2016-05-10 13:45:42 +02:00
}
}
}
2021-04-16 14:01:15 +02:00
2016-05-10 13:45:42 +02:00
$body [] = '' ;
}
2022-04-04 22:21:00 +02:00
if ( '' !== get_bloginfo ( 'name' ) ) {
$site_title = wp_specialchars_decode ( get_bloginfo ( 'name' ), ENT_QUOTES );
} else {
$site_title = parse_url ( home_url (), PHP_URL_HOST );
}
2021-04-16 14:01:15 +02:00
2016-05-10 13:45:42 +02:00
if ( $failures ) {
2017-12-01 00:11:00 +01:00
$body [] = trim (
__ (
" BETA TESTING?
2016-05-10 13:45:42 +02:00
=============
This debugging email is sent when you are using a development version of WordPress .
If you think these failures might be due to a bug in WordPress , could you report it ?
* Open a thread in the support forums : https :// wordpress . org / support / forum / alphabeta
* Or , if you ' re comfortable writing a bug report : https :// core . trac . wordpress . org /
2017-12-01 00:11:00 +01:00
Thanks ! -- The WordPress Team "
)
);
2016-05-10 13:45:42 +02:00
$body [] = '' ;
2019-09-03 02:41:05 +02:00
/* translators: Background update failed notification email subject. %s: Site title. */
2019-04-08 08:17:51 +02:00
$subject = sprintf ( __ ( '[%s] Background Update Failed' ), $site_title );
2016-05-10 13:45:42 +02:00
} else {
2019-09-03 02:41:05 +02:00
/* translators: Background update finished notification email subject. %s: Site title. */
2019-04-08 08:17:51 +02:00
$subject = sprintf ( __ ( '[%s] Background Update Finished' ), $site_title );
2016-05-10 13:45:42 +02:00
}
2017-12-01 00:11:00 +01:00
$body [] = trim (
__ (
' UPDATE LOG
========== '
)
);
2016-05-10 13:45:42 +02:00
$body [] = '' ;
foreach ( array ( 'core' , 'plugin' , 'theme' , 'translation' ) as $type ) {
2017-12-01 00:11:00 +01:00
if ( ! isset ( $this -> update_results [ $type ] ) ) {
2016-05-10 13:45:42 +02:00
continue ;
2017-12-01 00:11:00 +01:00
}
2021-04-16 14:01:15 +02:00
2016-05-10 13:45:42 +02:00
foreach ( $this -> update_results [ $type ] as $update ) {
$body [] = $update -> name ;
$body [] = str_repeat ( '-' , strlen ( $update -> name ) );
2021-04-16 14:01:15 +02:00
2017-12-01 00:11:00 +01:00
foreach ( $update -> messages as $message ) {
$body [] = ' ' . html_entity_decode ( str_replace ( '…' , '...' , $message ) );
}
2021-04-16 14:01:15 +02:00
2016-05-10 13:45:42 +02:00
if ( is_wp_error ( $update -> result ) ) {
$results = array ( 'update' => $update -> result );
2021-04-16 14:01:15 +02:00
2016-05-10 13:45:42 +02:00
// If we rolled back, we want to know an error that occurred then too.
2017-12-01 00:11:00 +01:00
if ( 'rollback_was_required' === $update -> result -> get_error_code () ) {
2016-05-10 13:45:42 +02:00
$results = ( array ) $update -> result -> get_error_data ();
2017-12-01 00:11:00 +01:00
}
2021-04-16 14:01:15 +02:00
2016-05-10 13:45:42 +02:00
foreach ( $results as $result_type => $result ) {
2017-12-01 00:11:00 +01:00
if ( ! is_wp_error ( $result ) ) {
2016-05-10 13:45:42 +02:00
continue ;
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
if ( 'rollback' === $result_type ) {
/* translators: 1: Error code, 2: Error message. */
$body [] = ' ' . sprintf ( __ ( 'Rollback Error: [%1$s] %2$s' ), $result -> get_error_code (), $result -> get_error_message () );
} else {
/* translators: 1: Error code, 2: Error message. */
$body [] = ' ' . sprintf ( __ ( 'Error: [%1$s] %2$s' ), $result -> get_error_code (), $result -> get_error_message () );
}
2017-12-01 00:11:00 +01:00
if ( $result -> get_error_data () ) {
2016-05-10 13:45:42 +02:00
$body [] = ' ' . implode ( ', ' , ( array ) $result -> get_error_data () );
2017-12-01 00:11:00 +01:00
}
2016-05-10 13:45:42 +02:00
}
}
2021-04-16 14:01:15 +02:00
2016-05-10 13:45:42 +02:00
$body [] = '' ;
}
}
$email = array (
'to' => get_site_option ( 'admin_email' ),
'subject' => $subject ,
'body' => implode ( " \n " , $body ),
2017-12-01 00:11:00 +01:00
'headers' => '' ,
2016-05-10 13:45:42 +02:00
);
/**
2016-05-22 20:01:30 +02:00
* Filters the debug email that can be sent following an automatic
2016-05-10 13:45:42 +02:00
* background core update .
*
* @ since 3.8 . 0
*
* @ param array $email {
* Array of email arguments that will be passed to wp_mail () .
*
* @ type string $to The email recipient . An array of emails
* can be returned , as handled by wp_mail () .
* @ type string $subject Email subject .
* @ type string $body Email message body .
* @ type string $headers Any email headers . Default empty .
* }
* @ param int $failures The number of failures encountered while upgrading .
* @ param mixed $results The results of all attempted updates .
*/
$email = apply_filters ( 'automatic_updates_debug_email' , $email , $failures , $this -> update_results );
wp_mail ( $email [ 'to' ], wp_specialchars_decode ( $email [ 'subject' ] ), $email [ 'body' ], $email [ 'headers' ] );
}
2024-05-10 13:48:15 +02:00
/**
* Performs a loopback request to check for potential fatal errors .
*
* Fatal errors cannot be detected unless maintenance mode is enabled .
*
* @ since 6.6 . 0
*
* @ global int $upgrading The Unix timestamp marking when upgrading WordPress began .
*
* @ return bool Whether a fatal error was detected .
*/
protected function has_fatal_error () {
global $upgrading ;
$maintenance_file = ABSPATH . '.maintenance' ;
if ( ! file_exists ( $maintenance_file ) ) {
return false ;
}
require $maintenance_file ;
if ( ! is_int ( $upgrading ) ) {
return false ;
}
$scrape_key = md5 ( $upgrading );
$scrape_nonce = ( string ) $upgrading ;
$transient = 'scrape_key_' . $scrape_key ;
set_transient ( $transient , $scrape_nonce , 30 );
$cookies = wp_unslash ( $_COOKIE );
$scrape_params = array (
'wp_scrape_key' => $scrape_key ,
'wp_scrape_nonce' => $scrape_nonce ,
);
$headers = array (
'Cache-Control' => 'no-cache' ,
);
/** This filter is documented in wp-includes/class-wp-http-streams.php */
$sslverify = apply_filters ( 'https_local_ssl_verify' , false );
// Include Basic auth in the loopback request.
if ( isset ( $_SERVER [ 'PHP_AUTH_USER' ] ) && isset ( $_SERVER [ 'PHP_AUTH_PW' ] ) ) {
$headers [ 'Authorization' ] = 'Basic ' . base64_encode ( wp_unslash ( $_SERVER [ 'PHP_AUTH_USER' ] ) . ':' . wp_unslash ( $_SERVER [ 'PHP_AUTH_PW' ] ) );
}
// Time to wait for loopback request to finish.
$timeout = 50 ; // 50 seconds.
2024-06-03 23:39:08 +02:00
$is_debug = WP_DEBUG && WP_DEBUG_LOG ;
2024-05-13 17:24:11 +02:00
if ( $is_debug ) {
error_log ( ' Scraping home page...' );
}
2024-05-10 13:48:15 +02:00
$needle_start = " ###### wp_scraping_result_start: $scrape_key ###### " ;
$needle_end = " ###### wp_scraping_result_end: $scrape_key ###### " ;
$url = add_query_arg ( $scrape_params , home_url ( '/' ) );
$response = wp_remote_get ( $url , compact ( 'cookies' , 'headers' , 'timeout' , 'sslverify' ) );
if ( is_wp_error ( $response ) ) {
2024-05-13 17:24:11 +02:00
if ( $is_debug ) {
error_log ( 'Loopback request failed: ' . $response -> get_error_message () );
}
2024-05-10 13:48:15 +02:00
return true ;
}
// If this outputs `true` in the log, it means there were no fatal errors detected.
2024-05-13 17:24:11 +02:00
if ( $is_debug ) {
error_log ( var_export ( substr ( $response [ 'body' ], strpos ( $response [ 'body' ], '###### wp_scraping_result_start:' ) ), true ) );
}
2024-05-10 13:48:15 +02:00
$body = wp_remote_retrieve_body ( $response );
$scrape_result_position = strpos ( $body , $needle_start );
$result = null ;
if ( false !== $scrape_result_position ) {
$error_output = substr ( $body , $scrape_result_position + strlen ( $needle_start ) );
$error_output = substr ( $error_output , 0 , strpos ( $error_output , $needle_end ) );
$result = json_decode ( trim ( $error_output ), true );
}
delete_transient ( $transient );
// Only fatal errors will result in a 'type' key.
return isset ( $result [ 'type' ] );
}
2016-05-10 13:45:42 +02:00
}