Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: update_feedback

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

This hook occurs 6 times in this file.

Line Code
976       * 2. Before Maintenance Mode is enabled.
977       * 3. Before WordPress begins copying over the necessary files.
978       * 4. Before Maintenance Mode is disabled.
979       * 5. Before the database is upgraded.
980       *
981       * @since 2.5.0
982       *
983       * @param string $feedback The core update feedback messages.
984       */
985      apply_filters( 'update_feedback', __( 'Verifying the unpacked files…' ) );
986
987      // Sanity check the unzipped distribution.
988      $distro = '';
989      $roots  = array( '/wordpress/', '/wordpress-mu/' );
990
991      foreach ( $roots as $root ) {
992           if ( $wp_filesystem->exists( $from . $root . 'readme.html' )
993                && $wp_filesystem->exists( $from . $root . 'wp-includes/version.php' )
994           ) {
 
Line Code
1113                     /* translators: 1: WordPress version number, 2: The PHP extension name needed. */
1114                     __( 'The update cannot be installed because WordPress %1$s requires the %2$s PHP extension.' ),
1115                     $wp_version,
1116                     'JSON'
1117                )
1118           );
1119      }
1120
1121      /** This filter is documented in wp-admin/includes/update-core.php */
1122      apply_filters( 'update_feedback', __( 'Preparing to install the latest version…' ) );
1123
1124      // Don't copy wp-content, we'll deal with that below.
1125      // We also copy version.php last so failed updates report their old version.
1126      $skip              = array( 'wp-content', 'wp-includes/version.php' );
1127      $check_is_writable = array();
1128
1129      // Check to see which files don't really need updating - only available for 3.7 and higher.
1130      if ( function_exists( 'get_core_checksums' ) ) {
1131           // Find the local version of the working directory.
 
Line Code
1190                          'files_not_writable',
1191                          __( 'The update cannot be installed because your site is unable to copy some files. This is usually due to inconsistent file permissions.' ),
1192                          implode( ', ', $error_data )
1193                     );
1194                }
1195           }
1196      }
1197
1198      /** This filter is documented in wp-admin/includes/update-core.php */
1199      apply_filters( 'update_feedback', __( 'Enabling Maintenance mode…' ) );
1200
1201      // Create maintenance file to signal that we are upgrading.
1202      $maintenance_string = '<?php $upgrading = ' . time() . '; ?>';
1203      $maintenance_file   = $to . '.maintenance';
1204      $wp_filesystem->delete( $maintenance_file );
1205      $wp_filesystem->put_contents( $maintenance_file, $maintenance_string, FS_CHMOD_FILE );
1206
1207      /** This filter is documented in wp-admin/includes/update-core.php */
1208      apply_filters( 'update_feedback', __( 'Copying the required files&#8230;' ) );
1209
1210      // Copy new versions of WP files into place.
1211      $result = copy_dir( $from . $distro, $to, $skip );
1212
1213      if ( is_wp_error( $result ) ) {
1214           $result = new WP_Error(
1215                $result->get_error_code(),
1216                $result->get_error_message(),
1217                substr( $result->get_error_data(), strlen( $to ) )
 
Line Code
1326                               $result->get_error_message(),
1327                               substr( $result->get_error_data(), strlen( $wp_lang_dir ) )
1328                          );
1329                     }
1330                }
1331           }
1332      }
1333
1334      /** This filter is documented in wp-admin/includes/update-core.php */
1335      apply_filters( 'update_feedback', __( 'Disabling Maintenance mode&#8230;' ) );
1336
1337      // Remove maintenance file, we're done with potential site-breaking changes.
1338      $wp_filesystem->delete( $maintenance_file );
1339
1340      // 3.5 -> 3.5+ - an empty twentytwelve directory was created upon upgrade to 3.5 for some users,
1341      // preventing installation of Twenty Twelve.
1342      if ( '3.5' === $old_wp_version ) {
1343           if ( is_dir( WP_CONTENT_DIR . '/themes/twentytwelve' )
1344                && ! file_exists( WP_CONTENT_DIR . '/themes/twentytwelve/style.css' )
 
Line Code
1436
1437      // Deactivate the REST API plugin if its version is 2.0 Beta 4 or lower.
1438      _upgrade_440_force_deactivate_incompatible_plugins();
1439
1440      // Deactivate the Gutenberg plugin if its version is 11.8 or lower.
1441      _upgrade_590_force_deactivate_incompatible_plugins();
1442
1443      // Upgrade DB with separate request.
1444      /** This filter is documented in wp-admin/includes/update-core.php */
1445      apply_filters( 'update_feedback', __( 'Upgrading database&#8230;' ) );
1446
1447      $db_upgrade_url = admin_url( 'upgrade.php?step=upgrade_db' );
1448      wp_remote_post( $db_upgrade_url, array( 'timeout' => 60 ) );
1449
1450      // Clear the cache to prevent an update_option() from saving a stale db_version to the cache.
1451      wp_cache_flush();
1452      // Not all cache back ends listen to 'flush'.
1453      wp_cache_delete( 'alloptions', 'options' );
1454