<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[27673] trunk/src/wp-admin/includes/class-wp-upgrader.php: Inline documentation for wp-admin/includes/class-wp-upgrader.php.</title>
</head>
<body>
<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta">
<dt>Revision</dt> <dd><a href="http://core.trac.wordpress.org/changeset/27673">27673</a></dd>
<dt>Author</dt> <dd>DrewAPicture</dd>
<dt>Date</dt> <dd>2014-03-24 02:59:36 +0000 (Mon, 24 Mar 2014)</dd>
</dl>
<h3>Log Message</h3>
<pre>Inline documentation for wp-admin/includes/class-wp-upgrader.php.
Props kpdesign for some minor cleanup.
Fixes <a href="http://core.trac.wordpress.org/ticket/27436">#27436</a>.</pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunksrcwpadminincludesclasswpupgraderphp">trunk/src/wp-admin/includes/class-wp-upgrader.php</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunksrcwpadminincludesclasswpupgraderphp"></a>
<div class="modfile"><h4>Modified: trunk/src/wp-admin/includes/class-wp-upgrader.php (27672 => 27673)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/src/wp-admin/includes/class-wp-upgrader.php 2014-03-24 02:44:17 UTC (rev 27672)
+++ trunk/src/wp-admin/includes/class-wp-upgrader.php 2014-03-24 02:59:36 UTC (rev 27673)
</span><span class="lines">@@ -113,9 +113,10 @@
</span><span class="cx"> *
</span><span class="cx"> * @since 3.7.0
</span><span class="cx"> *
</span><del>- * @param bool $reply Whether to bail without returning the package. Default is false.
- * @param string $package The package file name.
- * @param object $this The WP_Upgrader instance.
</del><ins>+ * @param bool $reply Whether to bail without returning the package.
+ * Default false.
+ * @param string $package The package file name.
+ * @param WP_Upgrader $this The WP_Upgrader instance.
</ins><span class="cx"> */
</span><span class="cx"> $reply = apply_filters( 'upgrader_pre_download', false, $package, $this );
</span><span class="cx"> if ( false !== $reply )
</span><span class="lines">@@ -198,7 +199,19 @@
</span><span class="cx">
</span><span class="cx"> $this->skin->feedback('installing_package');
</span><span class="cx">
</span><del>- $res = apply_filters('upgrader_pre_install', true, $hook_extra);
</del><ins>+ /**
+ * Filter the install response before the installation has started.
+ *
+ * Returning a truthy value, or one that could be evaluated as a WP_Error
+ * will effectively short-circuit the installation, returning that value
+ * instead.
+ *
+ * @since 2.8.0
+ *
+ * @param bool|WP_Error $response Response.
+ * @param array $hook_extra Extra arguments passed to hooked filters.
+ */
+ $res = apply_filters( 'upgrader_pre_install', true, $hook_extra );
</ins><span class="cx"> if ( is_wp_error($res) )
</span><span class="cx"> return $res;
</span><span class="cx">
</span><span class="lines">@@ -217,8 +230,16 @@
</span><span class="cx"> else //It's only a single file, the upgrader will use the foldername of this file as the destination folder. foldername is based on zip filename.
</span><span class="cx"> $source = trailingslashit($source);
</span><span class="cx">
</span><del>- //Hook ability to change the source file location..
- $source = apply_filters('upgrader_source_selection', $source, $remote_source, $this);
</del><ins>+ /**
+ * Filter the source file location for the upgrade package.
+ *
+ * @since 2.8.0
+ *
+ * @param string $source File source location.
+ * @param string $remote_source Remove file source location.
+ * @param WP_Upgrader $this WP_Upgrader instance.
+ */
+ $source = apply_filters( 'upgrader_source_selection', $source, $remote_source, $this );
</ins><span class="cx"> if ( is_wp_error($source) )
</span><span class="cx"> return $source;
</span><span class="cx">
</span><span class="lines">@@ -243,8 +264,19 @@
</span><span class="cx"> $removed = true;
</span><span class="cx"> if ( $wp_filesystem->exists($remote_destination) )
</span><span class="cx"> $removed = $wp_filesystem->delete($remote_destination, true);
</span><del>- $removed = apply_filters('upgrader_clear_destination', $removed, $local_destination, $remote_destination, $hook_extra);
</del><span class="cx">
</span><ins>+ /**
+ * Filter whether the upgrader cleared the destination.
+ *
+ * @since 2.8.0
+ *
+ * @param bool $removed Whether the destination was cleared.
+ * @param string $local_destination The local package destination.
+ * @param string $remote_destination The remote package destination.
+ * @param array $hook_extra Extra arguments passed to hooked filters.
+ */
+ $removed = apply_filters( 'upgrader_clear_destination', $removed, $local_destination, $remote_destination, $hook_extra );
+
</ins><span class="cx"> if ( is_wp_error($removed) )
</span><span class="cx"> return $removed;
</span><span class="cx"> else if ( ! $removed )
</span><span class="lines">@@ -282,7 +314,17 @@
</span><span class="cx">
</span><span class="cx"> $this->result = compact('local_source', 'source', 'source_name', 'source_files', 'destination', 'destination_name', 'local_destination', 'remote_destination', 'clear_destination', 'delete_source_dir');
</span><span class="cx">
</span><del>- $res = apply_filters('upgrader_post_install', true, $hook_extra, $this->result);
</del><ins>+ /**
+ * Filter the install response after the installation has finished.
+ *
+ * @since 2.8.0
+ *
+ * @param bool $response Install response.
+ * @param array $hook_extra Extra arguments passed to hooked filters.
+ * @param array $result Installation result data.
+ */
+ $res = apply_filters( 'upgrader_post_install', true, $hook_extra, $this->result );
+
</ins><span class="cx"> if ( is_wp_error($res) ) {
</span><span class="cx"> $this->result = $res;
</span><span class="cx"> return $res;
</span><span class="lines">@@ -373,6 +415,8 @@
</span><span class="cx"> $this->skin->after();
</span><span class="cx">
</span><span class="cx"> if ( ! $is_multi ) {
</span><ins>+
+ /** This action is documented in wp-admin/includes/class-wp-upgrader.php */
</ins><span class="cx"> do_action( 'upgrader_process_complete', $this, $hook_extra );
</span><span class="cx"> $this->skin->footer();
</span><span class="cx"> }
</span><span class="lines">@@ -593,6 +637,22 @@
</span><span class="cx">
</span><span class="cx"> $this->maintenance_mode(false);
</span><span class="cx">
</span><ins>+ /**
+ * Fires when the bulk upgrader process is complete.
+ *
+ * @since 3.6.0
+ *
+ * @param Plugin_Upgrader $this Plugin_Upgrader instance. In other contexts, $this, might
+ * be a Theme_Upgrader or Core_Upgrade instance.
+ * @param array $data {
+ * Array of bulk item update data.
+ *
+ * @type string $action Type of action. Default 'update'.
+ * @type string $type Type of update process. Accepts 'plugin', 'theme', or 'core'.
+ * @type bool $bulk Whether the update process is a bulk update. Default true.
+ * @type array $packages Array of plugin, theme, or core packages to update.
+ * }
+ */
</ins><span class="cx"> do_action( 'upgrader_process_complete', $this, array(
</span><span class="cx"> 'action' => 'update',
</span><span class="cx"> 'type' => 'plugin',
</span><span class="lines">@@ -976,6 +1036,7 @@
</span><span class="cx">
</span><span class="cx"> $this->maintenance_mode(false);
</span><span class="cx">
</span><ins>+ /** This action is documented in wp-admin/includes/class-wp-upgrader.php */
</ins><span class="cx"> do_action( 'upgrader_process_complete', $this, array(
</span><span class="cx"> 'action' => 'update',
</span><span class="cx"> 'type' => 'theme',
</span><span class="lines">@@ -1346,10 +1407,12 @@
</span><span class="cx"> elseif ( $parsed_args['pre_check_md5'] && ! $this->check_files() )
</span><span class="cx"> $partial = false;
</span><span class="cx">
</span><del>- // If partial update is returned from the API, use that, unless we're doing a reinstall.
- // If we cross the new_bundled version number, then use the new_bundled zip.
- // Don't though if the constant is set to skip bundled items.
- // If the API returns a no_content zip, go with it. Finally, default to the full zip.
</del><ins>+ /*
+ * If partial update is returned from the API, use that, unless we're doing
+ * a reinstall. If we cross the new_bundled version number, then use
+ * the new_bundled zip. Don't though if the constant is set to skip bundled items.
+ * If the API returns a no_content zip, go with it. Finally, default to the full zip.
+ */
</ins><span class="cx"> if ( $parsed_args['do_rollback'] && $current->packages->rollback )
</span><span class="cx"> $to_download = 'rollback';
</span><span class="cx"> elseif ( $current->packages->partial && 'reinstall' != $current->response && $wp_version == $current->partial_version && $partial )
</span><span class="lines">@@ -1403,6 +1466,7 @@
</span><span class="cx"> if ( $try_rollback ) {
</span><span class="cx"> /** This filter is documented in wp-admin/includes/update-core.php */
</span><span class="cx"> apply_filters( 'update_feedback', $result );
</span><ins>+
</ins><span class="cx"> /** This filter is documented in wp-admin/includes/update-core.php */
</span><span class="cx"> apply_filters( 'update_feedback', $this->strings['start_rollback'] );
</span><span class="cx">
</span><span class="lines">@@ -1413,6 +1477,7 @@
</span><span class="cx"> }
</span><span class="cx"> }
</span><span class="cx">
</span><ins>+ /** This action is documented in wp-admin/includes/class-wp-upgrader.php */
</ins><span class="cx"> do_action( 'upgrader_process_complete', $this, array( 'action' => 'update', 'type' => 'core' ) );
</span><span class="cx">
</span><span class="cx"> // Clear the current updates
</span><span class="lines">@@ -1508,18 +1573,45 @@
</span><span class="cx">
</span><span class="cx"> // 3: 3.7-alpha-25000 -> 3.7-alpha-25678 -> 3.7-beta1 -> 3.7-beta2
</span><span class="cx"> if ( $current_is_development_version ) {
</span><ins>+
+ /**
+ * Filter whether to enable automatic core updates for development versions.
+ *
+ * @since 3.7.0
+ *
+ * @param bool $upgrade_dev Whether to enable automatic updates for
+ * development versions.
+ */
</ins><span class="cx"> if ( ! apply_filters( 'allow_dev_auto_core_updates', $upgrade_dev ) )
</span><span class="cx"> return false;
</span><span class="cx"> // else fall through to minor + major branches below
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> // 4: Minor In-branch updates (3.7.0 -> 3.7.1 -> 3.7.2 -> 3.7.4)
</span><del>- if ( $current_branch == $new_branch )
</del><ins>+ if ( $current_branch == $new_branch ) {
+
+ /**
+ * Filter whether to enable minor automatic core updates.
+ *
+ * @since 3.7.0
+ *
+ * @param bool $upgrade_minor Whether to enable minor automatic core updates.
+ */
</ins><span class="cx"> return apply_filters( 'allow_minor_auto_core_updates', $upgrade_minor );
</span><ins>+ }
</ins><span class="cx">
</span><span class="cx"> // 5: Major version updates (3.7.0 -> 3.8.0 -> 3.9.1)
</span><del>- if ( version_compare( $new_branch, $current_branch, '>' ) )
</del><ins>+ if ( version_compare( $new_branch, $current_branch, '>' ) ) {
+
+ /**
+ * Filter whether to enable major automatic core updates.
+ *
+ * @since 3.7.0
+ *
+ * @param bool $upgrade_major Whether to enable major automatic core updates.
+ */
</ins><span class="cx"> return apply_filters( 'allow_major_auto_core_updates', $upgrade_major );
</span><ins>+ }
</ins><span class="cx">
</span><span class="cx"> // If we're not sure, we don't want it
</span><span class="cx"> return false;
</span><span class="lines">@@ -1660,6 +1752,7 @@
</span><span class="cx"> * This also disables update notification emails. That may change in the future.
</span><span class="cx"> *
</span><span class="cx"> * @since 3.7.0
</span><ins>+ *
</ins><span class="cx"> * @param bool $disabled Whether the updater should be disabled.
</span><span class="cx"> */
</span><span class="cx"> return apply_filters( 'automatic_updater_disabled', $disabled );
</span><span class="lines">@@ -1713,13 +1806,15 @@
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * Filter whether the automatic updater should consider a filesystem location to be potentially
- * managed by a version control system.
</del><ins>+ * Filter whether the automatic updater should consider a filesystem
+ * location to be potentially managed by a version control system.
</ins><span class="cx"> *
</span><span class="cx"> * @since 3.7.0
</span><span class="cx"> *
</span><del>- * @param bool $checkout Whether a VCS checkout was discovered at $context or ABSPATH, or anywhere higher.
- * @param string $context The filesystem context (a path) against which filesystem status should be checked.
</del><ins>+ * @param bool $checkout Whether a VCS checkout was discovered at $context
+ * or ABSPATH, or anywhere higher.
+ * @param string $context The filesystem context (a path) against which
+ * filesystem status should be checked.
</ins><span class="cx"> */
</span><span class="cx"> return apply_filters( 'automatic_updates_is_vcs_checkout', $checkout, $context );
</span><span class="cx"> }
</span><span class="lines">@@ -1729,10 +1824,11 @@
</span><span class="cx"> *
</span><span class="cx"> * @since 3.7.0
</span><span class="cx"> *
</span><del>- * @param string $type The type of update being checked: 'core', 'theme', 'plugin', 'translation'.
</del><ins>+ * @param string $type The type of update being checked: 'core', 'theme',
+ * 'plugin', 'translation'.
</ins><span class="cx"> * @param object $item The update offer.
</span><del>- * @param string $context The filesystem context (a path) against which filesystem access and status
- * should be checked.
</del><ins>+ * @param string $context The filesystem context (a path) against which filesystem
+ * access and status should be checked.
</ins><span class="cx"> */
</span><span class="cx"> public function should_update( $type, $item, $context ) {
</span><span class="cx"> // Used to see if WP_Filesystem is set up to allow unattended updates.
</span><span class="lines">@@ -1760,11 +1856,13 @@
</span><span class="cx"> * The dynamic portion of the hook name, $type, refers to the type of update
</span><span class="cx"> * being checked. Can be 'core', 'theme', 'plugin', or 'translation'.
</span><span class="cx"> *
</span><del>- * Generally speaking, plugins, themes, and major core versions are not updated by default,
- * while translations and minor and development versions for core are updated by default.
</del><ins>+ * Generally speaking, plugins, themes, and major core versions are not updated
+ * by default, while translations and minor and development versions for core
+ * are updated by default.
</ins><span class="cx"> *
</span><del>- * See the filters allow_dev_auto_core_updates, allow_minor_auto_core_updates, and
- * allow_major_auto_core_updates more straightforward filters to adjust core updates.
</del><ins>+ * See the allow_dev_auto_core_updates, allow_minor_auto_core_updates, and
+ * allow_major_auto_core_updates filters for a more straightforward way to
+ * adjust core updates.
</ins><span class="cx"> *
</span><span class="cx"> * @since 3.7.0
</span><span class="cx"> *
</span><span class="lines">@@ -1815,20 +1913,23 @@
</span><span class="cx"> $notify = ! empty( $item->notify_email );
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * Whether to notify the site administrator of a new core update.
</del><ins>+ * Filter whether to notify the site administrator of a new core update.
</ins><span class="cx"> *
</span><del>- * By default, administrators are notified when the update offer received from WordPress.org
- * sets a particular flag. This allows for discretion in if and when to notify.
</del><ins>+ * 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.
</ins><span class="cx"> *
</span><del>- * This filter only fires once per release -- if the same email address was already
- * notified of the same new version, we won't repeatedly email the administrator.
</del><ins>+ * 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.
</ins><span class="cx"> *
</span><del>- * This filter is also used on about.php to check if a plugin has disabled these notifications.
</del><ins>+ * This filter is also used on about.php to check if a plugin has disabled
+ * these notifications.
</ins><span class="cx"> *
</span><span class="cx"> * @since 3.7.0
</span><span class="cx"> *
</span><del>- * @param bool $notify Whether the site administrator is notified.
- * @param object $item The update offer.
</del><ins>+ * @param bool $notify Whether the site administrator is notified.
+ * @param object $item The update offer.
</ins><span class="cx"> */
</span><span class="cx"> if ( ! apply_filters( 'send_core_update_notification_email', $notify, $item ) )
</span><span class="cx"> return false;
</span><span class="lines">@@ -2020,11 +2121,14 @@
</span><span class="cx"> // Send debugging email to all development installs.
</span><span class="cx"> if ( ! empty( $this->update_results ) ) {
</span><span class="cx"> $development_version = false !== strpos( $wp_version, '-' );
</span><ins>+
</ins><span class="cx"> /**
</span><span class="cx"> * Filter whether to send a debugging email for each automatic background update.
</span><span class="cx"> *
</span><span class="cx"> * @since 3.7.0
</span><del>- * @param bool $development_version By default, emails are sent if the install is a development version.
</del><ins>+ *
+ * @param bool $development_version By default, emails are sent if the
+ * install is a development version.
</ins><span class="cx"> * Return false to avoid the email.
</span><span class="cx"> */
</span><span class="cx"> if ( apply_filters( 'automatic_updates_send_debug_email', $development_version ) )
</span><span class="lines">@@ -2034,12 +2138,12 @@
</span><span class="cx"> $this->after_core_update( $this->update_results['core'][0] );
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * Action triggered after all automatic updates have run.
- *
- * @since 3.8.0
- *
- * @param array $update_results The results of all attempted updates.
- */
</del><ins>+ * Fires after all automatic updates have run.
+ *
+ * @since 3.8.0
+ *
+ * @param array $update_results The results of all attempted updates.
+ */
</ins><span class="cx"> do_action( 'automatic_updates_complete', $this->update_results );
</span><span class="cx"> }
</span><span class="cx">
</span><span class="lines">@@ -2162,7 +2266,8 @@
</span><span class="cx"> * @since 3.7.0
</span><span class="cx"> *
</span><span class="cx"> * @param bool $send Whether to send the email. Default true.
</span><del>- * @param string $type The type of email to send. Can be one of 'success', 'fail', 'critical'.
</del><ins>+ * @param string $type The type of email to send. Can be one of
+ * 'success', 'fail', 'critical'.
</ins><span class="cx"> * @param object $core_update The update offer that was attempted.
</span><span class="cx"> * @param mixed $result The result for the core update. Can be WP_Error.
</span><span class="cx"> */
</span><span class="lines">@@ -2293,6 +2398,7 @@
</span><span class="cx"> $headers = '';
</span><span class="cx">
</span><span class="cx"> $email = compact( 'to', 'subject', 'body', 'headers' );
</span><ins>+
</ins><span class="cx"> /**
</span><span class="cx"> * Filter the email sent following an automatic background core update.
</span><span class="cx"> *
</span><span class="lines">@@ -2301,12 +2407,14 @@
</span><span class="cx"> * @param array $email {
</span><span class="cx"> * Array of email arguments that will be passed to wp_mail().
</span><span class="cx"> *
</span><del>- * @type string $to The email recipient. An array of emails can be returned, as handled by wp_mail().
</del><ins>+ * @type string $to The email recipient. An array of emails
+ * can be returned, as handled by wp_mail().
</ins><span class="cx"> * @type string $subject The email's subject.
</span><span class="cx"> * @type string $body The email message body.
</span><span class="cx"> * @type string $headers Any email headers, defaults to no headers.
</span><span class="cx"> * }
</span><del>- * @param string $type The type of email being sent. Can be one of 'success', 'fail', 'manual', 'critical'.
</del><ins>+ * @param string $type The type of email being sent. Can be one of
+ * 'success', 'fail', 'manual', 'critical'.
</ins><span class="cx"> * @param object $core_update The update offer that was attempted.
</span><span class="cx"> * @param mixed $result The result for the core update. Can be WP_Error.
</span><span class="cx"> */
</span><span class="lines">@@ -2443,15 +2551,16 @@
</span><span class="cx"> );
</span><span class="cx">
</span><span class="cx"> /**
</span><del>- * Filter the debug email that can be sent following an automatic background core update.
</del><ins>+ * Filter the debug email that can be sent following an automatic
+ * background core update.
</ins><span class="cx"> *
</span><span class="cx"> * @since 3.8.0
</span><span class="cx"> *
</span><span class="cx"> * @param array $email {
</span><span class="cx"> * Array of email arguments that will be passed to wp_mail().
</span><span class="cx"> *
</span><del>- * @type string $to The email recipient. An array of emails can be returned,
- * as handled by wp_mail().
</del><ins>+ * @type string $to The email recipient. An array of emails
+ * can be returned, as handled by wp_mail().
</ins><span class="cx"> * @type string $subject Email subject.
</span><span class="cx"> * @type string $body Email message body.
</span><span class="cx"> * @type string $headers Any email headers. Default empty.
</span></span></pre>
</div>
</div>
</body>
</html>