3 * WordPress Administration Update API
6 * @subpackage Administration
9 // The admin side of our 1.1 update system
12 * Selects the first update version from the update_core option
14 * @return object the response from the API
16 function get_preferred_from_update_core() {
17 $updates = get_core_updates();
18 if ( !is_array( $updates ) )
20 if ( empty( $updates ) )
21 return (object)array('response' => 'latest');
26 * Get available core updates
28 * @param array $options Set $options['dismissed'] to true to show dismissed upgrades too,
29 * set $options['available'] to false to skip not-dismissed updates.
30 * @return array Array of the update objects
32 function get_core_updates( $options = array() ) {
33 $options = array_merge( array('available' => true, 'dismissed' => false ), $options );
34 $dismissed = get_site_option( 'dismissed_update_core' );
35 if ( !is_array( $dismissed ) ) $dismissed = array();
36 $from_api = get_site_transient( 'update_core' );
37 if ( empty($from_api) )
39 if ( !isset( $from_api->updates ) || !is_array( $from_api->updates ) ) return false;
40 $updates = $from_api->updates;
41 if ( !is_array( $updates ) ) return false;
43 foreach($updates as $update) {
44 if ( array_key_exists( $update->current.'|'.$update->locale, $dismissed ) ) {
45 if ( $options['dismissed'] ) {
46 $update->dismissed = true;
50 if ( $options['available'] ) {
51 $update->dismissed = false;
59 function dismiss_core_update( $update ) {
60 $dismissed = get_site_option( 'dismissed_update_core' );
61 $dismissed[ $update->current.'|'.$update->locale ] = true;
62 return update_site_option( 'dismissed_update_core', $dismissed );
65 function undismiss_core_update( $version, $locale ) {
66 $dismissed = get_site_option( 'dismissed_update_core' );
67 $key = $version.'|'.$locale;
68 if ( !isset( $dismissed[$key] ) ) return false;
69 unset( $dismissed[$key] );
70 return update_site_option( 'dismissed_update_core', $dismissed );
73 function find_core_update( $version, $locale ) {
74 $from_api = get_site_transient( 'update_core' );
75 if ( !is_array( $from_api->updates ) ) return false;
76 $updates = $from_api->updates;
77 foreach($updates as $update) {
78 if ( $update->current == $version && $update->locale == $locale )
84 function core_update_footer( $msg = '' ) {
85 if ( !current_user_can('update_core') )
86 return sprintf( __( 'Version %s' ), get_bloginfo( 'version', 'display' ) );
88 $cur = get_preferred_from_update_core();
89 if ( ! is_object( $cur ) )
92 if ( ! isset( $cur->current ) )
95 if ( ! isset( $cur->url ) )
98 if ( ! isset( $cur->response ) )
101 switch ( $cur->response ) {
103 return sprintf( __( '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' ) );
107 return sprintf( '<strong>'.__( '<a href="%1$s">Get Version %2$s</a>' ).'</strong>', network_admin_url( 'update-core.php' ), $cur->current);
112 return sprintf( __( 'Version %s' ), get_bloginfo( 'version', 'display' ) );
116 add_filter( 'update_footer', 'core_update_footer' );
118 function update_nag() {
119 if ( is_multisite() && !current_user_can('update_core') )
124 if ( 'update-core.php' == $pagenow )
127 $cur = get_preferred_from_update_core();
129 if ( ! isset( $cur->response ) || $cur->response != 'upgrade' )
132 if ( current_user_can('update_core') ) {
133 $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' ) );
135 $msg = sprintf( __('<a href="http://codex.wordpress.org/Version_%1$s">WordPress %1$s</a> is available! Please notify the site administrator.'), $cur->current );
137 echo "<div class='update-nag'>$msg</div>";
139 add_action( 'admin_notices', 'update_nag', 3 );
140 add_action( 'network_admin_notices', 'update_nag', 3 );
142 // Called directly from dashboard
143 function update_right_now_message() {
144 $msg = sprintf( __( 'You are using <span class="b">WordPress %s</span>.' ), get_bloginfo( 'version', 'display' ) );
146 if ( current_user_can('update_core') ) {
147 $cur = get_preferred_from_update_core();
149 if ( isset( $cur->response ) && $cur->response == 'upgrade' )
150 $msg .= " <a href='" . network_admin_url( 'update-core.php' ) . "' class='button'>" . sprintf( __('Update to %s'), $cur->current ? $cur->current : __( 'Latest' ) ) . '</a>';
153 echo "<span id='wp-version-message'>$msg</span>";
156 function get_plugin_updates() {
157 $all_plugins = get_plugins();
158 $upgrade_plugins = array();
159 $current = get_site_transient( 'update_plugins' );
160 foreach ( (array)$all_plugins as $plugin_file => $plugin_data) {
161 if ( isset( $current->response[ $plugin_file ] ) ) {
162 $upgrade_plugins[ $plugin_file ] = (object) $plugin_data;
163 $upgrade_plugins[ $plugin_file ]->update = $current->response[ $plugin_file ];
167 return $upgrade_plugins;
170 function wp_plugin_update_rows() {
171 if ( !current_user_can('update_plugins' ) )
174 $plugins = get_site_transient( 'update_plugins' );
175 if ( isset($plugins->response) && is_array($plugins->response) ) {
176 $plugins = array_keys( $plugins->response );
177 foreach( $plugins as $plugin_file ) {
178 add_action( "after_plugin_row_$plugin_file", 'wp_plugin_update_row', 10, 2 );
182 add_action( 'admin_init', 'wp_plugin_update_rows' );
184 function wp_plugin_update_row( $file, $plugin_data ) {
185 $current = get_site_transient( 'update_plugins' );
186 if ( !isset( $current->response[ $file ] ) )
189 $r = $current->response[ $file ];
191 $plugins_allowedtags = array('a' => array('href' => array(),'title' => array()),'abbr' => array('title' => array()),'acronym' => array('title' => array()),'code' => array(),'em' => array(),'strong' => array());
192 $plugin_name = wp_kses( $plugin_data['Name'], $plugins_allowedtags );
194 $details_url = self_admin_url('plugin-install.php?tab=plugin-information&plugin=' . $r->slug . '§ion=changelog&TB_iframe=true&width=600&height=800');
196 $wp_list_table = _get_list_table('WP_Plugins_List_Table');
198 if ( is_network_admin() || !is_multisite() ) {
199 echo '<tr class="plugin-update-tr"><td colspan="' . $wp_list_table->get_column_count() . '" class="plugin-update colspanchange"><div class="update-message">';
201 if ( ! current_user_can('update_plugins') )
202 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 );
203 else if ( empty($r->package) )
204 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 );
206 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) );
208 do_action( "in_plugin_update_message-$file", $plugin_data, $r );
210 echo '</div></td></tr>';
214 function wp_update_plugin($plugin, $feedback = '') {
215 if ( !empty($feedback) )
216 add_filter('update_feedback', $feedback);
218 include ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
219 $upgrader = new Plugin_Upgrader();
220 return $upgrader->upgrade($plugin);
223 function get_theme_updates() {
224 $themes = wp_get_themes();
225 $current = get_site_transient('update_themes');
227 if ( ! isset( $current->response ) )
230 $update_themes = array();
231 foreach ( $current->response as $stylesheet => $data ) {
232 $update_themes[ $stylesheet ] = wp_get_theme( $stylesheet );
233 $update_themes[ $stylesheet ]->update = $data;
236 return $update_themes;
239 function wp_update_theme($theme, $feedback = '') {
240 if ( !empty($feedback) )
241 add_filter('update_feedback', $feedback);
243 include ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
244 $upgrader = new Theme_Upgrader();
245 return $upgrader->upgrade($theme);
248 function wp_theme_update_rows() {
249 if ( !current_user_can('update_themes' ) )
252 $themes = get_site_transient( 'update_themes' );
253 if ( isset($themes->response) && is_array($themes->response) ) {
254 $themes = array_keys( $themes->response );
256 foreach( $themes as $theme ) {
257 add_action( "after_theme_row_$theme", 'wp_theme_update_row', 10, 2 );
261 add_action( 'admin_init', 'wp_theme_update_rows' );
263 function wp_theme_update_row( $theme_key, $theme ) {
264 $current = get_site_transient( 'update_themes' );
265 if ( !isset( $current->response[ $theme_key ] ) )
267 $r = $current->response[ $theme_key ];
268 $themes_allowedtags = array('a' => array('href' => array(),'title' => array()),'abbr' => array('title' => array()),'acronym' => array('title' => array()),'code' => array(),'em' => array(),'strong' => array());
269 $theme_name = wp_kses( $theme['Name'], $themes_allowedtags );
271 $details_url = add_query_arg( array( 'TB_iframe' => 'true', 'width' => 1024, 'height' => 800 ), $current->response[ $theme_key ]['url'] );
273 $wp_list_table = _get_list_table('WP_MS_Themes_List_Table');
275 echo '<tr class="plugin-update-tr"><td colspan="' . $wp_list_table->get_column_count() . '" class="plugin-update colspanchange"><div class="update-message">';
276 if ( ! current_user_can('update_themes') )
277 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 );
278 else if ( empty( $r['package'] ) )
279 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'] );
281 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) );
283 do_action( "in_theme_update_message-$theme_key", $theme, $r );
285 echo '</div></td></tr>';
288 function wp_update_core($current, $feedback = '') {
289 if ( !empty($feedback) )
290 add_filter('update_feedback', $feedback);
292 include ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
293 $upgrader = new Core_Upgrader();
294 return $upgrader->upgrade($current);
298 function maintenance_nag() {
300 if ( ! isset( $upgrading ) )
303 if ( current_user_can('update_core') )
304 $msg = sprintf( __('An automated WordPress update has failed to complete - <a href="%s">please attempt the update again now</a>.'), 'update-core.php' );
306 $msg = __('An automated WordPress update has failed to complete! Please notify the site administrator.');
308 echo "<div class='update-nag'>$msg</div>";
310 add_action( 'admin_notices', 'maintenance_nag' );