Skip to content

Upgrade/Install: Improve plugin and theme auto-update email subjects #13761

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rootzero00 wants to merge 3 commits into
base: trunk
Choose a base branch
from
Open

Upgrade/Install: Improve plugin and theme auto-update email subjects #13761

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
3832b41
Improve plugin and theme auto-update email subjects
rootzero00 Sep 22, 2026
490ec45
Tests: Fix CI checks for auto-update email subjects
rootzero00 Sep 26, 2026
da1d020
Upgrade/Install: Refresh auto-update email subjects and address review.
rootzero00 Oct 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
154 changes: 129 additions & 25 deletions src/wp-admin/includes/class-wp-automatic-updater.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1414,28 +1414,36 @@ protected function send_plugin_theme_email( $type, $successful_updates, $failed_
$failed_plugins = ( ! empty( $failed_updates['plugin'] ) );
$failed_themes = ( ! empty( $failed_updates['theme'] ) );

if ( '' !== get_option( 'blogname' ) ) {
$site_title = wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES );
} else {
$site_title = parse_url( home_url(), PHP_URL_HOST );
}

$subject_updates = 'success' === $type ? $successful_updates : $failed_updates;
$subject_status = 'success' === $type ? 'success' : 'fail';
$subject = $this->get_plugin_theme_auto_update_email_subject(
$site_title,
$subject_updates,
$subject_status
);

switch ( $type ) {
case 'success':
if ( $successful_plugins && $successful_themes ) {
/* translators: %s: Site title. */
$subject = __( '[%s] Some plugins and themes have automatically updated' );
$body[] = sprintf(
$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(
$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(
$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()
Expand All @@ -1446,25 +1454,19 @@ protected function send_plugin_theme_email( $type, $successful_updates, $failed_
case 'fail':
case 'mixed':
if ( $failed_plugins && $failed_themes ) {
/* translators: %s: Site title. */
$subject = __( '[%s] Some plugins and themes have failed to update' );
$body[] = sprintf(
$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(
$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(
$body[] = sprintf(
/* translators: %s: Home URL. */
__( 'Howdy! Themes failed to update on your site at %s.' ),
home_url()
Expand Down Expand Up @@ -1648,15 +1650,8 @@ protected function send_plugin_theme_email( $type, $successful_updates, $failed_
$body[] = __( 'https://wordpress.org/support/forums/' );
$body[] = "\n" . __( 'The WordPress Team' );

if ( '' !== get_option( 'blogname' ) ) {
$site_title = wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES );
} else {
$site_title = parse_url( home_url(), PHP_URL_HOST );
}

$body = implode( "\n", $body );
$to = get_site_option( 'admin_email' );
$subject = sprintf( $subject, $site_title );
$headers = '';

$email = compact( 'to', 'subject', 'body', 'headers' );
Expand Down Expand Up @@ -1692,6 +1687,115 @@ protected function send_plugin_theme_email( $type, $successful_updates, $failed_
}
}

/**
* Builds a plugin and theme auto-update email subject.
*
* @since 7.2.0
*
* @param string $site_title Site title.
* @param array $updates Plugin and theme update results.
* @param string $status Update status. Either 'success' or 'fail'.
* @return string Email subject.
*/
protected function get_plugin_theme_auto_update_email_subject( $site_title, $updates, $status ) {
$plugins = ! empty( $updates['plugin'] ) ? $updates['plugin'] : array();
$themes = ! empty( $updates['theme'] ) ? $updates['theme'] : array();
$plugin_count = count( $plugins );
$theme_count = count( $themes );
$total_count = $plugin_count + $theme_count;
$is_success = ( 'success' === $status );

if ( $plugin_count && $theme_count ) {
if ( $is_success ) {
/* translators: %s: Site title. */
return sprintf( __( '[%s] Some plugins and themes have automatically updated' ), $site_title );
}

/* translators: %s: Site title. */
return sprintf( __( '[%s] Some plugins and themes have failed to update' ), $site_title );
}

if ( 1 === $total_count ) {
$items = $plugin_count ? $plugins : $themes;
$item = reset( $items );
$item_name = $this->prepare_plugin_theme_auto_update_email_subject_name( $item->name ?? '' );

if ( '' !== $item_name ) {
if ( $is_success ) {
/* translators: 1: Site title, 2: Plugin or theme name. */
return sprintf( __( '[%1$s] %2$s was automatically updated' ), $site_title, $item_name );
}

/* translators: 1: Site title, 2: Plugin or theme name. */
return sprintf( __( '[%1$s] %2$s failed to update' ), $site_title, $item_name );
}
}

if ( $plugin_count ) {
if ( $is_success ) {
return sprintf(
/* translators: 1: Site title, 2: Number of plugins. */
_n( '[%1$s] %2$s plugin was automatically updated', '[%1$s] %2$s plugins were automatically updated', $plugin_count ),
$site_title,
number_format_i18n( $plugin_count )
);
}

return sprintf(
/* translators: 1: Site title, 2: Number of plugins. */
_n( '[%1$s] %2$s plugin failed to update', '[%1$s] %2$s plugins failed to update', $plugin_count ),
$site_title,
number_format_i18n( $plugin_count )
);
}

if ( $is_success ) {
return sprintf(
/* translators: 1: Site title, 2: Number of themes. */
_n( '[%1$s] %2$s theme was automatically updated', '[%1$s] %2$s themes were automatically updated', $theme_count ),
$site_title,
number_format_i18n( $theme_count )
);
}

return sprintf(
/* translators: 1: Site title, 2: Number of themes. */
_n( '[%1$s] %2$s theme failed to update', '[%1$s] %2$s themes failed to update', $theme_count ),
$site_title,
number_format_i18n( $theme_count )
);
}

/**
* Prepares an item name for an auto-update email subject.
*
* Names longer than 35 Unicode code points are shortened to 35 code
* points followed by an ellipsis.
*
* @since 7.2.0
*
* @param string $name Plugin or theme name.
* @return string Prepared item name.
*/
protected function prepare_plugin_theme_auto_update_email_subject_name( $name ) {
$name = wp_scrub_utf8( $name );
$name = html_entity_decode(
$name,
ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401,
'UTF-8'
);

if ( 1 !== preg_match( '/[^\s\p{Z}]/u', $name ) ) {
return '';
}

if ( 35 < mb_strlen( $name, 'UTF-8' ) ) {
$name = mb_substr( $name, 0, 35, 'UTF-8' ) . "\u{2026}";
}

return $name;
}

/**
* Prepares and sends an email of a full log of background update results, useful for debugging and geekery.
*
Expand Down
Loading
Loading