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 407 (+92 into the body)

   Filters the locales requested for plugin translations.

2. 2
   apply_filters( update_plugins_{$hostname} )filterline 514 (+199 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 ↗

315function wp_update_plugins( $extra_stats = array() ) {316	if ( wp_installing() ) {317		return;318	}319 320	// If running blog-side, bail unless we've not checked in the last 12 hours.321	if ( ! function_exists( 'get_plugins' ) ) {322		require_once ABSPATH . 'wp-admin/includes/plugin.php';323	}324 325	$plugins      = get_plugins();326	$translations = wp_get_installed_translations( 'plugins' );327 328	$active  = get_option( 'active_plugins', array() );329	$current = get_site_transient( 'update_plugins' );330 331	if ( ! is_object( $current ) ) {332		$current = new stdClass();333	}334 335	$updates               = new stdClass();336	$updates->last_checked = time();337	$updates->response     = array();338	$updates->translations = array();339	$updates->no_update    = array();340 341	$doing_cron = wp_doing_cron();342 343	// Check for update on a different schedule, depending on the page.344	switch ( current_filter() ) {345		case 'upgrader_process_complete':346			$timeout = 0;347			break;348		case 'load-update-core.php':349			$timeout = MINUTE_IN_SECONDS;350			break;351		case 'load-plugins.php':352		case 'load-update.php':353			$timeout = HOUR_IN_SECONDS;354			break;355		default:356			if ( $doing_cron ) {357				$timeout = 2 * HOUR_IN_SECONDS;358			} else {359				$timeout = 12 * HOUR_IN_SECONDS;360			}361	}362 363	$time_not_changed = isset( $current->last_checked ) && $timeout > ( time() - $current->last_checked );364 365	if ( $time_not_changed && ! $extra_stats ) {366		$plugin_changed = false;367 368		foreach ( $plugins as $file => $p ) {369			$updates->checked[ $file ] = $p['Version'];370 371			if ( ! isset( $current->checked[ $file ] ) || (string) $current->checked[ $file ] !== (string) $p['Version'] ) {372				$plugin_changed = true;373			}374		}375 376		if ( isset( $current->response ) && is_array( $current->response ) ) {377			foreach ( $current->response as $plugin_file => $update_details ) {378				if ( ! isset( $plugins[ $plugin_file ] ) ) {379					$plugin_changed = true;380					break;381				}382			}383		}384 385		// Bail if we've checked recently and if nothing has changed.386		if ( ! $plugin_changed ) {387			return;388		}389	}390 391	// Update last_checked for current to prevent multiple blocking requests if request hangs.392	$current->last_checked = time();393	set_site_transient( 'update_plugins', $current );394

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.7.7 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.