| [ Index ] |
PHP Cross Reference of WordPress Trunk (Updated Daily) |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * A simple set of functions to check the WordPress.org Version Update service. 4 * 5 * @package WordPress 6 * @since 2.3.0 7 */ 8 9 // Don't load directly. 10 if ( ! defined( 'ABSPATH' ) ) { 11 die( '-1' ); 12 } 13 14 /** 15 * Checks WordPress version against the newest version. 16 * 17 * The WordPress version, PHP version, and locale is sent to api.wordpress.org. 18 * 19 * Checks against the WordPress server at api.wordpress.org. Will only check 20 * if WordPress isn't installing. 21 * 22 * @since 2.3.0 23 * 24 * @global string $wp_version Used to check against the newest WordPress version. 25 * @global wpdb $wpdb WordPress database abstraction object. 26 * @global string $wp_local_package Locale code of the package. 27 * 28 * @param array $extra_stats Extra statistics to report to the WordPress.org API. 29 * @param bool $force_check Whether to bypass the transient cache and force a fresh update check. 30 * Defaults to false, true if $extra_stats is set. 31 */ 32 function wp_version_check( $extra_stats = array(), $force_check = false ) { 33 global $wpdb, $wp_local_package; 34 35 if ( wp_installing() ) { 36 return; 37 } 38 39 $php_version = PHP_VERSION; 40 41 $current = get_site_transient( 'update_core' ); 42 $translations = wp_get_installed_translations( 'core' ); 43 44 // Invalidate the transient when $wp_version changes. 45 if ( is_object( $current ) && wp_get_wp_version() !== $current->version_checked ) { 46 $current = false; 47 } 48 49 if ( ! is_object( $current ) ) { 50 $current = new stdClass(); 51 $current->updates = array(); 52 $current->version_checked = wp_get_wp_version(); 53 } 54 55 if ( ! empty( $extra_stats ) ) { 56 $force_check = true; 57 } 58 59 // Wait 1 minute between multiple version check requests. 60 $timeout = MINUTE_IN_SECONDS; 61 $time_not_changed = isset( $current->last_checked ) && $timeout > ( time() - $current->last_checked ); 62 63 if ( ! $force_check && $time_not_changed ) { 64 return; 65 } 66 67 /** 68 * Filters the locale requested for WordPress core translations. 69 * 70 * @since 2.8.0 71 * 72 * @param string $locale Current locale. 73 */ 74 $locale = apply_filters( 'core_version_check_locale', get_locale() ); 75 76 // Update last_checked for current to prevent multiple blocking requests if request hangs. 77 $current->last_checked = time(); 78 set_site_transient( 'update_core', $current ); 79 80 if ( method_exists( $wpdb, 'db_server_info' ) ) { 81 $mysql_version = $wpdb->db_server_info(); 82 } elseif ( method_exists( $wpdb, 'db_version' ) ) { 83 $mysql_version = preg_replace( '/[^0-9.].*/', '', $wpdb->db_version() ); 84 } else { 85 $mysql_version = 'N/A'; 86 } 87 88 if ( is_multisite() ) { 89 $num_blogs = get_blog_count(); 90 $wp_install = network_site_url(); 91 $multisite_enabled = 1; 92 } else { 93 $multisite_enabled = 0; 94 $num_blogs = 1; 95 $wp_install = home_url( '/' ); 96 } 97 98 $extensions = get_loaded_extensions(); 99 sort( $extensions, SORT_STRING | SORT_FLAG_CASE ); 100 $query = array( 101 'version' => wp_get_wp_version(), 102 'php' => $php_version, 103 'locale' => $locale, 104 'mysql' => $mysql_version, 105 'local_package' => isset( $wp_local_package ) ? $wp_local_package : '', 106 'blogs' => $num_blogs, 107 'users' => get_user_count(), 108 'multisite_enabled' => $multisite_enabled, 109 'initial_db_version' => get_site_option( 'initial_db_version' ), 110 'extensions' => array_combine( $extensions, array_map( 'phpversion', $extensions ) ), 111 'platform_flags' => array( 112 'os' => PHP_OS, 113 'bits' => PHP_INT_SIZE === 4 ? 32 : 64, 114 ), 115 'image_support' => array(), 116 ); 117 118 if ( function_exists( 'gd_info' ) ) { 119 $gd_info = gd_info(); 120 // Filter to supported values. 121 $gd_info = array_filter( $gd_info ); 122 123 // Add data for GD WebP, AVIF, HEIC and JPEG XL support. 124 $query['image_support']['gd'] = array_keys( 125 array_filter( 126 array( 127 'webp' => isset( $gd_info['WebP Support'] ), 128 'avif' => isset( $gd_info['AVIF Support'] ), 129 'heic' => isset( $gd_info['HEIC Support'] ), 130 'jxl' => isset( $gd_info['JXL Support'] ), 131 ) 132 ) 133 ); 134 } 135 136 if ( class_exists( 'Imagick' ) ) { 137 // Add data for Imagick WebP, AVIF, HEIC and JPEG XL support. 138 $query['image_support']['imagick'] = array_keys( 139 array_filter( 140 array( 141 'webp' => ! empty( Imagick::queryFormats( 'WEBP' ) ), 142 'avif' => ! empty( Imagick::queryFormats( 'AVIF' ) ), 143 'heic' => ! empty( Imagick::queryFormats( 'HEIC' ) ), 144 'jxl' => ! empty( Imagick::queryFormats( 'JXL' ) ), 145 ) 146 ) 147 ); 148 } 149 150 /** 151 * Filters the query arguments sent as part of the core version check. 152 * 153 * WARNING: Changing this data may result in your site not receiving security updates. 154 * Please exercise extreme caution. 155 * 156 * @since 4.9.0 157 * @since 6.1.0 Added `$extensions`, `$platform_flags`, and `$image_support` to the `$query` parameter. 158 * 159 * @param array $query { 160 * Version check query arguments. 161 * 162 * @type string $version WordPress version number. 163 * @type string $php PHP version number. 164 * @type string $locale The locale to retrieve updates for. 165 * @type string $mysql MySQL version number. 166 * @type string $local_package The value of the $wp_local_package global, when set. 167 * @type int $blogs Number of sites on this WordPress installation. 168 * @type int $users Number of users on this WordPress installation. 169 * @type int $multisite_enabled Whether this WordPress installation uses Multisite. 170 * @type int $initial_db_version Database version of WordPress at time of installation. 171 * @type array $extensions List of PHP extensions and their versions. 172 * @type array $platform_flags List containing the operating system name and bit support. 173 * @type array $image_support List of image formats supported by GD and Imagick. 174 * } 175 */ 176 $query = apply_filters( 'core_version_check_query_args', $query ); 177 178 $post_body = array( 179 'translations' => wp_json_encode( $translations ), 180 ); 181 182 if ( is_array( $extra_stats ) ) { 183 $post_body = array_merge( $post_body, $extra_stats ); 184 } 185 186 // Allow for WP_AUTO_UPDATE_CORE to specify beta/RC/development releases. 187 if ( defined( 'WP_AUTO_UPDATE_CORE' ) 188 && in_array( WP_AUTO_UPDATE_CORE, array( 'beta', 'rc', 'development', 'branch-development' ), true ) 189 ) { 190 $query['channel'] = WP_AUTO_UPDATE_CORE; 191 } 192 193 $url = 'http://api.wordpress.org/core/version-check/1.7/?' . http_build_query( $query, '', '&' ); 194 $http_url = $url; 195 $ssl = wp_http_supports( array( 'ssl' ) ); 196 197 if ( $ssl ) { 198 $url = set_url_scheme( $url, 'https' ); 199 } 200 201 $doing_cron = wp_doing_cron(); 202 203 $options = array( 204 'timeout' => $doing_cron ? 30 : 3, 205 'user-agent' => 'WordPress/' . wp_get_wp_version() . '; ' . home_url( '/' ), 206 'headers' => array( 207 'wp_install' => $wp_install, 208 'wp_blog' => home_url( '/' ), 209 ), 210 'body' => $post_body, 211 ); 212 213 $response = wp_remote_post( $url, $options ); 214 215 if ( $ssl && is_wp_error( $response ) ) { 216 wp_trigger_error( 217 __FUNCTION__, 218 sprintf( 219 /* translators: %s: Support forums URL. */ 220 __( '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>.' ), 221 __( 'https://wordpress.org/support/forums/' ) 222 ) . ' ' . __( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ), 223 headers_sent() || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE 224 ); 225 $response = wp_remote_post( $http_url, $options ); 226 } 227 228 if ( is_wp_error( $response ) || 200 !== wp_remote_retrieve_response_code( $response ) ) { 229 return; 230 } 231 232 $body = trim( wp_remote_retrieve_body( $response ) ); 233 $body = json_decode( $body, true ); 234 235 if ( ! is_array( $body ) || ! isset( $body['offers'] ) ) { 236 return; 237 } 238 239 $offers = $body['offers']; 240 241 foreach ( $offers as &$offer ) { 242 foreach ( $offer as $offer_key => $value ) { 243 if ( 'packages' === $offer_key ) { 244 $offer['packages'] = (object) array_intersect_key( 245 array_map( 'esc_url', $offer['packages'] ), 246 array_fill_keys( array( 'full', 'no_content', 'new_bundled', 'partial', 'rollback' ), '' ) 247 ); 248 } elseif ( 'download' === $offer_key ) { 249 $offer['download'] = esc_url( $value ); 250 } else { 251 $offer[ $offer_key ] = esc_html( $value ); 252 } 253 } 254 $offer = (object) array_intersect_key( 255 $offer, 256 array_fill_keys( 257 array( 258 'response', 259 'download', 260 'locale', 261 'packages', 262 'current', 263 'version', 264 'php_version', 265 'mysql_version', 266 'new_bundled', 267 'partial_version', 268 'notify_email', 269 'support_email', 270 'new_files', 271 ), 272 '' 273 ) 274 ); 275 } 276 277 $updates = new stdClass(); 278 $updates->updates = $offers; 279 $updates->last_checked = time(); 280 $updates->version_checked = wp_get_wp_version(); 281 282 if ( isset( $body['translations'] ) ) { 283 $updates->translations = $body['translations']; 284 } 285 286 set_site_transient( 'update_core', $updates ); 287 288 if ( ! empty( $body['ttl'] ) ) { 289 $ttl = (int) $body['ttl']; 290 291 if ( $ttl && ( time() + $ttl < wp_next_scheduled( 'wp_version_check' ) ) ) { 292 // Queue an event to re-run the update check in $ttl seconds. 293 wp_schedule_single_event( time() + $ttl, 'wp_version_check' ); 294 } 295 } 296 297 // Trigger background updates if running non-interactively, and we weren't called from the update handler. 298 if ( $doing_cron && ! doing_action( 'wp_maybe_auto_update' ) ) { 299 /** 300 * Fires during wp_cron, starting the auto-update process. 301 * 302 * @since 3.9.0 303 */ 304 do_action( 'wp_maybe_auto_update' ); 305 } 306 } 307 308 /** 309 * Checks for available updates to plugins based on the latest versions hosted on WordPress.org. 310 * 311 * Despite its name this function does not actually perform any updates, it only checks for available updates. 312 * 313 * A list of all plugins installed is sent to api.wordpress.org, along with the site locale. 314 * 315 * Checks against the WordPress server at api.wordpress.org. Will only check 316 * if WordPress isn't installing. 317 * 318 * @since 2.3.0 319 * 320 * @global string $wp_version The WordPress version string. 321 * 322 * @param array $extra_stats Extra statistics to report to the WordPress.org API. 323 */ 324 function wp_update_plugins( $extra_stats = array() ) { 325 if ( wp_installing() ) { 326 return; 327 } 328 329 // If running blog-side, bail unless we've not checked in the last 12 hours. 330 if ( ! function_exists( 'get_plugins' ) ) { 331 require_once ABSPATH . 'wp-admin/includes/plugin.php'; 332 } 333 334 $plugins = get_plugins(); 335 $translations = wp_get_installed_translations( 'plugins' ); 336 337 $active = get_option( 'active_plugins', array() ); 338 $current = get_site_transient( 'update_plugins' ); 339 340 if ( ! is_object( $current ) ) { 341 $current = new stdClass(); 342 } 343 344 $doing_cron = wp_doing_cron(); 345 346 // Check for update on a different schedule, depending on the page. 347 switch ( current_filter() ) { 348 case 'upgrader_process_complete': 349 $timeout = 0; 350 break; 351 case 'load-update-core.php': 352 $timeout = MINUTE_IN_SECONDS; 353 break; 354 case 'load-plugins.php': 355 case 'load-update.php': 356 $timeout = HOUR_IN_SECONDS; 357 break; 358 default: 359 if ( $doing_cron ) { 360 $timeout = 2 * HOUR_IN_SECONDS; 361 } else { 362 $timeout = 12 * HOUR_IN_SECONDS; 363 } 364 } 365 366 $time_not_changed = isset( $current->last_checked ) && $timeout > ( time() - $current->last_checked ); 367 368 if ( $time_not_changed && ! $extra_stats ) { 369 $plugin_changed = false; 370 371 foreach ( $plugins as $file => $p ) { 372 if ( ! isset( $current->checked[ $file ] ) || (string) $current->checked[ $file ] !== (string) $p['Version'] ) { 373 $plugin_changed = true; 374 } 375 } 376 377 if ( isset( $current->response ) && is_array( $current->response ) ) { 378 foreach ( $current->response as $plugin_file => $update_details ) { 379 if ( ! isset( $plugins[ $plugin_file ] ) ) { 380 $plugin_changed = true; 381 break; 382 } 383 } 384 } 385 386 // Bail if we've checked recently and if nothing has changed. 387 if ( ! $plugin_changed ) { 388 return; 389 } 390 } 391 392 // Update last_checked for current to prevent multiple blocking requests if request hangs. 393 $current->last_checked = time(); 394 set_site_transient( 'update_plugins', $current ); 395 396 $to_send = compact( 'plugins', 'active' ); 397 398 $locales = array_values( get_available_languages() ); 399 400 /** 401 * Filters the locales requested for plugin translations. 402 * 403 * @since 3.7.0 404 * @since 4.5.0 The default value of the `$locales` parameter changed to include all locales. 405 * 406 * @param string[] $locales Plugin locales. Default is all available locales of the site. 407 */ 408 $locales = apply_filters( 'plugins_update_check_locales', $locales ); 409 $locales = array_unique( $locales ); 410 411 if ( $doing_cron ) { 412 $timeout = 30; // 30 seconds. 413 } else { 414 // Three seconds, plus one extra second for every 10 plugins. 415 $timeout = 3 + (int) ( count( $plugins ) / 10 ); 416 } 417 418 $options = array( 419 'timeout' => $timeout, 420 'body' => array( 421 'plugins' => wp_json_encode( $to_send ), 422 'translations' => wp_json_encode( $translations ), 423 'locale' => wp_json_encode( $locales ), 424 'all' => wp_json_encode( true ), 425 ), 426 'user-agent' => 'WordPress/' . wp_get_wp_version() . '; ' . home_url( '/' ), 427 ); 428 429 if ( $extra_stats ) { 430 $options['body']['update_stats'] = wp_json_encode( $extra_stats ); 431 } 432 433 $url = 'http://api.wordpress.org/plugins/update-check/1.1/'; 434 $http_url = $url; 435 $ssl = wp_http_supports( array( 'ssl' ) ); 436 437 if ( $ssl ) { 438 $url = set_url_scheme( $url, 'https' ); 439 } 440 441 $raw_response = wp_remote_post( $url, $options ); 442 443 if ( $ssl && is_wp_error( $raw_response ) ) { 444 wp_trigger_error( 445 __FUNCTION__, 446 sprintf( 447 /* translators: %s: Support forums URL. */ 448 __( '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>.' ), 449 __( 'https://wordpress.org/support/forums/' ) 450 ) . ' ' . __( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ), 451 headers_sent() || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE 452 ); 453 $raw_response = wp_remote_post( $http_url, $options ); 454 } 455 456 if ( is_wp_error( $raw_response ) || 200 !== wp_remote_retrieve_response_code( $raw_response ) ) { 457 return; 458 } 459 460 $updates = new stdClass(); 461 $updates->last_checked = time(); 462 $updates->response = array(); 463 $updates->translations = array(); 464 $updates->no_update = array(); 465 foreach ( $plugins as $file => $p ) { 466 $updates->checked[ $file ] = $p['Version']; 467 } 468 469 $response = json_decode( wp_remote_retrieve_body( $raw_response ), true ); 470 471 if ( $response && is_array( $response ) ) { 472 $updates->response = $response['plugins']; 473 $updates->translations = $response['translations']; 474 $updates->no_update = $response['no_update']; 475 } 476 477 // Support updates for any plugins using the `Update URI` header field. 478 foreach ( $plugins as $plugin_file => $plugin_data ) { 479 if ( ! $plugin_data['UpdateURI'] || isset( $updates->response[ $plugin_file ] ) ) { 480 continue; 481 } 482 483 $hostname = wp_parse_url( sanitize_url( $plugin_data['UpdateURI'] ), PHP_URL_HOST ); 484 485 /** 486 * Filters the update response for a given plugin hostname. 487 * 488 * The dynamic portion of the hook name, `$hostname`, refers to the hostname 489 * of the URI specified in the `Update URI` header field. 490 * 491 * @since 5.8.0 492 * 493 * @param array|false $update { 494 * The plugin update data with the latest details. Default false. 495 * 496 * @type string $id Optional. ID of the plugin for update purposes, should be a URI 497 * specified in the `Update URI` header field. 498 * @type string $slug Slug of the plugin. 499 * @type string $version The version of the plugin. 500 * @type string $url The URL for details of the plugin. 501 * @type string $package Optional. The update ZIP for the plugin. 502 * @type string $tested Optional. The version of WordPress the plugin is tested against. 503 * @type string $requires_php Optional. The version of PHP which the plugin requires. 504 * @type bool $autoupdate Optional. Whether the plugin should automatically update. 505 * @type string[] $icons Optional. Array of plugin icons. 506 * @type string[] $banners Optional. Array of plugin banners. 507 * @type string[] $banners_rtl Optional. Array of plugin RTL banners. 508 * @type array $translations { 509 * Optional. List of translation updates for the plugin. 510 * 511 * @type string $language The language the translation update is for. 512 * @type string $version The version of the plugin this translation is for. 513 * This is not the version of the language file. 514 * @type string $updated The update timestamp of the translation file. 515 * Should be a date in the `YYYY-MM-DD HH:MM:SS` format. 516 * @type string $package The ZIP location containing the translation update. 517 * @type string $autoupdate Whether the translation should be automatically installed. 518 * } 519 * } 520 * @param array $plugin_data Plugin headers. 521 * @param string $plugin_file Plugin filename. 522 * @param string[] $locales Installed locales to look up translations for. 523 */ 524 $update = apply_filters( "update_plugins_{$hostname}", false, $plugin_data, $plugin_file, $locales ); 525 526 if ( ! $update ) { 527 continue; 528 } 529 530 $update = (object) $update; 531 532 // Is it valid? We require at least a version. 533 if ( ! isset( $update->version ) ) { 534 continue; 535 } 536 537 // These should remain constant. 538 $update->id = $plugin_data['UpdateURI']; 539 $update->plugin = $plugin_file; 540 541 // WordPress needs the version field specified as 'new_version'. 542 if ( ! isset( $update->new_version ) ) { 543 $update->new_version = $update->version; 544 } 545 546 // Handle any translation updates. 547 if ( ! empty( $update->translations ) ) { 548 foreach ( $update->translations as $translation ) { 549 if ( isset( $translation['language'], $translation['package'] ) ) { 550 $translation['type'] = 'plugin'; 551 $translation['slug'] = isset( $update->slug ) ? $update->slug : $update->id; 552 553 $updates->translations[] = $translation; 554 } 555 } 556 } 557 558 unset( $updates->no_update[ $plugin_file ], $updates->response[ $plugin_file ] ); 559 560 if ( version_compare( $update->new_version, $plugin_data['Version'], '>' ) ) { 561 $updates->response[ $plugin_file ] = $update; 562 } else { 563 $updates->no_update[ $plugin_file ] = $update; 564 } 565 } 566 567 $sanitize_plugin_update_payload = static function ( &$item ) { 568 $item = (object) $item; 569 570 unset( $item->translations, $item->compatibility ); 571 572 return $item; 573 }; 574 575 array_walk( $updates->response, $sanitize_plugin_update_payload ); 576 array_walk( $updates->no_update, $sanitize_plugin_update_payload ); 577 578 set_site_transient( 'update_plugins', $updates ); 579 } 580 581 /** 582 * Checks for available updates to themes based on the latest versions hosted on WordPress.org. 583 * 584 * Despite its name this function does not actually perform any updates, it only checks for available updates. 585 * 586 * A list of all themes installed is sent to api.wordpress.org, along with the site locale. 587 * 588 * Checks against the WordPress server at api.wordpress.org. Will only check 589 * if WordPress isn't installing. 590 * 591 * @since 2.7.0 592 * 593 * @global string $wp_version The WordPress version string. 594 * 595 * @param array $extra_stats Extra statistics to report to the WordPress.org API. 596 */ 597 function wp_update_themes( $extra_stats = array() ) { 598 if ( wp_installing() ) { 599 return; 600 } 601 602 $installed_themes = wp_get_themes(); 603 $translations = wp_get_installed_translations( 'themes' ); 604 605 $last_update = get_site_transient( 'update_themes' ); 606 607 if ( ! is_object( $last_update ) ) { 608 $last_update = new stdClass(); 609 } 610 611 $themes = array(); 612 $checked = array(); 613 $request = array(); 614 615 // Put slug of active theme into request. 616 $request['active'] = get_option( 'stylesheet' ); 617 618 foreach ( $installed_themes as $theme ) { 619 $checked[ $theme->get_stylesheet() ] = $theme->get( 'Version' ); 620 621 $themes[ $theme->get_stylesheet() ] = array( 622 'Name' => $theme->get( 'Name' ), 623 'Title' => $theme->get( 'Name' ), 624 'Version' => $theme->get( 'Version' ), 625 'Author' => $theme->get( 'Author' ), 626 'Author URI' => $theme->get( 'AuthorURI' ), 627 'UpdateURI' => $theme->get( 'UpdateURI' ), 628 'Template' => $theme->get_template(), 629 'Stylesheet' => $theme->get_stylesheet(), 630 ); 631 } 632 633 $doing_cron = wp_doing_cron(); 634 635 // Check for update on a different schedule, depending on the page. 636 switch ( current_filter() ) { 637 case 'upgrader_process_complete': 638 $timeout = 0; 639 break; 640 case 'load-update-core.php': 641 $timeout = MINUTE_IN_SECONDS; 642 break; 643 case 'load-themes.php': 644 case 'load-update.php': 645 $timeout = HOUR_IN_SECONDS; 646 break; 647 default: 648 if ( $doing_cron ) { 649 $timeout = 2 * HOUR_IN_SECONDS; 650 } else { 651 $timeout = 12 * HOUR_IN_SECONDS; 652 } 653 } 654 655 $time_not_changed = isset( $last_update->last_checked ) && $timeout > ( time() - $last_update->last_checked ); 656 657 if ( $time_not_changed && ! $extra_stats ) { 658 $theme_changed = false; 659 660 foreach ( $checked as $slug => $v ) { 661 if ( ! isset( $last_update->checked[ $slug ] ) || (string) $last_update->checked[ $slug ] !== (string) $v ) { 662 $theme_changed = true; 663 } 664 } 665 666 if ( isset( $last_update->response ) && is_array( $last_update->response ) ) { 667 foreach ( $last_update->response as $slug => $update_details ) { 668 if ( ! isset( $checked[ $slug ] ) ) { 669 $theme_changed = true; 670 break; 671 } 672 } 673 } 674 675 // Bail if we've checked recently and if nothing has changed. 676 if ( ! $theme_changed ) { 677 return; 678 } 679 } 680 681 // Update last_checked for current to prevent multiple blocking requests if request hangs. 682 $last_update->last_checked = time(); 683 set_site_transient( 'update_themes', $last_update ); 684 685 $request['themes'] = $themes; 686 687 $locales = array_values( get_available_languages() ); 688 689 /** 690 * Filters the locales requested for theme translations. 691 * 692 * @since 3.7.0 693 * @since 4.5.0 The default value of the `$locales` parameter changed to include all locales. 694 * 695 * @param string[] $locales Theme locales. Default is all available locales of the site. 696 */ 697 $locales = apply_filters( 'themes_update_check_locales', $locales ); 698 $locales = array_unique( $locales ); 699 700 if ( $doing_cron ) { 701 $timeout = 30; // 30 seconds. 702 } else { 703 // Three seconds, plus one extra second for every 10 themes. 704 $timeout = 3 + (int) ( count( $themes ) / 10 ); 705 } 706 707 $options = array( 708 'timeout' => $timeout, 709 'body' => array( 710 'themes' => wp_json_encode( $request ), 711 'translations' => wp_json_encode( $translations ), 712 'locale' => wp_json_encode( $locales ), 713 ), 714 'user-agent' => 'WordPress/' . wp_get_wp_version() . '; ' . home_url( '/' ), 715 ); 716 717 if ( $extra_stats ) { 718 $options['body']['update_stats'] = wp_json_encode( $extra_stats ); 719 } 720 721 $url = 'http://api.wordpress.org/themes/update-check/1.1/'; 722 $http_url = $url; 723 $ssl = wp_http_supports( array( 'ssl' ) ); 724 725 if ( $ssl ) { 726 $url = set_url_scheme( $url, 'https' ); 727 } 728 729 $raw_response = wp_remote_post( $url, $options ); 730 731 if ( $ssl && is_wp_error( $raw_response ) ) { 732 wp_trigger_error( 733 __FUNCTION__, 734 sprintf( 735 /* translators: %s: Support forums URL. */ 736 __( '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>.' ), 737 __( 'https://wordpress.org/support/forums/' ) 738 ) . ' ' . __( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ), 739 headers_sent() || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE 740 ); 741 $raw_response = wp_remote_post( $http_url, $options ); 742 } 743 744 if ( is_wp_error( $raw_response ) || 200 !== wp_remote_retrieve_response_code( $raw_response ) ) { 745 return; 746 } 747 748 $new_update = new stdClass(); 749 $new_update->last_checked = time(); 750 $new_update->checked = $checked; 751 752 $response = json_decode( wp_remote_retrieve_body( $raw_response ), true ); 753 754 if ( is_array( $response ) ) { 755 $new_update->response = $response['themes']; 756 $new_update->no_update = $response['no_update']; 757 $new_update->translations = $response['translations']; 758 } 759 760 // Support updates for any themes using the `Update URI` header field. 761 foreach ( $themes as $theme_stylesheet => $theme_data ) { 762 if ( ! $theme_data['UpdateURI'] || isset( $new_update->response[ $theme_stylesheet ] ) ) { 763 continue; 764 } 765 766 $hostname = wp_parse_url( sanitize_url( $theme_data['UpdateURI'] ), PHP_URL_HOST ); 767 768 /** 769 * Filters the update response for a given theme hostname. 770 * 771 * The dynamic portion of the hook name, `$hostname`, refers to the hostname 772 * of the URI specified in the `Update URI` header field. 773 * 774 * @since 6.1.0 775 * 776 * @param array|false $update { 777 * The theme update data with the latest details. Default false. 778 * 779 * @type string $id Optional. ID of the theme for update purposes, should be a URI 780 * specified in the `Update URI` header field. 781 * @type string $theme Directory name of the theme. 782 * @type string $version The version of the theme. 783 * @type string $url The URL for details of the theme. 784 * @type string $package Optional. The update ZIP for the theme. 785 * @type string $tested Optional. The version of WordPress the theme is tested against. 786 * @type string $requires_php Optional. The version of PHP which the theme requires. 787 * @type bool $autoupdate Optional. Whether the theme should automatically update. 788 * @type array $translations { 789 * Optional. List of translation updates for the theme. 790 * 791 * @type string $language The language the translation update is for. 792 * @type string $version The version of the theme this translation is for. 793 * This is not the version of the language file. 794 * @type string $updated The update timestamp of the translation file. 795 * Should be a date in the `YYYY-MM-DD HH:MM:SS` format. 796 * @type string $package The ZIP location containing the translation update. 797 * @type string $autoupdate Whether the translation should be automatically installed. 798 * } 799 * } 800 * @param array $theme_data Theme headers. 801 * @param string $theme_stylesheet Theme stylesheet. 802 * @param string[] $locales Installed locales to look up translations for. 803 */ 804 $update = apply_filters( "update_themes_{$hostname}", false, $theme_data, $theme_stylesheet, $locales ); 805 806 if ( ! $update ) { 807 continue; 808 } 809 810 $update = (object) $update; 811 812 // Is it valid? We require at least a version. 813 if ( ! isset( $update->version ) ) { 814 continue; 815 } 816 817 // This should remain constant. 818 $update->id = $theme_data['UpdateURI']; 819 820 // WordPress needs the version field specified as 'new_version'. 821 if ( ! isset( $update->new_version ) ) { 822 $update->new_version = $update->version; 823 } 824 825 // Handle any translation updates. 826 if ( ! empty( $update->translations ) ) { 827 foreach ( $update->translations as $translation ) { 828 if ( isset( $translation['language'], $translation['package'] ) ) { 829 $translation['type'] = 'theme'; 830 $translation['slug'] = isset( $update->theme ) ? $update->theme : $update->id; 831 832 $new_update->translations[] = $translation; 833 } 834 } 835 } 836 837 unset( $new_update->no_update[ $theme_stylesheet ], $new_update->response[ $theme_stylesheet ] ); 838 839 if ( version_compare( $update->new_version, $theme_data['Version'], '>' ) ) { 840 $new_update->response[ $theme_stylesheet ] = (array) $update; 841 } else { 842 $new_update->no_update[ $theme_stylesheet ] = (array) $update; 843 } 844 } 845 846 set_site_transient( 'update_themes', $new_update ); 847 } 848 849 /** 850 * Performs WordPress automatic background updates. 851 * 852 * Updates WordPress core plus any plugins and themes that have automatic updates enabled. 853 * 854 * @since 3.7.0 855 */ 856 function wp_maybe_auto_update() { 857 require_once ABSPATH . 'wp-admin/includes/admin.php'; 858 require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php'; 859 860 $upgrader = new WP_Automatic_Updater(); 861 $upgrader->run(); 862 } 863 864 /** 865 * Retrieves a list of all language updates available. 866 * 867 * @since 3.7.0 868 * 869 * @return object[] Array of translation objects that have available updates. 870 */ 871 function wp_get_translation_updates() { 872 $updates = array(); 873 $transients = array( 874 'update_core' => 'core', 875 'update_plugins' => 'plugin', 876 'update_themes' => 'theme', 877 ); 878 879 foreach ( $transients as $transient => $type ) { 880 $transient = get_site_transient( $transient ); 881 882 if ( empty( $transient->translations ) ) { 883 continue; 884 } 885 886 foreach ( $transient->translations as $translation ) { 887 $updates[] = (object) $translation; 888 } 889 } 890 891 return $updates; 892 } 893 894 /** 895 * Collects counts and UI strings for available updates. 896 * 897 * @since 3.3.0 898 * 899 * @return array { 900 * Fetched update data. 901 * 902 * @type int[] $counts An array of counts for available plugin, theme, and WordPress updates. 903 * @type string $update_title Titles of available updates. 904 * } 905 */ 906 function wp_get_update_data() { 907 $counts = array( 908 'plugins' => 0, 909 'themes' => 0, 910 'wordpress' => 0, 911 'translations' => 0, 912 ); 913 914 $plugins = current_user_can( 'update_plugins' ); 915 916 if ( $plugins ) { 917 $update_plugins = get_site_transient( 'update_plugins' ); 918 919 if ( ! empty( $update_plugins->response ) ) { 920 $counts['plugins'] = count( $update_plugins->response ); 921 } 922 } 923 924 $themes = current_user_can( 'update_themes' ); 925 926 if ( $themes ) { 927 $update_themes = get_site_transient( 'update_themes' ); 928 929 if ( ! empty( $update_themes->response ) ) { 930 $counts['themes'] = count( $update_themes->response ); 931 } 932 } 933 934 $core = current_user_can( 'update_core' ); 935 936 if ( $core && function_exists( 'get_core_updates' ) ) { 937 $update_wordpress = get_core_updates( array( 'dismissed' => false ) ); 938 939 if ( ! empty( $update_wordpress ) 940 && ! in_array( $update_wordpress[0]->response, array( 'development', 'latest' ), true ) 941 && current_user_can( 'update_core' ) 942 ) { 943 $counts['wordpress'] = 1; 944 } 945 } 946 947 if ( ( $core || $plugins || $themes ) && wp_get_translation_updates() ) { 948 $counts['translations'] = 1; 949 } 950 951 $counts['total'] = $counts['plugins'] + $counts['themes'] + $counts['wordpress'] + $counts['translations']; 952 $titles = array(); 953 954 if ( $counts['wordpress'] ) { 955 /* translators: %d: Number of available WordPress updates. */ 956 $titles['wordpress'] = sprintf( __( '%d WordPress Update' ), $counts['wordpress'] ); 957 } 958 959 if ( $counts['plugins'] ) { 960 /* translators: %d: Number of available plugin updates. */ 961 $titles['plugins'] = sprintf( _n( '%d Plugin Update', '%d Plugin Updates', $counts['plugins'] ), $counts['plugins'] ); 962 } 963 964 if ( $counts['themes'] ) { 965 /* translators: %d: Number of available theme updates. */ 966 $titles['themes'] = sprintf( _n( '%d Theme Update', '%d Theme Updates', $counts['themes'] ), $counts['themes'] ); 967 } 968 969 if ( $counts['translations'] ) { 970 $titles['translations'] = __( 'Translation Updates' ); 971 } 972 973 $update_title = $titles ? esc_attr( implode( ', ', $titles ) ) : ''; 974 975 $update_data = array( 976 'counts' => $counts, 977 'title' => $update_title, 978 ); 979 /** 980 * Filters the returned array of update data for plugins, themes, and WordPress core. 981 * 982 * @since 3.5.0 983 * 984 * @param array $update_data { 985 * Fetched update data. 986 * 987 * @type int[] $counts An array of counts for available plugin, theme, and WordPress updates. 988 * @type string $update_title Titles of available updates. 989 * } 990 * @param array $titles An array of update counts and UI strings for available updates. 991 */ 992 return apply_filters( 'wp_get_update_data', $update_data, $titles ); 993 } 994 995 /** 996 * Determines whether core should be updated. 997 * 998 * @since 2.8.0 999 */ 1000 function _maybe_update_core() { 1001 $current = get_site_transient( 'update_core' ); 1002 1003 if ( isset( $current->last_checked, $current->version_checked ) 1004 && 12 * HOUR_IN_SECONDS > ( time() - $current->last_checked ) 1005 && wp_get_wp_version() === $current->version_checked 1006 ) { 1007 return; 1008 } 1009 1010 wp_version_check(); 1011 } 1012 /** 1013 * Checks the last time plugins were run before checking plugin versions. 1014 * 1015 * This might have been backported to WordPress 2.6.1 for performance reasons. 1016 * This is used for the wp-admin to check only so often instead of every page 1017 * load. 1018 * 1019 * @since 2.7.0 1020 * @access private 1021 */ 1022 function _maybe_update_plugins() { 1023 $current = get_site_transient( 'update_plugins' ); 1024 1025 if ( isset( $current->last_checked ) 1026 && 12 * HOUR_IN_SECONDS > ( time() - $current->last_checked ) 1027 ) { 1028 return; 1029 } 1030 1031 wp_update_plugins(); 1032 } 1033 1034 /** 1035 * Checks themes versions only after a duration of time. 1036 * 1037 * This is for performance reasons to make sure that on the theme version 1038 * checker is not run on every page load. 1039 * 1040 * @since 2.7.0 1041 * @access private 1042 */ 1043 function _maybe_update_themes() { 1044 $current = get_site_transient( 'update_themes' ); 1045 1046 if ( isset( $current->last_checked ) 1047 && 12 * HOUR_IN_SECONDS > ( time() - $current->last_checked ) 1048 ) { 1049 return; 1050 } 1051 1052 wp_update_themes(); 1053 } 1054 1055 /** 1056 * Schedules core, theme, and plugin update checks. 1057 * 1058 * @since 3.1.0 1059 */ 1060 function wp_schedule_update_checks() { 1061 if ( ! wp_next_scheduled( 'wp_version_check' ) && ! wp_installing() ) { 1062 wp_schedule_event( time(), 'twicedaily', 'wp_version_check' ); 1063 } 1064 1065 if ( ! wp_next_scheduled( 'wp_update_plugins' ) && ! wp_installing() ) { 1066 wp_schedule_event( time(), 'twicedaily', 'wp_update_plugins' ); 1067 } 1068 1069 if ( ! wp_next_scheduled( 'wp_update_themes' ) && ! wp_installing() ) { 1070 wp_schedule_event( time(), 'twicedaily', 'wp_update_themes' ); 1071 } 1072 } 1073 1074 /** 1075 * Clears existing update caches for plugins, themes, and core. 1076 * 1077 * @since 4.1.0 1078 */ 1079 function wp_clean_update_cache() { 1080 if ( function_exists( 'wp_clean_plugins_cache' ) ) { 1081 wp_clean_plugins_cache(); 1082 } else { 1083 delete_site_transient( 'update_plugins' ); 1084 } 1085 1086 wp_clean_themes_cache(); 1087 1088 delete_site_transient( 'update_core' ); 1089 } 1090 1091 /** 1092 * Schedules the removal of all contents in the temporary backup directory. 1093 * 1094 * @since 6.3.0 1095 */ 1096 function wp_delete_all_temp_backups() { 1097 /* 1098 * Check if there is a lock, or if currently performing an Ajax request, 1099 * in which case there is a chance an update is running. 1100 * Reschedule for an hour from now and exit early. 1101 */ 1102 if ( get_option( 'core_updater.lock' ) || get_option( 'auto_updater.lock' ) || wp_doing_ajax() ) { 1103 wp_schedule_single_event( time() + HOUR_IN_SECONDS, 'wp_delete_temp_updater_backups' ); 1104 return; 1105 } 1106 1107 // This action runs on shutdown to make sure there are no plugin updates currently running. 1108 add_action( 'shutdown', '_wp_delete_all_temp_backups' ); 1109 } 1110 1111 /** 1112 * Deletes all contents in the temporary backup directory. 1113 * 1114 * @since 6.3.0 1115 * 1116 * @access private 1117 * 1118 * @global WP_Filesystem_Base $wp_filesystem WordPress filesystem subclass. 1119 */ 1120 function _wp_delete_all_temp_backups() { 1121 global $wp_filesystem; 1122 1123 if ( ! function_exists( 'WP_Filesystem' ) ) { 1124 require_once ABSPATH . 'wp-admin/includes/file.php'; 1125 } 1126 1127 ob_start(); 1128 $credentials = request_filesystem_credentials( '' ); 1129 ob_end_clean(); 1130 1131 if ( false === $credentials || ! WP_Filesystem( $credentials ) ) { 1132 wp_trigger_error( __FUNCTION__, __( 'Could not access filesystem.' ) ); 1133 return; 1134 } 1135 1136 if ( ! $wp_filesystem->wp_content_dir() ) { 1137 wp_trigger_error( 1138 __FUNCTION__, 1139 /* translators: %s: Directory name. */ 1140 sprintf( __( 'Unable to locate WordPress content directory (%s).' ), 'wp-content' ) 1141 ); 1142 return; 1143 } 1144 1145 $temp_backup_dir = $wp_filesystem->wp_content_dir() . 'upgrade-temp-backup/'; 1146 $dirlist = $wp_filesystem->dirlist( $temp_backup_dir ); 1147 $dirlist = $dirlist ? $dirlist : array(); 1148 1149 foreach ( array_keys( $dirlist ) as $dir ) { 1150 if ( '.' === $dir || '..' === $dir ) { 1151 continue; 1152 } 1153 1154 $wp_filesystem->delete( $temp_backup_dir . $dir, true ); 1155 } 1156 } 1157 1158 if ( ( ! is_main_site() && ! is_network_admin() ) || wp_doing_ajax() ) { 1159 return; 1160 } 1161 1162 add_action( 'admin_init', '_maybe_update_core' ); 1163 add_action( 'wp_version_check', 'wp_version_check' ); 1164 1165 add_action( 'load-plugins.php', 'wp_update_plugins' ); 1166 add_action( 'load-update.php', 'wp_update_plugins' ); 1167 add_action( 'load-update-core.php', 'wp_update_plugins' ); 1168 add_action( 'admin_init', '_maybe_update_plugins' ); 1169 add_action( 'wp_update_plugins', 'wp_update_plugins' ); 1170 1171 add_action( 'load-themes.php', 'wp_update_themes' ); 1172 add_action( 'load-update.php', 'wp_update_themes' ); 1173 add_action( 'load-update-core.php', 'wp_update_themes' ); 1174 add_action( 'admin_init', '_maybe_update_themes' ); 1175 add_action( 'wp_update_themes', 'wp_update_themes' ); 1176 1177 add_action( 'update_option_WPLANG', 'wp_clean_update_cache', 10, 0 ); 1178 1179 add_action( 'wp_maybe_auto_update', 'wp_maybe_auto_update' ); 1180 1181 add_action( 'init', 'wp_schedule_update_checks' ); 1182 1183 add_action( 'wp_delete_temp_updater_backups', 'wp_delete_all_temp_backups' );
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated : Thu Apr 24 08:20:01 2025 | Cross-referenced by PHPXref |