wp_update_plugins( array $extra_stats = array() )

Description

Parameters

$extra_statsarrayoptional

Extra statistics to report to the WordPress.org API.Default: array()

Hooks fired · 2

2 hooks fire while wp_update_plugins() runs, in this order:

1. 1
   apply_filters( plugins_update_check_locales )filterline 408 (+84 into the body)

   Filters the locales requested for plugin translations.

2. 2
   apply_filters( update_plugins_{$hostname} )filterline 524 (+200 into the body)

   Filters the update response for a given plugin hostname.

Uses · 24

• wp_installing()Checks or sets whether WordPress is in "installation" mode.
• get_plugins()Checks the plugins directory and retrieve all plugin files with plugin data.
• wp_get_installed_translations()Gets installed translations.
• get_option()Retrieves an option value based on an option name.
• get_site_transient()Retrieves the value of a site transient.
• wp_doing_cron()Determines whether the current request is a WordPress cron request.
• current_filter()Retrieves the name of the current filter hook.
• set_site_transient()Sets/updates the value of a site transient.
• get_available_languages()Gets all available languages based on the presence of *.mo and *.l10n.php files in a given directory.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• wp_json_encode()Encodes a variable into JSON, with some confidence checks.
• wp_get_wp_version()Returns the current WordPress version.

Used by · 5

• WP_Automatic_Updater::run()Kicks off the background update process, looping through all pending updates.
• WP_Debug_Data::check_for_updates()Calls all core functions to check for updates.
• _maybe_update_plugins()Checks the last time plugins were run before checking plugin versions.
• install_plugin_install_status()Determines the status we can perform on a plugin.
• wp_ajax_update_plugin()Handles updating a plugin via AJAX.

Source

View on Trac ↗View on GitHub ↗

324function 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

History

Introduced in 2.3.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.8.8 tag, from src/wp-includes/update.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.