Changeset 48397 for trunk/src/wp-admin/includes/class-wp-automatic-updater.php

Timestamp:

07/07/2020 06:58:32 PM (6 years ago)

Author:

desrosj

Message:

Administration: Prevent repeat emails for identical plugin or theme auto-update attempt failures.

This change adds a throttle mechanism to plugin and theme auto-update failure emails using similar logic to the email sent for a Core auto-update.

The first time a plugin or theme auto-update fails, the package and new_version will be tracked in the auto_plugin_theme_update_emails option. An email for this specific update attempt will not be resent.

However, if this update fails again and non-repeat failures or successful updates are also present, then the failure information will be included in that email (an email needs to be sent for the new events regardless).

Props johnbillion, arpitgshah, desrosj, audrasjb, pbiron, earnjam.
Fixes #50448.

File:

• trunk/src/wp-admin/includes/class-wp-automatic-updater.php (modified) (6 diffs)

trunk/src/wp-admin/includes/class-wp-automatic-updater.php

@@ -940 +940 @@
         if ( empty( $successful_updates ) && empty( $failed_updates ) ) {
             return;
+        }
+
+        $unique_failures     = false;
+        $past_failure_emails = get_option( 'auto_plugin_theme_update_emails', array() );
+
+        // 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.
+        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;
+            }
         }
 
@@ -1018 +1044 @@
 
                 foreach ( $failed_updates['plugin'] as $item ) {
-                    $body[] = "- {$item->name}";
+                    $body[]                                     = "- {$item->name}";
+                    $past_failure_emails[ $item->item->plugin ] = $item->item->new_version;
                 }
                 $body[] = "\n";
@@ -1028 +1055 @@
 
                 foreach ( $failed_updates['theme'] as $item ) {
-                    $body[] = "- {$item->name}";
+                    $body[]                                    = "- {$item->name}";
+                    $past_failure_emails[ $item->item->theme ] = $item->item->new_version;
                 }
                 $body[] = "\n";
@@ -1044 +1072 @@
                 foreach ( $successful_updates['plugin'] as $item ) {
                     $body[] = "- {$item->name}";
+                    unset( $past_failure_emails[ $item->item->plugin ] );
                 }
                 $body[] = "\n";
@@ -1054 +1083 @@
                 foreach ( $successful_updates['theme'] as $item ) {
                     $body[] = "- {$item->name}";
+                    unset( $past_failure_emails[ $item->item->theme ] );
                 }
                 $body[] = "\n";
@@ -1109 +1139 @@
         $email = apply_filters( 'auto_plugin_theme_update_email', $email, $type, $successful_updates, $failed_updates );
 
-        wp_mail( $email['to'], wp_specialchars_decode( $email['subject'] ), $email['body'], $email['headers'] );
+        $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 );
+        }
     }