<?php

/**

 * WordPress Administration Update API

 *

 * @package WordPress

 * @subpackage Administration

 */

/**

 * Selects the first update version from the update_core option.

 *

 * @since 2.7.0

 *

 * @return object|array|false The response from the API on success, false on failure.

 */

function get_preferred_from_update_core() {

	$updates = get_core_updates();

	if ( ! is_array( $updates ) ) {

		return false;

	}

	if ( empty( $updates ) ) {

		return (object) array( 'response' => 'latest' );

	}

	return $updates[0];

}

/**

 * Gets available core updates.

 *

 * @since 2.7.0

 *

 * @param array $options Set $options['dismissed'] to true to show dismissed upgrades too,

 *                       set $options['available'] to false to skip not-dismissed updates.

 * @return array|false Array of the update objects on success, false on failure.

 */

function get_core_updates( $options = array() ) {

	$options = array_merge(

		array(

			'available' => true,

			'dismissed' => false,

		),

		$options

	);

	$dismissed = get_site_option( 'dismissed_update_core' );

	if ( ! is_array( $dismissed ) ) {

		$dismissed = array();

	}

	$from_api = get_site_transient( 'update_core' );

	if ( ! isset( $from_api->updates ) || ! is_array( $from_api->updates ) ) {

		return false;

	}

	$updates = $from_api->updates;

	$result  = array();

	foreach ( $updates as $update ) {

		if ( 'autoupdate' === $update->response ) {

			continue;

		}

		if ( array_key_exists( $update->current . '|' . $update->locale, $dismissed ) ) {

			if ( $options['dismissed'] ) {

				$update->dismissed = true;

				$result[]          = $update;

			}

		} else {

			if ( $options['available'] ) {

				$update->dismissed = false;

				$result[]          = $update;

			}

		}

	}

	return $result;

}

/**

 * Gets the best available (and enabled) Auto-Update for WordPress core.

 *

 * If there's 1.2.3 and 1.3 on offer, it'll choose 1.3 if the installation allows it, else, 1.2.3.

 *

 * @since 3.7.0

 *

 * @return object|false The core update offering on success, false on failure.

 */

function find_core_auto_update() {

	$updates = get_site_transient( 'update_core' );

	if ( ! $updates || empty( $updates->updates ) ) {

		return false;

	}

	require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';

	$auto_update = false;

	$upgrader    = new WP_Automatic_Updater();

	foreach ( $updates->updates as $update ) {

		if ( 'autoupdate' !== $update->response ) {

			continue;

		}

		if ( ! $upgrader->should_update( 'core', $update, ABSPATH ) ) {

			continue;

		}

		if ( ! $auto_update || version_compare( $update->current, $auto_update->current, '>' ) ) {

			$auto_update = $update;

		}

	}

	return $auto_update;

}

/**

 * Gets and caches the checksums for the given version of WordPress.

 *

 * @since 3.7.0

 *

 * @param string $version Version string to query.

 * @param string $locale  Locale to query.

 * @return array|false An array of checksums on success, false on failure.

 */

