Changeset 48888

Timestamp:

08/27/2020 07:25:38 PM (4 years ago)

Author:

desrosj

Message:

Upgrade/Install: Pass details about the specific plugin and theme updates attempted to filters.

This adds an additional parameter to the auto_plugin_update_send_email and auto_theme_update_send_email filters to provide the additional context of which updates were attempted and their outcome. This will help plugin and theme auto-update emails to be better tailored to a site owner’s liking.

Props audrasjb, Paddy Landau, desrosj.
Fixes #50988.

File:

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

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

@@ -880 +880 @@
      * @since 5.5.0
      *
-     * @param array $update_results The result of updates tasks.
+     * @param array $update_results The results of update tasks.
      */
     protected function after_plugin_theme_update( $update_results ) {
@@ -890 +890 @@
          *
          * @since 5.5.0
-         *
-         * @param bool $enabled True if plugins notifications are enabled, false otherwise.
+         * @since 5.5.1 Added the $update_results parameter.
+         *
+         * @param bool  $enabled        True if plugins 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 );
+        $notifications_enabled = apply_filters( 'auto_plugin_update_send_email', true, $update_results['plugin'] );
 
         if ( ! empty( $update_results['plugin'] ) && $notifications_enabled ) {
@@ -909 +911 @@
          *
          * @since 5.5.0
-         *
-         * @param bool $enabled True if notifications are enabled, false otherwise.
+         * @since 5.5.1 Added the $update_results parameter.
+         *
+         * @param bool  $enabled True if 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 );
+        $notifications_enabled = apply_filters( 'auto_theme_update_send_email', true, $update_results['theme'] );
 
         if ( ! empty( $update_results['theme'] ) && $notifications_enabled ) {