2007-08-17 12:33:52 +02:00
< ? php
2007-10-30 22:40:30 +01:00
/**
2008-08-12 23:21:11 +02:00
* A simple set of functions to check our version 1.0 update service .
2007-10-30 22:40:30 +01:00
*
* @ package WordPress
2008-09-18 19:32:18 +02:00
* @ since 2.3 . 0
2007-10-30 22:40:30 +01:00
*/
2007-08-17 12:33:52 +02:00
2007-10-30 22:40:30 +01:00
/**
2008-08-12 23:21:11 +02:00
* Check WordPress version against the newest version .
*
2008-08-01 07:00:07 +02:00
* The WordPress version , PHP version , and Locale is sent . Checks against the
* WordPress server at api . wordpress . org server . Will only check if WordPress
* isn ' t installing .
2007-10-30 22:40:30 +01:00
*
2008-08-27 08:45:13 +02:00
* @ since 2.3 . 0
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
* @ global string $wp_version Used to check against the newest WordPress version .
* @ global wpdb $wpdb
* @ global string $wp_local_package
2007-10-30 22:40:30 +01:00
*
2013-10-25 04:29:52 +02:00
* @ param array $extra_stats Extra statistics to report to the WordPress . org API .
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
* @ param bool $force_check Whether to bypass the transient cache and force a fresh update check . Defaults to false , true if $extra_stats is set .
2007-10-30 22:40:30 +01:00
*/
2013-11-15 04:04:10 +01:00
function wp_version_check ( $extra_stats = array (), $force_check = false ) {
Use `wp_installing()` instead of `WP_INSTALLING` constant.
The `WP_INSTALLING` constant is a flag that WordPress sets in a number of
places, telling the system that options should be fetched directly from the
database instead of from the cache, that WP should not ping wordpress.org for
updates, that the normal "not installed" checks should be bypassed, and so on.
A constant is generally necessary for this purpose, because the flag is
typically set before the WP bootstrap, meaning that WP functions are not yet
available. However, it is possible - notably, during `wpmu_create_blog()` -
for the "installing" flag to be set after WP has already loaded. In these
cases, `WP_INSTALLING` would be set for the remainder of the process, since
there's no way to change a constant once it's defined. This, in turn, polluted
later function calls that ought to have been outside the scope of site
creation, particularly the non-caching of option data. The problem was
particularly evident in the case of the automated tests, where `WP_INSTALLING`
was set the first time a site was created, and remained set for the rest of the
suite.
The new `wp_installing()` function allows developers to fetch the current
installation status (when called without any arguments) or to set the
installation status (when called with a boolean `true` or `false`). Use of
the `WP_INSTALLING` constant is still supported; `wp_installing()` will default
to `true` if the constant is defined during the bootstrap.
Props boonebgorges, jeremyfelt.
See #31130.
Built from https://develop.svn.wordpress.org/trunk@34828
git-svn-id: http://core.svn.wordpress.org/trunk@34793 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-10-05 17:06:28 +02:00
if ( wp_installing () ) {
2007-08-19 06:27:04 +02:00
return ;
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
}
2007-08-19 06:27:04 +02:00
2015-12-06 18:39:27 +01:00
global $wpdb , $wp_local_package ;
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
// include an unmodified $wp_version
include ( ABSPATH . WPINC . '/version.php' );
2007-08-17 12:33:52 +02:00
$php_version = phpversion ();
2007-09-04 01:19:20 +02:00
2017-12-01 00:11:00 +01:00
$current = get_site_transient ( 'update_core' );
2013-09-30 21:47:12 +02:00
$translations = wp_get_installed_translations ( 'core' );
2013-11-15 03:35:10 +01:00
// Invalidate the transient when $wp_version changes
2017-12-01 00:11:00 +01:00
if ( is_object ( $current ) && $wp_version != $current -> version_checked ) {
2013-11-15 03:35:10 +01:00
$current = false ;
2017-12-01 00:11:00 +01:00
}
2013-11-15 03:35:10 +01:00
2017-12-01 00:11:00 +01:00
if ( ! is_object ( $current ) ) {
$current = new stdClass ;
$current -> updates = array ();
2009-05-05 23:51:48 +02:00
$current -> version_checked = $wp_version ;
}
2008-11-26 13:04:29 +01:00
2017-12-01 00:11:00 +01:00
if ( ! empty ( $extra_stats ) ) {
2013-11-15 04:04:10 +01:00
$force_check = true ;
2017-12-01 00:11:00 +01:00
}
2013-11-15 04:04:10 +01:00
2012-01-05 20:49:47 +01:00
// Wait 60 seconds between multiple version check requests
2017-12-01 00:11:00 +01:00
$timeout = 60 ;
2012-01-05 20:49:47 +01:00
$time_not_changed = isset ( $current -> last_checked ) && $timeout > ( time () - $current -> last_checked );
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
if ( ! $force_check && $time_not_changed ) {
return ;
}
2012-01-05 20:49:47 +01:00
2013-10-06 17:31:09 +02:00
/**
2016-05-22 20:50:28 +02:00
* Filters the locale requested for WordPress core translations .
2013-10-06 17:31:09 +02:00
*
* @ since 2.8 . 0
*
* @ param string $locale Current locale .
*/
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
$locale = apply_filters ( 'core_version_check_locale' , get_locale () );
2007-08-17 12:33:52 +02:00
2008-11-26 12:48:05 +01:00
// Update last_checked for current to prevent multiple blocking requests if request hangs
$current -> last_checked = time ();
2010-01-08 21:49:55 +01:00
set_site_transient ( 'update_core' , $current );
2008-11-26 12:48:05 +01:00
2017-12-01 00:11:00 +01:00
if ( method_exists ( $wpdb , 'db_version' ) ) {
$mysql_version = preg_replace ( '/[^0-9.].*/' , '' , $wpdb -> db_version () );
} else {
2008-08-27 00:30:56 +02:00
$mysql_version = 'N/A' ;
2017-12-01 00:11:00 +01:00
}
2010-04-05 22:19:07 +02:00
2013-01-04 11:13:51 +01:00
if ( is_multisite () ) {
2017-12-01 00:11:00 +01:00
$user_count = get_user_count ();
$num_blogs = get_blog_count ();
$wp_install = network_site_url ();
2010-04-05 22:19:07 +02:00
$multisite_enabled = 1 ;
2010-11-29 06:27:01 +01:00
} else {
2017-12-01 00:11:00 +01:00
$user_count = count_users ();
$user_count = $user_count [ 'total_users' ];
2010-11-29 06:27:01 +01:00
$multisite_enabled = 0 ;
2017-12-01 00:11:00 +01:00
$num_blogs = 1 ;
$wp_install = home_url ( '/' );
2010-04-05 22:19:07 +02:00
}
2011-09-17 11:14:27 +02:00
$query = array (
2015-12-06 16:44:27 +01:00
'version' => $wp_version ,
'php' => $php_version ,
'locale' => $locale ,
'mysql' => $mysql_version ,
'local_package' => isset ( $wp_local_package ) ? $wp_local_package : '' ,
'blogs' => $num_blogs ,
'users' => $user_count ,
'multisite_enabled' => $multisite_enabled ,
'initial_db_version' => get_site_option ( 'initial_db_version' ),
2011-09-17 11:14:27 +02:00
);
2017-10-21 13:55:47 +02:00
/**
* Filter the query arguments sent as part of the core version check .
2017-10-21 15:46:50 +02:00
*
2017-10-21 13:55:47 +02:00
* WARNING : Changing this data may result in your site not receiving security updates .
* Please exercise extreme caution .
*
* @ since 4.9 . 0
*
2017-10-21 15:46:50 +02:00
* @ param array $query {
2017-12-01 00:11:00 +01:00
* Version check query arguments .
2017-10-21 15:46:50 +02:00
*
* @ type string $version WordPress version number .
* @ type string $php PHP version number .
* @ type string $locale The locale to retrieve updates for .
* @ type string $mysql MySQL version number .
* @ type string $local_package The value of the $wp_local_package global , when set .
2017-10-22 00:42:51 +02:00
* @ type int $blogs Number of sites on this WordPress installation .
* @ type int $users Number of users on this WordPress installation .
* @ type int $multisite_enabled Whether this WordPress installation uses Multisite .
2017-10-21 15:46:50 +02:00
* @ type int $initial_db_version Database version of WordPress at time of installation .
* }
2017-10-21 13:55:47 +02:00
*/
$query = apply_filters ( 'core_version_check_query_args' , $query );
2013-10-15 01:33:10 +02:00
$post_body = array (
2014-10-28 19:35:19 +01:00
'translations' => wp_json_encode ( $translations ),
2013-10-15 01:33:10 +02:00
);
2017-12-01 00:11:00 +01:00
if ( is_array ( $extra_stats ) ) {
2013-10-15 01:33:10 +02:00
$post_body = array_merge ( $post_body , $extra_stats );
2017-12-01 00:11:00 +01:00
}
2013-10-10 03:32:09 +02:00
2013-10-27 22:09:10 +01:00
$url = $http_url = 'http://api.wordpress.org/core/version-check/1.7/?' . http_build_query ( $query , null , '&' );
2017-12-01 00:11:00 +01:00
if ( $ssl = wp_http_supports ( array ( 'ssl' ) ) ) {
2013-09-03 05:22:10 +02:00
$url = set_url_scheme ( $url , 'https' );
2017-12-01 00:11:00 +01:00
}
2008-08-01 07:00:07 +02:00
2017-05-06 16:30:40 +02:00
$doing_cron = wp_doing_cron ();
2008-12-21 22:52:15 +01:00
$options = array (
2017-12-01 00:11:00 +01:00
'timeout' => $doing_cron ? 30 : 3 ,
2010-04-05 22:19:07 +02:00
'user-agent' => 'WordPress/' . $wp_version . '; ' . home_url ( '/' ),
2017-12-01 00:11:00 +01:00
'headers' => array (
2010-04-05 22:19:07 +02:00
'wp_install' => $wp_install ,
2017-12-01 00:11:00 +01:00
'wp_blog' => home_url ( '/' ),
2013-09-30 21:47:12 +02:00
),
2017-12-01 00:11:00 +01:00
'body' => $post_body ,
2008-12-21 22:52:15 +01:00
);
2008-08-01 07:00:07 +02:00
2013-09-30 21:47:12 +02:00
$response = wp_remote_post ( $url , $options );
2013-10-27 22:09:10 +01:00
if ( $ssl && is_wp_error ( $response ) ) {
2016-11-21 02:52:32 +01:00
trigger_error (
sprintf (
/* translators: %s: support forums URL */
__ ( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server’s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),
__ ( 'https://wordpress.org/support/' )
) . ' ' . __ ( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ),
headers_sent () || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE
);
2013-10-27 22:09:10 +01:00
$response = wp_remote_post ( $http_url , $options );
}
2008-08-12 23:21:11 +02:00
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
if ( is_wp_error ( $response ) || 200 != wp_remote_retrieve_response_code ( $response ) ) {
return ;
}
2008-08-01 07:00:07 +02:00
2011-05-14 21:45:07 +02:00
$body = trim ( wp_remote_retrieve_body ( $response ) );
2013-09-03 05:22:10 +02:00
$body = json_decode ( $body , true );
2012-01-08 04:48:05 +01:00
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
if ( ! is_array ( $body ) || ! isset ( $body [ 'offers' ] ) ) {
return ;
}
2012-01-08 04:48:05 +01:00
2018-02-06 12:04:34 +01:00
$offers = $body [ 'offers' ];
2011-06-10 07:47:44 +02:00
foreach ( $offers as & $offer ) {
foreach ( $offer as $offer_key => $value ) {
2017-12-01 00:11:00 +01:00
if ( 'packages' == $offer_key ) {
$offer [ 'packages' ] = ( object ) array_intersect_key (
array_map ( 'esc_url' , $offer [ 'packages' ] ),
array_fill_keys ( array ( 'full' , 'no_content' , 'new_bundled' , 'partial' , 'rollback' ), '' )
);
} elseif ( 'download' == $offer_key ) {
2011-06-10 07:47:44 +02:00
$offer [ 'download' ] = esc_url ( $value );
2017-12-01 00:11:00 +01:00
} else {
2011-06-10 07:47:44 +02:00
$offer [ $offer_key ] = esc_html ( $value );
2017-12-01 00:11:00 +01:00
}
2011-06-10 07:47:44 +02:00
}
2017-12-01 00:11:00 +01:00
$offer = ( object ) array_intersect_key (
2018-08-17 03:51:36 +02:00
$offer ,
array_fill_keys (
2017-12-01 00:11:00 +01:00
array (
'response' ,
'download' ,
'locale' ,
'packages' ,
'current' ,
'version' ,
'php_version' ,
'mysql_version' ,
'new_bundled' ,
'partial_version' ,
'notify_email' ,
'support_email' ,
'new_files' ,
2018-08-17 03:51:36 +02:00
),
''
2017-12-01 00:11:00 +01:00
)
);
2008-10-31 19:51:06 +01:00
}
2017-12-01 00:11:00 +01:00
$updates = new stdClass ();
$updates -> updates = $offers ;
$updates -> last_checked = time ();
2008-11-04 18:12:03 +01:00
$updates -> version_checked = $wp_version ;
2013-09-30 21:47:12 +02:00
2017-12-01 00:11:00 +01:00
if ( isset ( $body [ 'translations' ] ) ) {
2013-09-30 21:47:12 +02:00
$updates -> translations = $body [ 'translations' ];
2017-12-01 00:11:00 +01:00
}
2013-09-30 21:47:12 +02:00
2014-04-15 04:23:16 +02:00
set_site_transient ( 'update_core' , $updates );
if ( ! empty ( $body [ 'ttl' ] ) ) {
$ttl = ( int ) $body [ 'ttl' ];
if ( $ttl && ( time () + $ttl < wp_next_scheduled ( 'wp_version_check' ) ) ) {
// Queue an event to re-run the update check in $ttl seconds.
wp_schedule_single_event ( time () + $ttl , 'wp_version_check' );
}
}
2016-01-06 07:12:26 +01:00
// Trigger background updates if running non-interactively, and we weren't called from the update handler.
2018-02-06 12:04:34 +01:00
if ( $doing_cron && ! doing_action ( 'wp_maybe_auto_update' ) ) {
2019-01-16 04:38:49 +01:00
/**
* Fires during wp_cron , starting the auto update process .
*
* @ since 3.9 . 0
*/
2018-02-06 12:04:34 +01:00
do_action ( 'wp_maybe_auto_update' );
2014-04-15 04:23:16 +02:00
}
2007-08-17 12:33:52 +02:00
}
2008-07-12 00:04:03 +02:00
/**
2008-08-12 23:21:11 +02:00
* Check plugin versions against the latest versions hosted on WordPress . org .
2008-07-12 00:04:03 +02:00
*
2008-08-12 23:21:11 +02:00
* The WordPress version , PHP version , and Locale is sent along with a list of
* all plugins installed . Checks against the WordPress server at
2008-09-18 19:32:18 +02:00
* api . wordpress . org . Will only check if WordPress isn ' t installing .
2008-07-12 00:04:03 +02:00
*
2008-08-27 08:45:13 +02:00
* @ since 2.3 . 0
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
* @ global string $wp_version Used to notify the WordPress version .
2008-07-12 00:04:03 +02:00
*
2014-04-02 15:05:15 +02:00
* @ param array $extra_stats Extra statistics to report to the WordPress . org API .
2008-07-12 00:04:03 +02:00
*/
2014-04-02 15:05:15 +02:00
function wp_update_plugins ( $extra_stats = array () ) {
Use `wp_installing()` instead of `WP_INSTALLING` constant.
The `WP_INSTALLING` constant is a flag that WordPress sets in a number of
places, telling the system that options should be fetched directly from the
database instead of from the cache, that WP should not ping wordpress.org for
updates, that the normal "not installed" checks should be bypassed, and so on.
A constant is generally necessary for this purpose, because the flag is
typically set before the WP bootstrap, meaning that WP functions are not yet
available. However, it is possible - notably, during `wpmu_create_blog()` -
for the "installing" flag to be set after WP has already loaded. In these
cases, `WP_INSTALLING` would be set for the remainder of the process, since
there's no way to change a constant once it's defined. This, in turn, polluted
later function calls that ought to have been outside the scope of site
creation, particularly the non-caching of option data. The problem was
particularly evident in the case of the automated tests, where `WP_INSTALLING`
was set the first time a site was created, and remained set for the rest of the
suite.
The new `wp_installing()` function allows developers to fetch the current
installation status (when called without any arguments) or to set the
installation status (when called with a boolean `true` or `false`). Use of
the `WP_INSTALLING` constant is still supported; `wp_installing()` will default
to `true` if the constant is defined during the bootstrap.
Props boonebgorges, jeremyfelt.
See #31130.
Built from https://develop.svn.wordpress.org/trunk@34828
git-svn-id: http://core.svn.wordpress.org/trunk@34793 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-10-05 17:06:28 +02:00
if ( wp_installing () ) {
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
return ;
}
2008-07-12 00:04:03 +02:00
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
// include an unmodified $wp_version
include ( ABSPATH . WPINC . '/version.php' );
2008-07-12 00:04:03 +02:00
// If running blog-side, bail unless we've not checked in the last 12 hours
2017-12-01 00:11:00 +01:00
if ( ! function_exists ( 'get_plugins' ) ) {
2008-07-12 00:04:03 +02:00
require_once ( ABSPATH . 'wp-admin/includes/plugin.php' );
2017-12-01 00:11:00 +01:00
}
2008-07-12 00:04:03 +02:00
2017-12-01 00:11:00 +01:00
$plugins = get_plugins ();
2013-09-21 06:08:10 +02:00
$translations = wp_get_installed_translations ( 'plugins' );
2013-09-20 21:13:09 +02:00
2010-01-26 19:39:12 +01:00
$active = get_option ( 'active_plugins' , array () );
2010-01-08 21:49:55 +01:00
$current = get_site_transient ( 'update_plugins' );
2017-12-01 00:11:00 +01:00
if ( ! is_object ( $current ) ) {
2008-11-26 13:04:29 +01:00
$current = new stdClass ;
2017-12-01 00:11:00 +01:00
}
2008-07-12 00:04:03 +02:00
2017-12-01 00:11:00 +01:00
$new_option = new stdClass ;
2008-07-12 00:04:03 +02:00
$new_option -> last_checked = time ();
2017-05-06 16:30:40 +02:00
$doing_cron = wp_doing_cron ();
2012-01-05 20:49:47 +01:00
// Check for update on a different schedule, depending on the page.
switch ( current_filter () ) {
2017-12-01 00:11:00 +01:00
case 'upgrader_process_complete' :
2013-09-23 04:08:10 +02:00
$timeout = 0 ;
break ;
2017-12-01 00:11:00 +01:00
case 'load-update-core.php' :
2012-09-25 07:26:19 +02:00
$timeout = MINUTE_IN_SECONDS ;
2012-01-05 20:49:47 +01:00
break ;
2017-12-01 00:11:00 +01:00
case 'load-plugins.php' :
case 'load-update.php' :
2012-09-25 07:26:19 +02:00
$timeout = HOUR_IN_SECONDS ;
2012-01-05 20:49:47 +01:00
break ;
2017-12-01 00:11:00 +01:00
default :
2017-05-06 16:30:40 +02:00
if ( $doing_cron ) {
2018-01-24 05:17:30 +01:00
$timeout = 2 * HOUR_IN_SECONDS ;
2014-04-15 04:23:16 +02:00
} else {
$timeout = 12 * HOUR_IN_SECONDS ;
}
2011-11-16 08:23:15 +01:00
}
2012-02-27 20:46:52 +01:00
2012-01-05 20:49:47 +01:00
$time_not_changed = isset ( $current -> last_checked ) && $timeout > ( time () - $current -> last_checked );
2011-11-16 02:58:13 +01:00
2014-04-02 15:05:15 +02:00
if ( $time_not_changed && ! $extra_stats ) {
2012-01-05 20:49:47 +01:00
$plugin_changed = false ;
foreach ( $plugins as $file => $p ) {
$new_option -> checked [ $file ] = $p [ 'Version' ];
2017-12-01 00:11:00 +01:00
if ( ! isset ( $current -> checked [ $file ] ) || strval ( $current -> checked [ $file ] ) !== strval ( $p [ 'Version' ] ) ) {
2011-11-16 08:23:15 +01:00
$plugin_changed = true ;
2017-12-01 00:11:00 +01:00
}
2012-01-05 20:49:47 +01:00
}
2017-12-01 00:11:00 +01:00
if ( isset ( $current -> response ) && is_array ( $current -> response ) ) {
2012-01-05 20:49:47 +01:00
foreach ( $current -> response as $plugin_file => $update_details ) {
2017-12-01 00:11:00 +01:00
if ( ! isset ( $plugins [ $plugin_file ] ) ) {
2012-01-05 20:49:47 +01:00
$plugin_changed = true ;
break ;
}
2011-11-16 08:23:15 +01:00
}
2008-07-16 23:53:32 +02:00
}
2012-01-05 20:49:47 +01:00
// Bail if we've checked recently and if nothing has changed
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
if ( ! $plugin_changed ) {
return ;
}
2012-01-05 20:49:47 +01:00
}
2011-11-16 08:23:15 +01:00
2008-11-26 12:48:05 +01:00
// Update last_checked for current to prevent multiple blocking requests if request hangs
$current -> last_checked = time ();
2010-01-08 21:49:55 +01:00
set_site_transient ( 'update_plugins' , $current );
2008-11-26 12:48:05 +01:00
2013-09-20 07:55:09 +02:00
$to_send = compact ( 'plugins' , 'active' );
2008-07-12 00:04:03 +02:00
2016-02-23 17:17:26 +01:00
$locales = array_values ( get_available_languages () );
2016-03-16 17:15:28 +01:00
2013-09-28 06:18:12 +02:00
/**
2016-05-22 20:50:28 +02:00
* Filters the locales requested for plugin translations .
2013-09-28 06:18:12 +02:00
*
* @ since 3.7 . 0
2016-03-11 00:01:26 +01:00
* @ since 4.5 . 0 The default value of the `$locales` parameter changed to include all locales .
2013-09-28 06:18:12 +02:00
*
2016-02-23 17:17:26 +01:00
* @ param array $locales Plugin locales . Default is all available locales of the site .
2013-09-28 06:18:12 +02:00
*/
2016-02-23 17:17:26 +01:00
$locales = apply_filters ( 'plugins_update_check_locales' , $locales );
$locales = array_unique ( $locales );
2013-09-28 06:18:12 +02:00
2017-05-06 16:30:40 +02:00
if ( $doing_cron ) {
2014-06-20 01:21:16 +02:00
$timeout = 30 ;
} else {
2014-06-23 16:31:14 +02:00
// Three seconds, plus one extra second for every 10 plugins
2014-06-24 18:06:14 +02:00
$timeout = 3 + ( int ) ( count ( $plugins ) / 10 );
2014-06-20 01:21:16 +02:00
}
2008-12-21 22:52:15 +01:00
$options = array (
2017-12-01 00:11:00 +01:00
'timeout' => $timeout ,
'body' => array (
2014-10-28 19:35:19 +01:00
'plugins' => wp_json_encode ( $to_send ),
'translations' => wp_json_encode ( $translations ),
'locale' => wp_json_encode ( $locales ),
'all' => wp_json_encode ( true ),
2013-09-21 06:08:10 +02:00
),
2017-12-01 00:11:00 +01:00
'user-agent' => 'WordPress/' . $wp_version . '; ' . home_url ( '/' ),
2008-12-21 22:52:15 +01:00
);
2008-08-12 23:21:11 +02:00
2014-04-02 15:13:15 +02:00
if ( $extra_stats ) {
2014-10-28 19:35:19 +01:00
$options [ 'body' ][ 'update_stats' ] = wp_json_encode ( $extra_stats );
2014-04-02 15:05:15 +02:00
}
2013-10-27 22:09:10 +01:00
$url = $http_url = 'http://api.wordpress.org/plugins/update-check/1.1/' ;
2017-12-01 00:11:00 +01:00
if ( $ssl = wp_http_supports ( array ( 'ssl' ) ) ) {
2013-09-09 09:54:11 +02:00
$url = set_url_scheme ( $url , 'https' );
2017-12-01 00:11:00 +01:00
}
2013-09-09 09:54:11 +02:00
$raw_response = wp_remote_post ( $url , $options );
2013-10-27 22:09:10 +01:00
if ( $ssl && is_wp_error ( $raw_response ) ) {
2016-11-21 02:52:32 +01:00
trigger_error (
sprintf (
/* translators: %s: support forums URL */
__ ( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server’s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),
__ ( 'https://wordpress.org/support/' )
) . ' ' . __ ( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ),
headers_sent () || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE
);
2013-10-27 22:09:10 +01:00
$raw_response = wp_remote_post ( $http_url , $options );
}
2008-08-12 23:21:11 +02:00
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
if ( is_wp_error ( $raw_response ) || 200 != wp_remote_retrieve_response_code ( $raw_response ) ) {
return ;
}
2008-07-12 00:04:03 +02:00
2013-09-21 06:08:10 +02:00
$response = json_decode ( wp_remote_retrieve_body ( $raw_response ), true );
foreach ( $response [ 'plugins' ] as & $plugin ) {
$plugin = ( object ) $plugin ;
2016-01-06 08:53:26 +01:00
if ( isset ( $plugin -> compatibility ) ) {
$plugin -> compatibility = ( object ) $plugin -> compatibility ;
foreach ( $plugin -> compatibility as & $data ) {
$data = ( object ) $data ;
}
}
2013-09-21 06:08:10 +02:00
}
2016-01-06 08:53:26 +01:00
unset ( $plugin , $data );
2014-07-18 22:49:17 +02:00
foreach ( $response [ 'no_update' ] as & $plugin ) {
$plugin = ( object ) $plugin ;
}
unset ( $plugin );
2008-07-12 00:04:03 +02:00
2013-09-21 06:08:10 +02:00
if ( is_array ( $response ) ) {
2017-12-01 00:11:00 +01:00
$new_option -> response = $response [ 'plugins' ];
2013-09-21 06:08:10 +02:00
$new_option -> translations = $response [ 'translations' ];
2014-07-18 22:49:17 +02:00
// TODO: Perhaps better to store no_update in a separate transient with an expiry?
$new_option -> no_update = $response [ 'no_update' ];
2013-09-21 06:08:10 +02:00
} else {
2017-12-01 00:11:00 +01:00
$new_option -> response = array ();
2013-09-21 11:34:09 +02:00
$new_option -> translations = array ();
2017-12-01 00:11:00 +01:00
$new_option -> no_update = array ();
2013-09-21 06:08:10 +02:00
}
2008-07-12 00:04:03 +02:00
2010-01-08 21:49:55 +01:00
set_site_transient ( 'update_plugins' , $new_option );
2008-07-12 00:04:03 +02:00
}
2008-08-01 06:26:32 +02:00
2008-09-15 18:21:15 +02:00
/**
* Check theme versions against the latest versions hosted on WordPress . org .
*
2008-12-09 19:03:31 +01:00
* A list of all themes installed in sent to WP . Checks against the
2008-09-18 19:32:18 +02:00
* WordPress server at api . wordpress . org . Will only check if WordPress isn ' t
* installing .
2008-09-15 18:21:15 +02:00
*
* @ since 2.7 . 0
*
2014-04-02 15:05:15 +02:00
* @ param array $extra_stats Extra statistics to report to the WordPress . org API .
2008-09-15 18:21:15 +02:00
*/
2014-04-02 15:05:15 +02:00
function wp_update_themes ( $extra_stats = array () ) {
Use `wp_installing()` instead of `WP_INSTALLING` constant.
The `WP_INSTALLING` constant is a flag that WordPress sets in a number of
places, telling the system that options should be fetched directly from the
database instead of from the cache, that WP should not ping wordpress.org for
updates, that the normal "not installed" checks should be bypassed, and so on.
A constant is generally necessary for this purpose, because the flag is
typically set before the WP bootstrap, meaning that WP functions are not yet
available. However, it is possible - notably, during `wpmu_create_blog()` -
for the "installing" flag to be set after WP has already loaded. In these
cases, `WP_INSTALLING` would be set for the remainder of the process, since
there's no way to change a constant once it's defined. This, in turn, polluted
later function calls that ought to have been outside the scope of site
creation, particularly the non-caching of option data. The problem was
particularly evident in the case of the automated tests, where `WP_INSTALLING`
was set the first time a site was created, and remained set for the rest of the
suite.
The new `wp_installing()` function allows developers to fetch the current
installation status (when called without any arguments) or to set the
installation status (when called with a boolean `true` or `false`). Use of
the `WP_INSTALLING` constant is still supported; `wp_installing()` will default
to `true` if the constant is defined during the bootstrap.
Props boonebgorges, jeremyfelt.
See #31130.
Built from https://develop.svn.wordpress.org/trunk@34828
git-svn-id: http://core.svn.wordpress.org/trunk@34793 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-10-05 17:06:28 +02:00
if ( wp_installing () ) {
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
return ;
}
2015-12-06 18:39:27 +01:00
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
// include an unmodified $wp_version
include ( ABSPATH . WPINC . '/version.php' );
2008-09-15 18:21:15 +02:00
Introduce WP_Theme, wp_get_themes(), and wp_get_theme() to replace get_themes(), get_theme(), get_theme_data(), current_theme_info(), and others.
* Getters and Helpers: Introduces a series of methods to allow for easy generation of headers for display, and other theme metadata, including page templates.
* Screenshots: Handles support for multiple screenshots. (see # Additional screenshots must be PNG and start with screenshot-2.png, and be sequential to be counted. see #19816.
* Error Handling: Broken themes have a WP_Error object attached to them.
* Caching: Introduces a wp_cache_themes_persistently filter (also in [20020]) to enable persistent caching of all filesystem and sanitization operations normally handled by WP_Theme (and formerly get_file_data() and get_themes()). Themes are cached individually and across five different cache keys for different data pieces.
* Compatibility: A WP_Theme object is backwards compatible with a theme's array formerly returned by get_themes() and get_theme(), and an stdClass object formerly returned by current_theme_info().
* i18n/L10n: Theme headers are now localizable with proper Text Domain and Domain Path headers, like plugins. (Language packs may remove the requirement for headers.) For page templates, see #6007 (not fixed yet, but will be easy now). For headers, fixes #15858.
* PHP and CSS files: New methods that fetch a list of theme files (for the theme editor) only on demand, rather than only loading them into memory. fixes #11214.
Functions deprecated:
* get_themes(), get_allowed_themes() and get_broken_themes() -- use wp_get_themes()
* get_theme() and current_theme_info() -- use wp_get_theme()
* get_site_allowed_themes() -- use WP_Theme::get_allowed_on_network()
* wpmu_get_blog_allowedthemes() -- use WP_theme::get_allowed_on_site()
see also [20016], [20018], [20019], [20020], [20021], [20022], [20025], [20026], [20027]. also fixes #19244.
see #20103.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20029 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-28 22:24:44 +01:00
$installed_themes = wp_get_themes ();
2017-12-01 00:11:00 +01:00
$translations = wp_get_installed_translations ( 'themes' );
2013-09-20 21:13:09 +02:00
2010-07-22 15:24:41 +02:00
$last_update = get_site_transient ( 'update_themes' );
2017-12-01 00:11:00 +01:00
if ( ! is_object ( $last_update ) ) {
2010-07-22 15:24:41 +02:00
$last_update = new stdClass ;
2017-12-01 00:11:00 +01:00
}
2008-09-15 18:21:15 +02:00
2013-09-20 07:55:09 +02:00
$themes = $checked = $request = array ();
2010-07-22 15:24:41 +02:00
// Put slug of current theme into request.
2013-09-20 07:55:09 +02:00
$request [ 'active' ] = get_option ( 'stylesheet' );
2010-07-22 15:24:41 +02:00
Introduce WP_Theme, wp_get_themes(), and wp_get_theme() to replace get_themes(), get_theme(), get_theme_data(), current_theme_info(), and others.
* Getters and Helpers: Introduces a series of methods to allow for easy generation of headers for display, and other theme metadata, including page templates.
* Screenshots: Handles support for multiple screenshots. (see # Additional screenshots must be PNG and start with screenshot-2.png, and be sequential to be counted. see #19816.
* Error Handling: Broken themes have a WP_Error object attached to them.
* Caching: Introduces a wp_cache_themes_persistently filter (also in [20020]) to enable persistent caching of all filesystem and sanitization operations normally handled by WP_Theme (and formerly get_file_data() and get_themes()). Themes are cached individually and across five different cache keys for different data pieces.
* Compatibility: A WP_Theme object is backwards compatible with a theme's array formerly returned by get_themes() and get_theme(), and an stdClass object formerly returned by current_theme_info().
* i18n/L10n: Theme headers are now localizable with proper Text Domain and Domain Path headers, like plugins. (Language packs may remove the requirement for headers.) For page templates, see #6007 (not fixed yet, but will be easy now). For headers, fixes #15858.
* PHP and CSS files: New methods that fetch a list of theme files (for the theme editor) only on demand, rather than only loading them into memory. fixes #11214.
Functions deprecated:
* get_themes(), get_allowed_themes() and get_broken_themes() -- use wp_get_themes()
* get_theme() and current_theme_info() -- use wp_get_theme()
* get_site_allowed_themes() -- use WP_Theme::get_allowed_on_network()
* wpmu_get_blog_allowedthemes() -- use WP_theme::get_allowed_on_site()
see also [20016], [20018], [20019], [20020], [20021], [20022], [20025], [20026], [20027]. also fixes #19244.
see #20103.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20029 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-28 22:24:44 +01:00
foreach ( $installed_themes as $theme ) {
2017-12-01 00:11:00 +01:00
$checked [ $theme -> get_stylesheet () ] = $theme -> get ( 'Version' );
Introduce WP_Theme, wp_get_themes(), and wp_get_theme() to replace get_themes(), get_theme(), get_theme_data(), current_theme_info(), and others.
* Getters and Helpers: Introduces a series of methods to allow for easy generation of headers for display, and other theme metadata, including page templates.
* Screenshots: Handles support for multiple screenshots. (see # Additional screenshots must be PNG and start with screenshot-2.png, and be sequential to be counted. see #19816.
* Error Handling: Broken themes have a WP_Error object attached to them.
* Caching: Introduces a wp_cache_themes_persistently filter (also in [20020]) to enable persistent caching of all filesystem and sanitization operations normally handled by WP_Theme (and formerly get_file_data() and get_themes()). Themes are cached individually and across five different cache keys for different data pieces.
* Compatibility: A WP_Theme object is backwards compatible with a theme's array formerly returned by get_themes() and get_theme(), and an stdClass object formerly returned by current_theme_info().
* i18n/L10n: Theme headers are now localizable with proper Text Domain and Domain Path headers, like plugins. (Language packs may remove the requirement for headers.) For page templates, see #6007 (not fixed yet, but will be easy now). For headers, fixes #15858.
* PHP and CSS files: New methods that fetch a list of theme files (for the theme editor) only on demand, rather than only loading them into memory. fixes #11214.
Functions deprecated:
* get_themes(), get_allowed_themes() and get_broken_themes() -- use wp_get_themes()
* get_theme() and current_theme_info() -- use wp_get_theme()
* get_site_allowed_themes() -- use WP_Theme::get_allowed_on_network()
* wpmu_get_blog_allowedthemes() -- use WP_theme::get_allowed_on_site()
see also [20016], [20018], [20019], [20020], [20021], [20022], [20025], [20026], [20027]. also fixes #19244.
see #20103.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20029 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-28 22:24:44 +01:00
$themes [ $theme -> get_stylesheet () ] = array (
2017-12-01 00:11:00 +01:00
'Name' => $theme -> get ( 'Name' ),
'Title' => $theme -> get ( 'Name' ),
'Version' => $theme -> get ( 'Version' ),
'Author' => $theme -> get ( 'Author' ),
'Author URI' => $theme -> get ( 'AuthorURI' ),
Introduce WP_Theme, wp_get_themes(), and wp_get_theme() to replace get_themes(), get_theme(), get_theme_data(), current_theme_info(), and others.
* Getters and Helpers: Introduces a series of methods to allow for easy generation of headers for display, and other theme metadata, including page templates.
* Screenshots: Handles support for multiple screenshots. (see # Additional screenshots must be PNG and start with screenshot-2.png, and be sequential to be counted. see #19816.
* Error Handling: Broken themes have a WP_Error object attached to them.
* Caching: Introduces a wp_cache_themes_persistently filter (also in [20020]) to enable persistent caching of all filesystem and sanitization operations normally handled by WP_Theme (and formerly get_file_data() and get_themes()). Themes are cached individually and across five different cache keys for different data pieces.
* Compatibility: A WP_Theme object is backwards compatible with a theme's array formerly returned by get_themes() and get_theme(), and an stdClass object formerly returned by current_theme_info().
* i18n/L10n: Theme headers are now localizable with proper Text Domain and Domain Path headers, like plugins. (Language packs may remove the requirement for headers.) For page templates, see #6007 (not fixed yet, but will be easy now). For headers, fixes #15858.
* PHP and CSS files: New methods that fetch a list of theme files (for the theme editor) only on demand, rather than only loading them into memory. fixes #11214.
Functions deprecated:
* get_themes(), get_allowed_themes() and get_broken_themes() -- use wp_get_themes()
* get_theme() and current_theme_info() -- use wp_get_theme()
* get_site_allowed_themes() -- use WP_Theme::get_allowed_on_network()
* wpmu_get_blog_allowedthemes() -- use WP_theme::get_allowed_on_site()
see also [20016], [20018], [20019], [20020], [20021], [20022], [20025], [20026], [20027]. also fixes #19244.
see #20103.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20029 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-28 22:24:44 +01:00
'Template' => $theme -> get_template (),
'Stylesheet' => $theme -> get_stylesheet (),
);
2008-09-15 18:21:15 +02:00
}
2017-05-06 16:30:40 +02:00
$doing_cron = wp_doing_cron ();
2012-01-05 20:49:47 +01:00
// Check for update on a different schedule, depending on the page.
switch ( current_filter () ) {
2017-12-01 00:11:00 +01:00
case 'upgrader_process_complete' :
2013-09-23 04:08:10 +02:00
$timeout = 0 ;
break ;
2017-12-01 00:11:00 +01:00
case 'load-update-core.php' :
2012-09-25 07:26:19 +02:00
$timeout = MINUTE_IN_SECONDS ;
2012-01-05 20:49:47 +01:00
break ;
2017-12-01 00:11:00 +01:00
case 'load-themes.php' :
case 'load-update.php' :
2012-09-25 07:26:19 +02:00
$timeout = HOUR_IN_SECONDS ;
2012-01-05 20:49:47 +01:00
break ;
2017-12-01 00:11:00 +01:00
default :
2018-01-24 05:17:30 +01:00
if ( $doing_cron ) {
$timeout = 2 * HOUR_IN_SECONDS ;
} else {
$timeout = 12 * HOUR_IN_SECONDS ;
}
2011-11-16 08:23:15 +01:00
}
2012-02-27 20:46:52 +01:00
2013-01-04 11:13:51 +01:00
$time_not_changed = isset ( $last_update -> last_checked ) && $timeout > ( time () - $last_update -> last_checked );
2012-01-05 20:49:47 +01:00
2014-04-02 15:05:15 +02:00
if ( $time_not_changed && ! $extra_stats ) {
2012-01-05 20:49:47 +01:00
$theme_changed = false ;
foreach ( $checked as $slug => $v ) {
2017-12-01 00:11:00 +01:00
if ( ! isset ( $last_update -> checked [ $slug ] ) || strval ( $last_update -> checked [ $slug ] ) !== strval ( $v ) ) {
2011-11-16 08:23:15 +01:00
$theme_changed = true ;
2017-12-01 00:11:00 +01:00
}
2012-01-05 20:49:47 +01:00
}
2017-12-01 00:11:00 +01:00
if ( isset ( $last_update -> response ) && is_array ( $last_update -> response ) ) {
2012-01-05 20:49:47 +01:00
foreach ( $last_update -> response as $slug => $update_details ) {
2017-12-01 00:11:00 +01:00
if ( ! isset ( $checked [ $slug ] ) ) {
2012-01-05 20:49:47 +01:00
$theme_changed = true ;
break ;
}
2011-11-16 08:23:15 +01:00
}
2009-07-14 10:34:39 +02:00
}
2012-01-05 20:49:47 +01:00
// Bail if we've checked recently and if nothing has changed
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
if ( ! $theme_changed ) {
return ;
}
2012-01-05 20:49:47 +01:00
}
2011-11-16 08:23:15 +01:00
2009-07-14 10:34:39 +02:00
// Update last_checked for current to prevent multiple blocking requests if request hangs
2010-07-22 15:24:41 +02:00
$last_update -> last_checked = time ();
set_site_transient ( 'update_themes' , $last_update );
2009-07-14 10:34:39 +02:00
2013-09-20 07:55:09 +02:00
$request [ 'themes' ] = $themes ;
2016-02-23 17:17:26 +01:00
$locales = array_values ( get_available_languages () );
2016-03-16 17:15:28 +01:00
2013-09-28 06:18:12 +02:00
/**
2016-05-22 20:50:28 +02:00
* Filters the locales requested for theme translations .
2013-09-28 06:18:12 +02:00
*
* @ since 3.7 . 0
2016-03-11 00:01:26 +01:00
* @ since 4.5 . 0 The default value of the `$locales` parameter changed to include all locales .
2013-09-28 06:18:12 +02:00
*
2016-02-23 17:17:26 +01:00
* @ param array $locales Theme locales . Default is all available locales of the site .
2013-09-28 06:18:12 +02:00
*/
2016-02-23 17:17:26 +01:00
$locales = apply_filters ( 'themes_update_check_locales' , $locales );
$locales = array_unique ( $locales );
2013-09-28 06:18:12 +02:00
2017-05-06 16:30:40 +02:00
if ( $doing_cron ) {
2014-06-20 01:21:16 +02:00
$timeout = 30 ;
} else {
2014-06-23 16:31:14 +02:00
// Three seconds, plus one extra second for every 10 themes
2014-06-24 18:06:14 +02:00
$timeout = 3 + ( int ) ( count ( $themes ) / 10 );
2014-06-20 01:21:16 +02:00
}
2008-09-15 18:21:15 +02:00
$options = array (
2017-12-01 00:11:00 +01:00
'timeout' => $timeout ,
'body' => array (
2014-10-28 19:35:19 +01:00
'themes' => wp_json_encode ( $request ),
'translations' => wp_json_encode ( $translations ),
'locale' => wp_json_encode ( $locales ),
2013-09-21 06:08:10 +02:00
),
2017-12-01 00:11:00 +01:00
'user-agent' => 'WordPress/' . $wp_version . '; ' . home_url ( '/' ),
2008-09-15 18:21:15 +02:00
);
2014-04-02 15:13:15 +02:00
if ( $extra_stats ) {
2014-10-28 19:35:19 +01:00
$options [ 'body' ][ 'update_stats' ] = wp_json_encode ( $extra_stats );
2014-04-02 15:05:15 +02:00
}
2013-10-27 22:09:10 +01:00
$url = $http_url = 'http://api.wordpress.org/themes/update-check/1.1/' ;
2017-12-01 00:11:00 +01:00
if ( $ssl = wp_http_supports ( array ( 'ssl' ) ) ) {
2013-09-09 09:54:11 +02:00
$url = set_url_scheme ( $url , 'https' );
2017-12-01 00:11:00 +01:00
}
2013-09-09 09:54:11 +02:00
$raw_response = wp_remote_post ( $url , $options );
2013-10-27 22:09:10 +01:00
if ( $ssl && is_wp_error ( $raw_response ) ) {
2016-11-21 02:52:32 +01:00
trigger_error (
sprintf (
/* translators: %s: support forums URL */
__ ( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server’s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),
__ ( 'https://wordpress.org/support/' )
) . ' ' . __ ( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ),
headers_sent () || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE
);
2013-10-27 22:09:10 +01:00
$raw_response = wp_remote_post ( $http_url , $options );
}
2008-09-15 18:21:15 +02:00
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
if ( is_wp_error ( $raw_response ) || 200 != wp_remote_retrieve_response_code ( $raw_response ) ) {
return ;
}
2008-09-15 18:21:15 +02:00
2017-12-01 00:11:00 +01:00
$new_update = new stdClass ;
2013-01-04 11:13:51 +01:00
$new_update -> last_checked = time ();
2017-12-01 00:11:00 +01:00
$new_update -> checked = $checked ;
2011-04-07 11:56:20 +02:00
2013-09-14 21:58:09 +02:00
$response = json_decode ( wp_remote_retrieve_body ( $raw_response ), true );
2013-09-20 07:55:09 +02:00
2013-09-21 06:08:10 +02:00
if ( is_array ( $response ) ) {
$new_update -> response = $response [ 'themes' ];
$new_update -> translations = $response [ 'translations' ];
}
2008-09-15 18:21:15 +02:00
2010-07-22 15:24:41 +02:00
set_site_transient ( 'update_themes' , $new_update );
2013-09-13 08:19:12 +02:00
}
/**
2013-10-17 02:55:09 +02:00
* Performs WordPress automatic background updates .
2013-09-13 08:19:12 +02:00
*
* @ since 3.7 . 0
*/
2013-10-17 02:55:09 +02:00
function wp_maybe_auto_update () {
2014-05-19 07:04:16 +02:00
include_once ( ABSPATH . '/wp-admin/includes/admin.php' );
2016-08-31 18:31:29 +02:00
include_once ( ABSPATH . '/wp-admin/includes/class-wp-upgrader.php' );
2013-09-13 08:19:12 +02:00
2013-10-25 00:54:38 +02:00
$upgrader = new WP_Automatic_Updater ;
2013-10-17 02:55:09 +02:00
$upgrader -> run ();
2008-09-15 18:21:15 +02:00
}
2013-10-16 16:34:10 +02:00
/**
* Retrieves a list of all language updates available .
*
* @ since 3.7 . 0
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
*
2018-03-22 21:27:32 +01:00
* @ return object [] Array of translation objects that have available updates .
2013-10-16 16:34:10 +02:00
*/
function wp_get_translation_updates () {
2017-12-01 00:11:00 +01:00
$updates = array ();
$transients = array (
'update_core' => 'core' ,
'update_plugins' => 'plugin' ,
'update_themes' => 'theme' ,
);
2013-10-16 16:34:10 +02:00
foreach ( $transients as $transient => $type ) {
$transient = get_site_transient ( $transient );
2017-12-01 00:11:00 +01:00
if ( empty ( $transient -> translations ) ) {
2013-10-16 16:34:10 +02:00
continue ;
2017-12-01 00:11:00 +01:00
}
2013-10-16 16:34:10 +02:00
foreach ( $transient -> translations as $translation ) {
$updates [] = ( object ) $translation ;
}
}
return $updates ;
}
2013-11-11 14:32:10 +01:00
/**
2011-07-26 20:39:57 +02:00
* Collect counts and UI strings for available updates
*
* @ since 3.3 . 0
*
* @ return array
*/
function wp_get_update_data () {
2017-12-01 00:11:00 +01:00
$counts = array (
'plugins' => 0 ,
'themes' => 0 ,
'wordpress' => 0 ,
'translations' => 0 ,
);
2011-07-26 20:39:57 +02:00
2013-10-16 16:34:10 +02:00
if ( $plugins = current_user_can ( 'update_plugins' ) ) {
2011-07-26 20:39:57 +02:00
$update_plugins = get_site_transient ( 'update_plugins' );
2017-12-01 00:11:00 +01:00
if ( ! empty ( $update_plugins -> response ) ) {
2011-07-26 20:39:57 +02:00
$counts [ 'plugins' ] = count ( $update_plugins -> response );
2017-12-01 00:11:00 +01:00
}
2011-07-26 20:39:57 +02:00
}
2013-10-16 16:34:10 +02:00
if ( $themes = current_user_can ( 'update_themes' ) ) {
2011-07-26 20:39:57 +02:00
$update_themes = get_site_transient ( 'update_themes' );
2017-12-01 00:11:00 +01:00
if ( ! empty ( $update_themes -> response ) ) {
2011-07-26 20:39:57 +02:00
$counts [ 'themes' ] = count ( $update_themes -> response );
2017-12-01 00:11:00 +01:00
}
2011-07-26 20:39:57 +02:00
}
2013-10-16 16:34:10 +02:00
if ( ( $core = current_user_can ( 'update_core' ) ) && function_exists ( 'get_core_updates' ) ) {
2017-12-01 00:11:00 +01:00
$update_wordpress = get_core_updates ( array ( 'dismissed' => false ) );
if ( ! empty ( $update_wordpress ) && ! in_array ( $update_wordpress [ 0 ] -> response , array ( 'development' , 'latest' ) ) && current_user_can ( 'update_core' ) ) {
2011-07-26 20:39:57 +02:00
$counts [ 'wordpress' ] = 1 ;
2017-12-01 00:11:00 +01:00
}
2011-07-26 20:39:57 +02:00
}
2017-12-01 00:11:00 +01:00
if ( ( $core || $plugins || $themes ) && wp_get_translation_updates () ) {
2013-10-16 16:34:10 +02:00
$counts [ 'translations' ] = 1 ;
2017-12-01 00:11:00 +01:00
}
2013-10-16 16:34:10 +02:00
$counts [ 'total' ] = $counts [ 'plugins' ] + $counts [ 'themes' ] + $counts [ 'wordpress' ] + $counts [ 'translations' ];
2017-12-01 00:11:00 +01:00
$titles = array ();
2016-11-21 03:46:30 +01:00
if ( $counts [ 'wordpress' ] ) {
2018-03-11 17:44:34 +01:00
/* translators: %d: number of updates available to WordPress */
2017-12-01 00:11:00 +01:00
$titles [ 'wordpress' ] = sprintf ( __ ( '%d WordPress Update' ), $counts [ 'wordpress' ] );
2016-11-21 03:46:30 +01:00
}
if ( $counts [ 'plugins' ] ) {
2018-03-11 17:44:34 +01:00
/* translators: %d: number of updates available to plugins */
2012-09-16 22:51:51 +02:00
$titles [ 'plugins' ] = sprintf ( _n ( '%d Plugin Update' , '%d Plugin Updates' , $counts [ 'plugins' ] ), $counts [ 'plugins' ] );
2016-11-21 03:46:30 +01:00
}
if ( $counts [ 'themes' ] ) {
2018-03-11 17:44:34 +01:00
/* translators: %d: number of updates available to themes */
2012-09-16 22:51:51 +02:00
$titles [ 'themes' ] = sprintf ( _n ( '%d Theme Update' , '%d Theme Updates' , $counts [ 'themes' ] ), $counts [ 'themes' ] );
2016-11-21 03:46:30 +01:00
}
if ( $counts [ 'translations' ] ) {
2013-10-16 16:34:10 +02:00
$titles [ 'translations' ] = __ ( 'Translation Updates' );
2016-11-21 03:46:30 +01:00
}
2011-07-26 20:39:57 +02:00
2012-09-16 22:51:51 +02:00
$update_title = $titles ? esc_attr ( implode ( ', ' , $titles ) ) : '' ;
2011-10-24 21:13:23 +02:00
2017-12-01 00:11:00 +01:00
$update_data = array (
'counts' => $counts ,
'title' => $update_title ,
);
2013-10-06 17:31:09 +02:00
/**
2016-05-22 20:50:28 +02:00
* Filters the returned array of update data for plugins , themes , and WordPress core .
2013-10-06 17:31:09 +02:00
*
* @ since 3.5 . 0
*
* @ param array $update_data {
* Fetched update data .
*
* @ type array $counts An array of counts for available plugin , theme , and WordPress updates .
* @ type string $update_title Titles of available updates .
* }
* @ param array $titles An array of update counts and UI strings for available updates .
*/
return apply_filters ( 'wp_get_update_data' , $update_data , $titles );
2011-07-26 20:39:57 +02:00
}
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
/**
2015-12-17 17:38:26 +01:00
* Determines whether core should be updated .
*
* @ since 2.8 . 0
*
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
* @ global string $wp_version
*/
2009-02-17 01:13:25 +01:00
function _maybe_update_core () {
2015-12-06 18:39:27 +01:00
// include an unmodified $wp_version
include ( ABSPATH . WPINC . '/version.php' );
2009-02-17 01:13:25 +01:00
2010-01-08 21:49:55 +01:00
$current = get_site_transient ( 'update_core' );
2009-02-17 01:13:25 +01:00
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
if ( isset ( $current -> last_checked , $current -> version_checked ) &&
2012-09-25 07:26:19 +02:00
12 * HOUR_IN_SECONDS > ( time () - $current -> last_checked ) &&
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
$current -> version_checked == $wp_version ) {
2009-02-17 01:13:25 +01:00
return ;
Add missing doc blocks to `update.php`:
* `wp_version_check()`, `wp_update_plugins()`, and `wp_update_themes()` do not return meaningful responses, and their responses are never handled by core. As such, they shouldn't alternately return `void` or `false`. "Returning" in those functions is just "bailing"
* In the same functions, `version.php` doesn't need to load if `WP_INSTALLING` is defined - the function will immediately bail, the values will never be read, and the globals won't be reset. I have unified the approach in all 3 functions.
* When returning filtered `$locale`, there is no need to set the variable twice.
* In `_maybe_update_core()`, `isset()` can take multiple values to bail before the call to `time()`, if necessary. This is a micro-optimization to prevent PHP from hitting the OS unnecessarily.
See #32444.
Built from https://develop.svn.wordpress.org/trunk@32635
git-svn-id: http://core.svn.wordpress.org/trunk@32605 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-05-28 17:29:28 +02:00
}
2009-02-17 01:13:25 +01:00
wp_version_check ();
}
2008-09-18 19:32:18 +02:00
/**
* Check the last time plugins were run before checking plugin versions .
*
* This might have been backported to WordPress 2.6 . 1 for performance reasons .
* This is used for the wp - admin to check only so often instead of every page
* load .
*
* @ since 2.7 . 0
* @ access private
*/
2008-08-01 06:26:32 +02:00
function _maybe_update_plugins () {
2010-01-08 21:49:55 +01:00
$current = get_site_transient ( 'update_plugins' );
2017-12-01 00:11:00 +01:00
if ( isset ( $current -> last_checked ) && 12 * HOUR_IN_SECONDS > ( time () - $current -> last_checked ) ) {
2008-08-01 06:26:32 +02:00
return ;
2017-12-01 00:11:00 +01:00
}
2008-08-01 06:26:32 +02:00
wp_update_plugins ();
}
2008-09-18 19:32:18 +02:00
/**
* Check themes versions only after a duration of time .
*
* This is for performance reasons to make sure that on the theme version
* checker is not run on every page load .
*
* @ since 2.7 . 0
* @ access private
*/
2013-01-04 11:13:51 +01:00
function _maybe_update_themes () {
2010-01-08 21:49:55 +01:00
$current = get_site_transient ( 'update_themes' );
2017-12-01 00:11:00 +01:00
if ( isset ( $current -> last_checked ) && 12 * HOUR_IN_SECONDS > ( time () - $current -> last_checked ) ) {
2008-09-15 18:21:15 +02:00
return ;
2017-12-01 00:11:00 +01:00
}
2009-08-16 06:59:38 +02:00
wp_update_themes ();
2008-09-15 18:21:15 +02:00
}
2010-10-20 18:50:57 +02:00
/**
* Schedule core , theme , and plugin update checks .
*
* @ since 3.1 . 0
*/
function wp_schedule_update_checks () {
2017-12-01 00:11:00 +01:00
if ( ! wp_next_scheduled ( 'wp_version_check' ) && ! wp_installing () ) {
wp_schedule_event ( time (), 'twicedaily' , 'wp_version_check' );
}
2010-10-20 18:50:57 +02:00
2017-12-01 00:11:00 +01:00
if ( ! wp_next_scheduled ( 'wp_update_plugins' ) && ! wp_installing () ) {
wp_schedule_event ( time (), 'twicedaily' , 'wp_update_plugins' );
}
2010-10-20 18:50:57 +02:00
2017-12-01 00:11:00 +01:00
if ( ! wp_next_scheduled ( 'wp_update_themes' ) && ! wp_installing () ) {
wp_schedule_event ( time (), 'twicedaily' , 'wp_update_themes' );
}
2010-10-20 18:50:57 +02:00
}
2014-11-24 23:50:22 +01:00
/**
* Clear existing update caches for plugins , themes , and core .
*
* @ since 4.1 . 0
*/
2014-12-15 09:55:22 +01:00
function wp_clean_update_cache () {
if ( function_exists ( 'wp_clean_plugins_cache' ) ) {
wp_clean_plugins_cache ();
} else {
delete_site_transient ( 'update_plugins' );
}
2014-11-24 23:50:22 +01:00
wp_clean_themes_cache ();
delete_site_transient ( 'update_core' );
}
2015-03-11 00:20:26 +01:00
2016-08-23 16:33:30 +02:00
if ( ( ! is_main_site () && ! is_network_admin () ) || wp_doing_ajax () ) {
2015-03-11 00:20:26 +01:00
return ;
}
add_action ( 'admin_init' , '_maybe_update_core' );
add_action ( 'wp_version_check' , 'wp_version_check' );
add_action ( 'load-plugins.php' , 'wp_update_plugins' );
add_action ( 'load-update.php' , 'wp_update_plugins' );
add_action ( 'load-update-core.php' , 'wp_update_plugins' );
add_action ( 'admin_init' , '_maybe_update_plugins' );
add_action ( 'wp_update_plugins' , 'wp_update_plugins' );
add_action ( 'load-themes.php' , 'wp_update_themes' );
add_action ( 'load-update.php' , 'wp_update_themes' );
add_action ( 'load-update-core.php' , 'wp_update_themes' );
add_action ( 'admin_init' , '_maybe_update_themes' );
add_action ( 'wp_update_themes' , 'wp_update_themes' );
2017-12-01 00:11:00 +01:00
add_action ( 'update_option_WPLANG' , 'wp_clean_update_cache' , 10 , 0 );
2015-03-11 00:20:26 +01:00
add_action ( 'wp_maybe_auto_update' , 'wp_maybe_auto_update' );
add_action ( 'init' , 'wp_schedule_update_checks' );