function get_core_checksums( $version, $locale ) {

	$http_url = 'http://api.wordpress.org/core/checksums/1.0/?' . http_build_query( compact( 'version', 'locale' ), '', '&' );

	$url      = $http_url;

	$ssl = wp_http_supports( array( 'ssl' ) );

	if ( $ssl ) {

		$url = set_url_scheme( $url, 'https' );

	}

	$options = array(

		'timeout' => wp_doing_cron() ? 30 : 3,

	);

	$response = wp_remote_get( $url, $options );

	if ( $ssl && is_wp_error( $response ) ) {

		wp_trigger_error(

			__FUNCTION__,

			sprintf(

				/* translators: %s: Support forums URL. */

				__( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),

				__( 'https://wordpress.org/support/forums/' )

			) . ' ' . __( '(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

		);

		$response = wp_remote_get( $http_url, $options );

	}

	if ( is_wp_error( $response ) || 200 !== wp_remote_retrieve_response_code( $response ) ) {

		return false;

	}

	$body = trim( wp_remote_retrieve_body( $response ) );

	$body = json_decode( $body, true );

	if ( ! is_array( $body ) || ! isset( $body['checksums'] ) || ! is_array( $body['checksums'] ) ) {

		return false;

	}

	return $body['checksums'];

}

/**

 * Dismisses core update.

 *

 * @since 2.7.0

 *

 * @param object $update

 * @return bool

 */

function dismiss_core_update( $update ) {

	$dismissed = get_site_option( 'dismissed_update_core' );

	$dismissed[ $update->current . '|' . $update->locale ] = true;

	return update_site_option( 'dismissed_update_core', $dismissed );

}

/**

 * Undismisses core update.

 *

 * @since 2.7.0

 *

 * @param string $version

 * @param string $locale

 * @return bool

 */

function undismiss_core_update( $version, $locale ) {

	$dismissed = get_site_option( 'dismissed_update_core' );

	$key       = $version . '|' . $locale;

	if ( ! isset( $dismissed[ $key ] ) ) {

		return false;

	}

	unset( $dismissed[ $key ] );

	return update_site_option( 'dismissed_update_core', $dismissed );

}

/**

 * Finds the available update for WordPress core.

 *

 * @since 2.7.0

 *

 * @param string $version Version string to find the update for.

 * @param string $locale  Locale to find the update for.

 * @return object|false The core update offering on success, false on failure.

 */

function find_core_update( $version, $locale ) {

	$from_api = get_site_transient( 'update_core' );

	if ( ! isset( $from_api->updates ) || ! is_array( $from_api->updates ) ) {

		return false;

	}

	$updates = $from_api->updates;

	foreach ( $updates as $update ) {

		if ( $update->current === $version && $update->locale === $locale ) {

			return $update;

		}

	}

	return false;

}

/**

 * Returns core update footer message.

 *

 * @since 2.3.0

 *

 * @param string $msg

 * @return string

 */

function core_update_footer( $msg = '' ) {

	if ( ! current_user_can( 'update_core' ) ) {

		/* translators: %s: WordPress version. */

		return sprintf( __( 'Version %s' ), get_bloginfo( 'version', 'display' ) );

	}

	$cur = get_preferred_from_update_core();

	if ( ! is_object( $cur ) ) {

		$cur = new stdClass();

	}

	if ( ! isset( $cur->current ) ) {

		$cur->current = '';

	}

	if ( ! isset( $cur->response ) ) {

		$cur->response = '';

	}

	$is_development_version = preg_match( '/alpha|beta|RC/', wp_get_wp_version() );

	if ( $is_development_version ) {

		return sprintf(

			/* translators: 1: WordPress version number, 2: URL to WordPress Updates screen. */

			__( 'You are using a development version (%1$s). Cool! Please <a href="%2$s">stay updated</a>.' ),

			get_bloginfo( 'version', 'display' ),

			network_admin_url( 'update-core.php' )

		);

	}

	switch ( $cur->response ) {

		case 'upgrade':

			return sprintf(

				'<strong><a href="%s">%s</a></strong>',

				network_admin_url( 'update-core.php' ),

				/* translators: %s: WordPress version. */

				sprintf( __( 'Get Version %s' ), $cur->current )

			);

		case 'latest':

		default:

			/* translators: %s: WordPress version. */

			return sprintf( __( 'Version %s' ), get_bloginfo( 'version', 'display' ) );

	}

}

/**

 * Returns core update notification message.

 *

 * @since 2.3.0

 *

 * @global string $pagenow The filename of the current screen.

 * @return void|false

 */

function update_nag() {

	global $pagenow;

	if ( is_multisite() && ! current_user_can( 'update_core' ) ) {

		return false;

	}

	if ( 'update-core.php' === $pagenow ) {

		return;

	}

	$cur = get_preferred_from_update_core();

	if ( ! isset( $cur->response ) || 'upgrade' !== $cur->response ) {

		return false;

	}

	$version_url = sprintf(

		/* translators: %s: WordPress version. */

		esc_url( __( 'https://wordpress.org/documentation/wordpress-version/version-%s/' ) ),

		sanitize_title( $cur->current )

	);

	if ( current_user_can( 'update_core' ) ) {

		$msg = sprintf(

			/* translators: 1: URL to WordPress release notes, 2: New WordPress version, 3: URL to network admin, 4: Accessibility text. */

			__( '<a href="%1$s">WordPress %2$s</a> is available! <a href="%3$s" aria-label="%4$s">Please update now</a>.' ),

			$version_url,

			$cur->current,

			network_admin_url( 'update-core.php' ),

			esc_attr__( 'Please update WordPress now' )

		);

	} else {

		$msg = sprintf(

			/* translators: 1: URL to WordPress release notes, 2: New WordPress version. */

			__( '<a href="%1$s">WordPress %2$s</a> is available! Please notify the site administrator.' ),

			$version_url,

			$cur->current

		);

	}

	wp_admin_notice(

		$msg,

		array(

			'type'               => 'warning',

			'additional_classes' => array( 'update-nag', 'inline' ),

			'paragraph_wrap'     => false,

		)

	);

}

/**

 * Displays WordPress version and active theme in the 'At a Glance' dashboard widget.

 *

 * @since 2.5.0

 */

function update_right_now_message() {

	$theme_name = wp_get_theme();

	if ( current_user_can( 'switch_themes' ) ) {

		$theme_name = sprintf( '<a href="themes.php">%1$s</a>', $theme_name );

	}

	$msg = '';

	if ( current_user_can( 'update_core' ) ) {

		$cur = get_preferred_from_update_core();

		if ( isset( $cur->response ) && 'upgrade' === $cur->response ) {

			$msg .= sprintf(

				'<a href="%s" class="button" aria-describedby="wp-version">%s</a> ',

				network_admin_url( 'update-core.php' ),

				/* translators: %s: WordPress version number, or 'Latest' string. */

				sprintf( __( 'Update to %s' ), $cur->current ? $cur->current : __( 'Latest' ) )

			);

		}

	}

	/* translators: 1: Version number, 2: Theme name. */

	$content = __( 'WordPress %1$s running %2$s theme.' );

	/**

	 * Filters the text displayed in the 'At a Glance' dashboard widget.

	 *

	 * Prior to 3.8.0, the widget was named 'Right Now'.

	 *

	 * @since 4.4.0

	 *

	 * @param string $content Default text.

	 */

	$content = apply_filters( 'update_right_now_text', $content );

	$msg .= sprintf( '<span id="wp-version">' . $content . '</span>', get_bloginfo( 'version', 'display' ), $theme_name );

	echo "<p id='wp-version-message'>$msg</p>";

}

/**

 * Retrieves plugins with updates available.

 *

 * @since 2.9.0

 *

 * @return object[]

 */

function get_plugin_updates() {

	$all_plugins     = get_plugins();

	$upgrade_plugins = array();

	$current         = get_site_transient( 'update_plugins' );

	foreach ( (array) $all_plugins as $plugin_file => $plugin_data ) {