2007-08-17 06:33:52 -04:00
< ? php
2008-10-10 14:21:16 -04:00
/**
* WordPress Administration Update API
*
* @ package WordPress
2009-09-14 17:13:25 -04:00
* @ subpackage Administration
2008-10-10 14:21:16 -04:00
*/
2007-08-17 06:33:52 -04:00
2008-03-11 12:13:07 -04:00
// The admin side of our 1.1 update system
2007-08-17 06:33:52 -04:00
2008-10-31 14:51:06 -04:00
/**
* Selects the first update version from the update_core option
*
* @ return object the response from the API
*/
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 ];
}
/**
* Get available core updates
*
* @ param array $options Set $options [ 'dismissed' ] to true to show dismissed upgrades too ,
2011-09-03 10:18:10 -04:00
* set $options [ 'available' ] to false to skip not - dismissed updates .
2008-10-31 14:51:06 -04:00
* @ return array Array of the update objects
*/
function get_core_updates ( $options = array () ) {
$options = array_merge ( array ( 'available' => true , 'dismissed' => false ), $options );
2010-01-08 15:49:55 -05:00
$dismissed = get_site_option ( 'dismissed_update_core' );
2008-10-31 14:51:06 -04:00
if ( ! is_array ( $dismissed ) ) $dismissed = array ();
2010-01-08 15:49:55 -05:00
$from_api = get_site_transient ( 'update_core' );
2008-11-04 12:12:03 -05:00
if ( empty ( $from_api ) )
return false ;
2009-04-15 15:55:41 -04:00
if ( ! isset ( $from_api -> updates ) || ! is_array ( $from_api -> updates ) ) return false ;
2008-11-04 12:12:03 -05:00
$updates = $from_api -> updates ;
if ( ! is_array ( $updates ) ) return false ;
2008-10-31 14:51:06 -04:00
$result = array ();
2008-11-04 12:12:03 -05:00
foreach ( $updates as $update ) {
2008-10-31 14:51:06 -04:00
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 ;
}
function dismiss_core_update ( $update ) {
2010-01-08 15:49:55 -05:00
$dismissed = get_site_option ( 'dismissed_update_core' );
2008-10-31 14:51:06 -04:00
$dismissed [ $update -> current . '|' . $update -> locale ] = true ;
2010-01-08 15:49:55 -05:00
return update_site_option ( 'dismissed_update_core' , $dismissed );
2008-10-31 14:51:06 -04:00
}
function undismiss_core_update ( $version , $locale ) {
2010-01-08 15:49:55 -05:00
$dismissed = get_site_option ( 'dismissed_update_core' );
2008-10-31 14:51:06 -04:00
$key = $version . '|' . $locale ;
if ( ! isset ( $dismissed [ $key ] ) ) return false ;
unset ( $dismissed [ $key ] );
2010-01-08 15:49:55 -05:00
return update_site_option ( 'dismissed_update_core' , $dismissed );
2008-10-31 14:51:06 -04:00
}
function find_core_update ( $version , $locale ) {
2010-01-08 15:49:55 -05:00
$from_api = get_site_transient ( 'update_core' );
2008-11-04 12:12:03 -05:00
if ( ! is_array ( $from_api -> updates ) ) return false ;
$updates = $from_api -> updates ;
foreach ( $updates as $update ) {
2008-10-31 14:51:06 -04:00
if ( $update -> current == $version && $update -> locale == $locale )
return $update ;
}
return false ;
}
2008-01-04 14:36:34 -05:00
function core_update_footer ( $msg = '' ) {
2010-01-18 17:21:36 -05:00
if ( ! current_user_can ( 'update_core' ) )
2009-05-12 02:10:08 -04:00
return sprintf ( __ ( 'Version %s' ), $GLOBALS [ 'wp_version' ] );
2007-08-30 14:21:03 -04:00
2008-10-31 14:51:06 -04:00
$cur = get_preferred_from_update_core ();
2008-08-08 13:05:10 -04:00
if ( ! isset ( $cur -> current ) )
$cur -> current = '' ;
if ( ! isset ( $cur -> url ) )
$cur -> url = '' ;
2007-08-17 06:33:52 -04:00
2008-11-15 13:41:27 -05:00
if ( ! isset ( $cur -> response ) )
$cur -> response = '' ;
2007-08-17 06:33:52 -04:00
switch ( $cur -> response ) {
case 'development' :
2010-12-16 04:31:42 -05:00
return sprintf ( __ ( 'You are using a development version (%1$s). Cool! Please <a href="%2$s">stay updated</a>.' ), $GLOBALS [ 'wp_version' ], network_admin_url ( 'update-core.php' ) );
2007-08-17 06:33:52 -04:00
break ;
case 'upgrade' :
2010-12-16 04:31:42 -05:00
return sprintf ( '<strong>' . __ ( '<a href="%1$s">Get Version %2$s</a>' ) . '</strong>' , network_admin_url ( 'update-core.php' ), $cur -> current );
2010-01-18 17:21:36 -05:00
break ;
2007-08-17 06:33:52 -04:00
case 'latest' :
2007-08-30 12:25:50 -04:00
default :
2008-10-21 18:27:41 -04:00
return sprintf ( __ ( 'Version %s' ), $GLOBALS [ 'wp_version' ] );
2007-08-17 06:33:52 -04:00
break ;
}
}
add_filter ( 'update_footer' , 'core_update_footer' );
function update_nag () {
2010-01-18 17:21:36 -05:00
if ( is_multisite () && ! current_user_can ( 'update_core' ) )
2010-01-14 19:21:13 -05:00
return false ;
2008-11-13 16:10:53 -05:00
global $pagenow ;
if ( 'update-core.php' == $pagenow )
return ;
2008-10-31 14:51:06 -04:00
$cur = get_preferred_from_update_core ();
2007-08-20 03:01:15 -04:00
2007-08-30 14:21:03 -04:00
if ( ! isset ( $cur -> response ) || $cur -> response != 'upgrade' )
return false ;
2007-08-20 03:01:15 -04:00
2010-12-06 10:41:19 -05:00
if ( current_user_can ( 'update_core' ) ) {
2010-12-16 04:31:42 -05:00
$msg = sprintf ( __ ( '<a href="http://codex.wordpress.org/Version_%1$s">WordPress %1$s</a> is available! <a href="%2$s">Please update now</a>.' ), $cur -> current , network_admin_url ( 'update-core.php' ) );
2010-12-06 10:41:19 -05:00
} else {
2010-02-20 07:28:10 -05:00
$msg = sprintf ( __ ( '<a href="http://codex.wordpress.org/Version_%1$s">WordPress %1$s</a> is available! Please notify the site administrator.' ), $cur -> current );
2010-12-06 10:41:19 -05:00
}
2010-04-30 11:37:46 -04:00
echo " <div class='update-nag'> $msg </div> " ;
2007-08-17 06:33:52 -04:00
}
2008-11-10 13:17:47 -05:00
add_action ( 'admin_notices' , 'update_nag' , 3 );
2007-08-17 06:33:52 -04:00
2008-03-11 12:13:07 -04:00
// Called directly from dashboard
function update_right_now_message () {
2008-10-31 00:23:17 -04:00
$msg = sprintf ( __ ( 'You are using <span class="b">WordPress %s</span>.' ), $GLOBALS [ 'wp_version' ] );
2010-12-06 10:41:19 -05:00
2011-09-30 13:31:52 -04:00
if ( current_user_can ( 'update_core' ) ) {
$cur = get_preferred_from_update_core ();
2011-12-14 12:36:38 -05:00
if ( isset ( $cur -> response ) && $cur -> response == 'upgrade' )
2011-09-30 13:31:52 -04:00
$msg .= " <a href=' " . network_admin_url ( 'update-core.php' ) . " ' class='button'> " . sprintf ( __ ( 'Update to %s' ), $cur -> current ? $cur -> current : __ ( 'Latest' ) ) . '</a>' ;
2010-12-06 10:41:19 -05:00
}
2008-03-11 12:13:07 -04:00
echo " <span id='wp-version-message'> $msg </span> " ;
}
2009-10-20 12:11:59 -04:00
function get_plugin_updates () {
$all_plugins = get_plugins ();
$upgrade_plugins = array ();
2010-01-08 15:49:55 -05:00
$current = get_site_transient ( 'update_plugins' );
2009-10-20 12:11:59 -04:00
foreach ( ( array ) $all_plugins as $plugin_file => $plugin_data ) {
if ( isset ( $current -> response [ $plugin_file ] ) ) {
$upgrade_plugins [ $plugin_file ] = ( object ) $plugin_data ;
$upgrade_plugins [ $plugin_file ] -> update = $current -> response [ $plugin_file ];
}
}
return $upgrade_plugins ;
}
2009-08-04 17:52:31 -04:00
function wp_plugin_update_rows () {
2010-01-18 17:21:36 -05:00
if ( ! current_user_can ( 'update_plugins' ) )
return ;
2010-01-08 15:49:55 -05:00
$plugins = get_site_transient ( 'update_plugins' );
2009-08-07 05:33:40 -04:00
if ( isset ( $plugins -> response ) && is_array ( $plugins -> response ) ) {
$plugins = array_keys ( $plugins -> response );
foreach ( $plugins as $plugin_file ) {
add_action ( " after_plugin_row_ $plugin_file " , 'wp_plugin_update_row' , 10 , 2 );
}
2009-08-04 17:52:31 -04:00
}
}
add_action ( 'admin_init' , 'wp_plugin_update_rows' );
2008-06-04 14:09:31 -04:00
function wp_plugin_update_row ( $file , $plugin_data ) {
2010-01-08 15:49:55 -05:00
$current = get_site_transient ( 'update_plugins' );
2007-08-22 06:48:48 -04:00
if ( ! isset ( $current -> response [ $file ] ) )
return false ;
$r = $current -> response [ $file ];
2009-05-11 00:50:36 -04:00
$plugins_allowedtags = array ( 'a' => array ( 'href' => array (), 'title' => array ()), 'abbr' => array ( 'title' => array ()), 'acronym' => array ( 'title' => array ()), 'code' => array (), 'em' => array (), 'strong' => array ());
$plugin_name = wp_kses ( $plugin_data [ 'Name' ], $plugins_allowedtags );
2009-05-24 19:47:49 -04:00
2012-01-08 07:36:17 -05:00
$details_url = self_admin_url ( 'plugin-install.php?tab=plugin-information&plugin=' . $r -> slug . '§ion=changelog&TB_iframe=true&width=600&height=800' );
2008-08-04 17:01:09 -04:00
2011-01-16 16:47:24 -05:00
$wp_list_table = _get_list_table ( 'WP_Plugins_List_Table' );
2010-11-14 13:00:09 -05:00
2010-10-28 04:31:16 -04:00
if ( is_network_admin () || ! is_multisite () ) {
2010-11-14 13:00:09 -05:00
echo '<tr class="plugin-update-tr"><td colspan="' . $wp_list_table -> get_column_count () . '" class="plugin-update colspanchange"><div class="update-message">' ;
2011-05-22 17:24:32 -04:00
2010-10-28 04:31:16 -04:00
if ( ! current_user_can ( 'update_plugins' ) )
printf ( __ ( 'There is a new version of %1$s available. <a href="%2$s" class="thickbox" title="%3$s">View version %4$s details</a>.' ), $plugin_name , esc_url ( $details_url ), esc_attr ( $plugin_name ), $r -> new_version );
else if ( empty ( $r -> package ) )
2010-12-02 16:45:47 -05:00
printf ( __ ( 'There is a new version of %1$s available. <a href="%2$s" class="thickbox" title="%3$s">View version %4$s details</a>. <em>Automatic update is unavailable for this plugin.</em>' ), $plugin_name , esc_url ( $details_url ), esc_attr ( $plugin_name ), $r -> new_version );
2010-10-28 04:31:16 -04:00
else
2012-03-21 12:19:27 -04:00
printf ( __ ( 'There is a new version of %1$s available. <a href="%2$s" class="thickbox" title="%3$s">View version %4$s details</a> or <a href="%5$s">update now</a>.' ), $plugin_name , esc_url ( $details_url ), esc_attr ( $plugin_name ), $r -> new_version , wp_nonce_url ( self_admin_url ( 'update.php?action=upgrade-plugin&plugin=' ) . $file , 'upgrade-plugin_' . $file ) );
2009-05-24 19:47:49 -04:00
2011-05-22 17:24:32 -04:00
do_action ( " in_plugin_update_message- $file " , $plugin_data , $r );
2009-05-24 19:47:49 -04:00
2011-05-22 17:24:32 -04:00
echo '</div></td></tr>' ;
}
2007-08-22 06:48:48 -04:00
}
2008-02-11 00:45:54 -05:00
function wp_update_plugin ( $plugin , $feedback = '' ) {
if ( ! empty ( $feedback ) )
add_filter ( 'update_feedback' , $feedback );
2009-04-19 15:36:28 -04:00
include ABSPATH . 'wp-admin/includes/class-wp-upgrader.php' ;
$upgrader = new Plugin_Upgrader ();
return $upgrader -> upgrade ( $plugin );
2008-02-11 00:45:54 -05:00
}
2009-10-20 12:11:59 -04:00
function get_theme_updates () {
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 16:24:44 -05:00
$themes = wp_get_themes ();
2010-01-08 15:49:55 -05:00
$current = get_site_transient ( 'update_themes' );
2009-10-20 12:11:59 -04:00
2012-04-11 16:15:31 -04:00
if ( ! isset ( $current -> response ) )
return array ();
2012-05-03 12:41:59 -04:00
$update_themes = array ();
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 16:24:44 -05:00
foreach ( $current -> response as $stylesheet => $data ) {
$update_themes [ $stylesheet ] = wp_get_theme ( $stylesheet );
$update_themes [ $stylesheet ] -> update = $data ;
2009-10-20 12:11:59 -04:00
}
return $update_themes ;
}
2008-09-26 02:43:53 -04:00
function wp_update_theme ( $theme , $feedback = '' ) {
if ( ! empty ( $feedback ) )
add_filter ( 'update_feedback' , $feedback );
2009-04-19 15:36:28 -04:00
include ABSPATH . 'wp-admin/includes/class-wp-upgrader.php' ;
$upgrader = new Theme_Upgrader ();
return $upgrader -> upgrade ( $theme );
2008-09-26 02:43:53 -04:00
}
2010-11-01 16:08:25 -04:00
function wp_theme_update_rows () {
if ( ! current_user_can ( 'update_themes' ) )
return ;
$themes = get_site_transient ( 'update_themes' );
if ( isset ( $themes -> response ) && is_array ( $themes -> response ) ) {
$themes = array_keys ( $themes -> response );
foreach ( $themes as $theme ) {
add_action ( " after_theme_row_ $theme " , 'wp_theme_update_row' , 10 , 2 );
}
}
}
add_action ( 'admin_init' , 'wp_theme_update_rows' );
function wp_theme_update_row ( $theme_key , $theme ) {
$current = get_site_transient ( 'update_themes' );
if ( ! isset ( $current -> response [ $theme_key ] ) )
return false ;
$r = $current -> response [ $theme_key ];
$themes_allowedtags = array ( 'a' => array ( 'href' => array (), 'title' => array ()), 'abbr' => array ( 'title' => array ()), 'acronym' => array ( 'title' => array ()), 'code' => array (), 'em' => array (), 'strong' => array ());
$theme_name = wp_kses ( $theme [ 'Name' ], $themes_allowedtags );
2012-06-25 16:28:33 -04:00
$details_url = add_query_arg ( array ( 'TB_iframe' => 'true' , 'width' => 1024 , 'height' => 800 ), $current -> response [ $theme_key ][ 'url' ] );
2010-11-01 16:08:25 -04:00
2011-01-16 16:47:24 -05:00
$wp_list_table = _get_list_table ( 'WP_MS_Themes_List_Table' );
2010-11-14 13:00:09 -05:00
echo '<tr class="plugin-update-tr"><td colspan="' . $wp_list_table -> get_column_count () . '" class="plugin-update colspanchange"><div class="update-message">' ;
2010-11-01 16:08:25 -04:00
if ( ! current_user_can ( 'update_themes' ) )
printf ( __ ( 'There is a new version of %1$s available. <a href="%2$s" class="thickbox" title="%3$s">View version %4$s details</a>.' ), $theme [ 'Name' ], esc_url ( $details_url ), esc_attr ( $theme [ 'Name' ]), $r -> new_version );
else if ( empty ( $r [ 'package' ] ) )
2012-02-01 11:08:36 -05:00
printf ( __ ( 'There is a new version of %1$s available. <a href="%2$s" class="thickbox" title="%3$s">View version %4$s details</a>. <em>Automatic update is unavailable for this theme.</em>' ), $theme [ 'Name' ], esc_url ( $details_url ), esc_attr ( $theme [ 'Name' ]), $r [ 'new_version' ] );
2010-11-01 16:08:25 -04:00
else
2012-03-21 12:19:27 -04:00
printf ( __ ( 'There is a new version of %1$s available. <a href="%2$s" class="thickbox" title="%3$s">View version %4$s details</a> or <a href="%5$s">update now</a>.' ), $theme [ 'Name' ], esc_url ( $details_url ), esc_attr ( $theme [ 'Name' ]), $r [ 'new_version' ], wp_nonce_url ( self_admin_url ( 'update.php?action=upgrade-theme&theme=' ) . $theme_key , 'upgrade-theme_' . $theme_key ) );
2010-11-01 16:08:25 -04:00
do_action ( " in_theme_update_message- $theme_key " , $theme , $r );
echo '</div></td></tr>' ;
}
2008-09-26 02:43:53 -04:00
2008-10-31 14:51:06 -04:00
function wp_update_core ( $current , $feedback = '' ) {
2008-08-08 18:49:35 -04:00
if ( ! empty ( $feedback ) )
add_filter ( 'update_feedback' , $feedback );
2009-04-19 15:36:28 -04:00
include ABSPATH . 'wp-admin/includes/class-wp-upgrader.php' ;
$upgrader = new Core_Upgrader ();
return $upgrader -> upgrade ( $current );
2008-08-08 18:49:35 -04:00
}
2008-10-25 18:22:29 -04:00
function maintenance_nag () {
global $upgrading ;
if ( ! isset ( $upgrading ) )
return false ;
2010-01-18 17:21:36 -05:00
if ( current_user_can ( 'update_core' ) )
2008-11-05 22:31:41 -05:00
$msg = sprintf ( __ ( 'An automated WordPress update has failed to complete - <a href="%s">please attempt the update again now</a>.' ), 'update-core.php' );
2008-10-25 18:22:29 -04:00
else
$msg = __ ( 'An automated WordPress update has failed to complete! Please notify the site administrator.' );
2010-04-30 11:37:46 -04:00
echo " <div class='update-nag'> $msg </div> " ;
2008-10-25 18:22:29 -04:00
}
add_action ( 'admin_notices' , 'maintenance_nag' );