WP_Automatic_Updater::after_plugin_theme_update( array $update_results )

Parameters

$update_resultsarray

The results of update tasks.

Hooks fired · 2

2 hooks fire while WP_Automatic_Updater::after_plugin_theme_update() runs, in this order:

1. 1
   apply_filters( auto_plugin_update_send_email )filterline 1177 (+14 into the body)

   Filters whether to send an email following an automatic background plugin update.

2. 2
   apply_filters( auto_theme_update_send_email )filterline 1200 (+37 into the body)

   Filters whether to send an email following an automatic background theme update.

Uses · 2

• apply_filters()Calls the callback functions that have been added to a filter hook.
• WP_Automatic_Updater::send_plugin_theme_email()Sends an email upon the completion or failure of a plugin or theme background update.

Used by · 1

• WP_Automatic_Updater::run()Kicks off the background update process, looping through all pending updates.

Source

View on Trac ↗View on GitHub ↗

1163	protected function after_plugin_theme_update( $update_results ) {1164		$successful_updates = array();1165		$failed_updates     = array();1166 1167		if ( ! empty( $update_results['plugin'] ) ) {1168			/**1169			 * Filters whether to send an email following an automatic background plugin update.1170			 *1171			 * @since 5.5.01172			 * @since 5.5.1 Added the `$update_results` parameter.1173			 *1174			 * @param bool  $enabled        True if plugin update notifications are enabled, false otherwise.1175			 * @param array $update_results The results of plugins update tasks.1176			 */1177			$notifications_enabled = apply_filters( 'auto_plugin_update_send_email', true, $update_results['plugin'] );1178 1179			if ( $notifications_enabled ) {1180				foreach ( $update_results['plugin'] as $update_result ) {1181					if ( true === $update_result->result ) {1182						$successful_updates['plugin'][] = $update_result;1183					} else {1184						$failed_updates['plugin'][] = $update_result;1185					}1186				}1187			}1188		}1189 1190		if ( ! empty( $update_results['theme'] ) ) {1191			/**1192			 * Filters whether to send an email following an automatic background theme update.1193			 *1194			 * @since 5.5.01195			 * @since 5.5.1 Added the `$update_results` parameter.1196			 *1197			 * @param bool  $enabled        True if theme update notifications are enabled, false otherwise.1198			 * @param array $update_results The results of theme update tasks.1199			 */1200			$notifications_enabled = apply_filters( 'auto_theme_update_send_email', true, $update_results['theme'] );1201 1202			if ( $notifications_enabled ) {1203				foreach ( $update_results['theme'] as $update_result ) {1204					if ( true === $update_result->result ) {1205						$successful_updates['theme'][] = $update_result;1206					} else {1207						$failed_updates['theme'][] = $update_result;1208					}1209				}1210			}1211		}1212 1213		if ( empty( $successful_updates ) && empty( $failed_updates ) ) {1214			return;1215		}1216 1217		if ( empty( $failed_updates ) ) {1218			$this->send_plugin_theme_email( 'success', $successful_updates, $failed_updates );1219		} elseif ( empty( $successful_updates ) ) {1220			$this->send_plugin_theme_email( 'fail', $successful_updates, $failed_updates );1221		} else {1222			$this->send_plugin_theme_email( 'mixed', $successful_updates, $failed_updates );1223		}1224	}

History

Introduced in 5.5.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.8.8 tag, from src/wp-admin/includes/class-wp-automatic-updater.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.