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
751       * 2. Before Maintenance Mode is enabled.
752       * 3. Before WordPress begins copying over the necessary files.
753       * 4. Before Maintenance Mode is disabled.
754       * 5. Before the database is upgraded.
755       *
756       * @since 2.5.0
757       *
758       * @param string $feedback The core update feedback messages.
759       */
760      apply_filters( 'update_feedback', __( 'Verifying the unpacked files…' ) );
761
762      // Sanity check the unzipped distribution.
763      $distro = '';
764      $roots = array( '/wordpress/', '/wordpress-mu/' );
765      foreach ( $roots as $root ) {
766           if ( $wp_filesystem->exists( $from . $root . 'readme.html' ) && $wp_filesystem->exists( $from . $root . 'wp-includes/version.php' ) ) {
767                $distro = $root;
768                break;
769           }
 
Line Code
800
801      if ( !$mysql_compat && !$php_compat )
802           return new WP_Error( 'php_mysql_not_compatible', sprintf( __('The update cannot be installed because WordPress %1$s requires PHP version %2$s or higher and MySQL version %3$s or higher. You are running PHP version %4$s and MySQL version %5$s.'), $wp_version, $required_php_version, $required_mysql_version, $php_version, $mysql_version ) );
803      elseif ( !$php_compat )
804           return new WP_Error( 'php_not_compatible', sprintf( __('The update cannot be installed because WordPress %1$s requires PHP version %2$s or higher. You are running version %3$s.'), $wp_version, $required_php_version, $php_version ) );
805      elseif ( !$mysql_compat )
806           return new WP_Error( 'mysql_not_compatible', sprintf( __('The update cannot be installed because WordPress %1$s requires MySQL version %2$s or higher. You are running version %3$s.'), $wp_version, $required_mysql_version, $mysql_version ) );
807
808      /** This filter is documented in wp-admin/includes/update-core.php */
809      apply_filters( 'update_feedback', __( 'Preparing to install the latest version…' ) );
810
811      // Don't copy wp-content, we'll deal with that below
812      // We also copy version.php last so failed updates report their old version
813      $skip = array( 'wp-content', 'wp-includes/version.php' );
814      $check_is_writable = array();
815
816      // Check to see which files don't really need updating - only available for 3.7 and higher
817      if ( function_exists( 'get_core_checksums' ) ) {
818           // Find the local version of the working directory
 
Line Code
852                // Store package-relative paths (the key) of non-writable files in the WP_Error object.
853                $error_data = version_compare( $old_wp_version, '3.7-beta2', '>' ) ? array_keys( $files_not_writable ) : '';
854
855                if ( $files_not_writable )
856                     return new WP_Error( 'files_not_writable', __( 'The update cannot be installed because we will be unable to copy some files. This is usually due to inconsistent file permissions.' ), implode( ', ', $error_data ) );
857           }
858      }
859
860      /** This filter is documented in wp-admin/includes/update-core.php */
861      apply_filters( 'update_feedback', __( 'Enabling Maintenance mode…' ) );
862      // Create maintenance file to signal that we are upgrading
863      $maintenance_string = '<?php $upgrading = ' . time() . '; ?>';
864      $maintenance_file = $to . '.maintenance';
865      $wp_filesystem->delete($maintenance_file);
866      $wp_filesystem->put_contents($maintenance_file, $maintenance_string, FS_CHMOD_FILE);
867
868      /** This filter is documented in wp-admin/includes/update-core.php */
869      apply_filters( 'update_feedback', __( 'Copying the required files&#8230;' ) );
870      // Copy new versions of WP files into place.
871      $result = _copy_dir( $from . $distro, $to, $skip );
872      if ( is_wp_error( $result ) )
873           $result = new WP_Error( $result->get_error_code(), $result->get_error_message(), substr( $result->get_error_data(), strlen( $to ) ) );
874
875      // Since we know the core files have copied over, we can now copy the version file
876      if ( ! is_wp_error( $result ) ) {
877           if ( ! $wp_filesystem->copy( $from . $distro . 'wp-includes/version.php', $to . 'wp-includes/version.php', true /* overwrite */ ) ) {
878                $wp_filesystem->delete( $from, true );
 
Line Code
935                if ( $wp_lang_dir ) {
936                     $result = copy_dir($from . $distro . 'wp-content/languages/', $wp_lang_dir);
937                     if ( is_wp_error( $result ) )
938                          $result = new WP_Error( $result->get_error_code() . '_languages', $result->get_error_message(), substr( $result->get_error_data(), strlen( $wp_lang_dir ) ) );
939                }
940           }
941      }
942
943      /** This filter is documented in wp-admin/includes/update-core.php */
944      apply_filters( 'update_feedback', __( 'Disabling Maintenance mode&#8230;' ) );
945      // Remove maintenance file, we're done with potential site-breaking changes
946      $wp_filesystem->delete( $maintenance_file );
947
948      // 3.5 -> 3.5+ - an empty twentytwelve directory was created upon upgrade to 3.5 for some users, preventing installation of Twenty Twelve.
949      if ( '3.5' == $old_wp_version ) {
950           if ( is_dir( WP_CONTENT_DIR . '/themes/twentytwelve' ) && ! file_exists( WP_CONTENT_DIR . '/themes/twentytwelve/style.css' )  ) {
951                $wp_filesystem->delete( $wp_filesystem->wp_themes_dir() . 'twentytwelve/' );
952           }
953      }
 
Line Code
1007      foreach ( $_old_files as $old_file ) {
1008           $old_file = $to . $old_file;
1009           if ( !$wp_filesystem->exists($old_file) )
1010                continue;
1011           $wp_filesystem->delete($old_file, true);
1012      }
1013
1014      // Upgrade DB with separate request
1015      /** This filter is documented in wp-admin/includes/update-core.php */
1016      apply_filters( 'update_feedback', __( 'Upgrading database&#8230;' ) );
1017      $db_upgrade_url = admin_url('upgrade.php?step=upgrade_db');
1018      wp_remote_post($db_upgrade_url, array('timeout' => 60));
1019
1020      // Clear the cache to prevent an update_option() from saving a stale db_version to the cache
1021      wp_cache_flush();
1022      // (Not all cache backends listen to 'flush')
1023      wp_cache_delete( 'alloptions', 'options' );
1024
1025      // Remove working directory