WordPress.org

Make WordPress Core

Changeset 25227


Ignore:
Timestamp:
09/04/13 06:34:38 (4 years ago)
Author:
dd32
Message:

Upgrader: Split the UI "skins" out from the main Upgrader file into a seperate file to reduce the length of the files. See #22704

Location:
trunk/src/wp-admin/includes
Files:
1 edited
1 copied

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-admin/includes/class-wp-upgrader-skins.php

    r25226 r25227  
    11<?php 
    22/** 
    3  * A File upgrader class for WordPress. 
    4  * 
    5  * This set of classes are designed to be used to upgrade/install a local set of files on the filesystem via the Filesystem Abstraction classes. 
    6  * 
    7  * @link http://trac.wordpress.org/ticket/7875 consolidate plugin/theme/core upgrade/install functions 
     3 * The User Interface "Skins" for the WordPress File Upgrader 
    84 * 
    95 * @package WordPress 
     
    139 
    1410/** 
    15  * WordPress Upgrader class for Upgrading/Installing a local set of files via the Filesystem Abstraction classes from a Zip file. 
    16  * 
    17  * @TODO More Detailed docs, for methods as well. 
    18  * 
    19  * @package WordPress 
    20  * @subpackage Upgrader 
    21  * @since 2.8.0 
    22  */ 
    23 class WP_Upgrader { 
    24     var $strings = array(); 
    25     var $skin = null; 
    26     var $result = array(); 
    27  
    28     function __construct($skin = null) { 
    29         if ( null == $skin ) 
    30             $this->skin = new WP_Upgrader_Skin(); 
    31         else 
    32             $this->skin = $skin; 
    33     } 
    34  
    35     function init() { 
    36         $this->skin->set_upgrader($this); 
    37         $this->generic_strings(); 
    38     } 
    39  
    40     function generic_strings() { 
    41         $this->strings['bad_request'] = __('Invalid Data provided.'); 
    42         $this->strings['fs_unavailable'] = __('Could not access filesystem.'); 
    43         $this->strings['fs_error'] = __('Filesystem error.'); 
    44         $this->strings['fs_no_root_dir'] = __('Unable to locate WordPress Root directory.'); 
    45         $this->strings['fs_no_content_dir'] = __('Unable to locate WordPress Content directory (wp-content).'); 
    46         $this->strings['fs_no_plugins_dir'] = __('Unable to locate WordPress Plugin directory.'); 
    47         $this->strings['fs_no_themes_dir'] = __('Unable to locate WordPress Theme directory.'); 
    48         /* translators: %s: directory name */ 
    49         $this->strings['fs_no_folder'] = __('Unable to locate needed folder (%s).'); 
    50  
    51         $this->strings['download_failed'] = __('Download failed.'); 
    52         $this->strings['installing_package'] = __('Installing the latest version&#8230;'); 
    53         $this->strings['no_files'] = __('The package contains no files.'); 
    54         $this->strings['folder_exists'] = __('Destination folder already exists.'); 
    55         $this->strings['mkdir_failed'] = __('Could not create directory.'); 
    56         $this->strings['incompatible_archive'] = __('The package could not be installed.'); 
    57  
    58         $this->strings['maintenance_start'] = __('Enabling Maintenance mode&#8230;'); 
    59         $this->strings['maintenance_end'] = __('Disabling Maintenance mode&#8230;'); 
    60     } 
    61  
    62     function fs_connect( $directories = array() ) { 
    63         global $wp_filesystem; 
    64  
    65         if ( false === ($credentials = $this->skin->request_filesystem_credentials()) ) 
    66             return false; 
    67  
    68         if ( ! WP_Filesystem($credentials) ) { 
    69             $error = true; 
    70             if ( is_object($wp_filesystem) && $wp_filesystem->errors->get_error_code() ) 
    71                 $error = $wp_filesystem->errors; 
    72             $this->skin->request_filesystem_credentials($error); //Failed to connect, Error and request again 
    73             return false; 
    74         } 
    75  
    76         if ( ! is_object($wp_filesystem) ) 
    77             return new WP_Error('fs_unavailable', $this->strings['fs_unavailable'] ); 
    78  
    79         if ( is_wp_error($wp_filesystem->errors) && $wp_filesystem->errors->get_error_code() ) 
    80             return new WP_Error('fs_error', $this->strings['fs_error'], $wp_filesystem->errors); 
    81  
    82         foreach ( (array)$directories as $dir ) { 
    83             switch ( $dir ) { 
    84                 case ABSPATH: 
    85                     if ( ! $wp_filesystem->abspath() ) 
    86                         return new WP_Error('fs_no_root_dir', $this->strings['fs_no_root_dir']); 
    87                     break; 
    88                 case WP_CONTENT_DIR: 
    89                     if ( ! $wp_filesystem->wp_content_dir() ) 
    90                         return new WP_Error('fs_no_content_dir', $this->strings['fs_no_content_dir']); 
    91                     break; 
    92                 case WP_PLUGIN_DIR: 
    93                     if ( ! $wp_filesystem->wp_plugins_dir() ) 
    94                         return new WP_Error('fs_no_plugins_dir', $this->strings['fs_no_plugins_dir']); 
    95                     break; 
    96                 case get_theme_root(): 
    97                     if ( ! $wp_filesystem->wp_themes_dir() ) 
    98                         return new WP_Error('fs_no_themes_dir', $this->strings['fs_no_themes_dir']); 
    99                     break; 
    100                 default: 
    101                     if ( ! $wp_filesystem->find_folder($dir) ) 
    102                         return new WP_Error( 'fs_no_folder', sprintf( $this->strings['fs_no_folder'], esc_html( basename( $dir ) ) ) ); 
    103                     break; 
    104             } 
    105         } 
    106         return true; 
    107     } //end fs_connect(); 
    108  
    109     function download_package($package) { 
    110  
    111         if ( ! preg_match('!^(http|https|ftp)://!i', $package) && file_exists($package) ) //Local file or remote? 
    112             return $package; //must be a local file.. 
    113  
    114         if ( empty($package) ) 
    115             return new WP_Error('no_package', $this->strings['no_package']); 
    116  
    117         $this->skin->feedback('downloading_package', $package); 
    118  
    119         $download_file = download_url($package); 
    120  
    121         if ( is_wp_error($download_file) ) 
    122             return new WP_Error('download_failed', $this->strings['download_failed'], $download_file->get_error_message()); 
    123  
    124         return $download_file; 
    125     } 
    126  
    127     function unpack_package($package, $delete_package = true) { 
    128         global $wp_filesystem; 
    129  
    130         $this->skin->feedback('unpack_package'); 
    131  
    132         $upgrade_folder = $wp_filesystem->wp_content_dir() . 'upgrade/'; 
    133  
    134         //Clean up contents of upgrade directory beforehand. 
    135         $upgrade_files = $wp_filesystem->dirlist($upgrade_folder); 
    136         if ( !empty($upgrade_files) ) { 
    137             foreach ( $upgrade_files as $file ) 
    138                 $wp_filesystem->delete($upgrade_folder . $file['name'], true); 
    139         } 
    140  
    141         //We need a working directory 
    142         $working_dir = $upgrade_folder . basename($package, '.zip'); 
    143  
    144         // Clean up working directory 
    145         if ( $wp_filesystem->is_dir($working_dir) ) 
    146             $wp_filesystem->delete($working_dir, true); 
    147  
    148         // Unzip package to working directory 
    149         $result = unzip_file($package, $working_dir); //TODO optimizations, Copy when Move/Rename would suffice? 
    150  
    151         // Once extracted, delete the package if required. 
    152         if ( $delete_package ) 
    153             unlink($package); 
    154  
    155         if ( is_wp_error($result) ) { 
    156             $wp_filesystem->delete($working_dir, true); 
    157             if ( 'incompatible_archive' == $result->get_error_code() ) { 
    158                 return new WP_Error( 'incompatible_archive', $this->strings['incompatible_archive'], $result->get_error_data() ); 
    159             } 
    160             return $result; 
    161         } 
    162  
    163         return $working_dir; 
    164     } 
    165  
    166     function install_package($args = array()) { 
    167         global $wp_filesystem, $wp_theme_directories; 
    168  
    169         $defaults = array( 'source' => '', 'destination' => '', //Please always pass these 
    170                         'clear_destination' => false, 'clear_working' => false, 
    171                         'abort_if_destination_exists' => true, 
    172                         'hook_extra' => array()); 
    173  
    174         $args = wp_parse_args($args, $defaults); 
    175         extract($args); 
    176  
    177         @set_time_limit( 300 ); 
    178  
    179         if ( empty($source) || empty($destination) ) 
    180             return new WP_Error('bad_request', $this->strings['bad_request']); 
    181  
    182         $this->skin->feedback('installing_package'); 
    183  
    184         $res = apply_filters('upgrader_pre_install', true, $hook_extra); 
    185         if ( is_wp_error($res) ) 
    186             return $res; 
    187  
    188         //Retain the Original source and destinations 
    189         $remote_source = $source; 
    190         $local_destination = $destination; 
    191  
    192         $source_files = array_keys( $wp_filesystem->dirlist($remote_source) ); 
    193         $remote_destination = $wp_filesystem->find_folder($local_destination); 
    194  
    195         //Locate which directory to copy to the new folder, This is based on the actual folder holding the files. 
    196         if ( 1 == count($source_files) && $wp_filesystem->is_dir( trailingslashit($source) . $source_files[0] . '/') ) //Only one folder? Then we want its contents. 
    197             $source = trailingslashit($source) . trailingslashit($source_files[0]); 
    198         elseif ( count($source_files) == 0 ) 
    199             return new WP_Error( 'incompatible_archive', $this->strings['incompatible_archive'], $this->strings['no_files'] ); //There are no files? 
    200         else //It's only a single file, the upgrader will use the foldername of this file as the destination folder. foldername is based on zip filename. 
    201             $source = trailingslashit($source); 
    202  
    203         //Hook ability to change the source file location.. 
    204         $source = apply_filters('upgrader_source_selection', $source, $remote_source, $this); 
    205         if ( is_wp_error($source) ) 
    206             return $source; 
    207  
    208         //Has the source location changed? If so, we need a new source_files list. 
    209         if ( $source !== $remote_source ) 
    210             $source_files = array_keys( $wp_filesystem->dirlist($source) ); 
    211  
    212         // Protection against deleting files in any important base directories. 
    213         // Theme_Upgrader & Plugin_Upgrader also trigger this, as they pass the destination directory (WP_PLUGIN_DIR / wp-content/themes) 
    214         // intending to copy the directory into the directory, whilst they pass the source as the actual files to copy. 
    215         $protected_directories = array( ABSPATH, WP_CONTENT_DIR, WP_PLUGIN_DIR, WP_CONTENT_DIR . '/themes' ); 
    216         if ( is_array( $wp_theme_directories ) ) 
    217             $protected_directories = array_merge( $protected_directories, $wp_theme_directories ); 
    218         if ( in_array( $destination, $protected_directories ) ) { 
    219             $remote_destination = trailingslashit($remote_destination) . trailingslashit(basename($source)); 
    220             $destination = trailingslashit($destination) . trailingslashit(basename($source)); 
    221         } 
    222  
    223         if ( $clear_destination ) { 
    224             //We're going to clear the destination if there's something there 
    225             $this->skin->feedback('remove_old'); 
    226             $removed = true; 
    227             if ( $wp_filesystem->exists($remote_destination) ) 
    228                 $removed = $wp_filesystem->delete($remote_destination, true); 
    229             $removed = apply_filters('upgrader_clear_destination', $removed, $local_destination, $remote_destination, $hook_extra); 
    230  
    231             if ( is_wp_error($removed) ) 
    232                 return $removed; 
    233             else if ( ! $removed ) 
    234                 return new WP_Error('remove_old_failed', $this->strings['remove_old_failed']); 
    235         } elseif ( $abort_if_destination_exists && $wp_filesystem->exists($remote_destination) ) { 
    236             //If we're not clearing the destination folder and something exists there already, Bail. 
    237             //But first check to see if there are actually any files in the folder. 
    238             $_files = $wp_filesystem->dirlist($remote_destination); 
    239             if ( ! empty($_files) ) { 
    240                 $wp_filesystem->delete($remote_source, true); //Clear out the source files. 
    241                 return new WP_Error('folder_exists', $this->strings['folder_exists'], $remote_destination ); 
    242             } 
    243         } 
    244  
    245         //Create destination if needed 
    246         if ( !$wp_filesystem->exists($remote_destination) ) 
    247             if ( !$wp_filesystem->mkdir($remote_destination, FS_CHMOD_DIR) ) 
    248                 return new WP_Error('mkdir_failed', $this->strings['mkdir_failed'], $remote_destination); 
    249  
    250         // Copy new version of item into place. 
    251         $result = copy_dir($source, $remote_destination); 
    252         if ( is_wp_error($result) ) { 
    253             if ( $clear_working ) 
    254                 $wp_filesystem->delete($remote_source, true); 
    255             return $result; 
    256         } 
    257  
    258         //Clear the Working folder? 
    259         if ( $clear_working ) 
    260             $wp_filesystem->delete($remote_source, true); 
    261  
    262         $destination_name = basename( str_replace($local_destination, '', $destination) ); 
    263         if ( '.' == $destination_name ) 
    264             $destination_name = ''; 
    265  
    266         $this->result = compact('local_source', 'source', 'source_name', 'source_files', 'destination', 'destination_name', 'local_destination', 'remote_destination', 'clear_destination', 'delete_source_dir'); 
    267  
    268         $res = apply_filters('upgrader_post_install', true, $hook_extra, $this->result); 
    269         if ( is_wp_error($res) ) { 
    270             $this->result = $res; 
    271             return $res; 
    272         } 
    273  
    274         //Bombard the calling function will all the info which we've just used. 
    275         return $this->result; 
    276     } 
    277  
    278     function run($options) { 
    279  
    280         $defaults = array(  'package' => '', //Please always pass this. 
    281                             'destination' => '', //And this 
    282                             'clear_destination' => false, 
    283                             'abort_if_destination_exists' => true, // Abort if the Destination directory exists, Pass clear_destination as false please 
    284                             'clear_working' => true, 
    285                             'is_multi' => false, 
    286                             'hook_extra' => array() //Pass any extra $hook_extra args here, this will be passed to any hooked filters. 
    287                         ); 
    288  
    289         $options = wp_parse_args($options, $defaults); 
    290         extract($options); 
    291  
    292         //Connect to the Filesystem first. 
    293         $res = $this->fs_connect( array(WP_CONTENT_DIR, $destination) ); 
    294         if ( ! $res ) //Mainly for non-connected filesystem. 
    295             return false; 
    296  
    297         if ( is_wp_error($res) ) { 
    298             $this->skin->error($res); 
    299             return $res; 
    300         } 
    301  
    302         if ( !$is_multi ) // call $this->header separately if running multiple times 
    303             $this->skin->header(); 
    304  
    305         $this->skin->before(); 
    306  
    307         //Download the package (Note, This just returns the filename of the file if the package is a local file) 
    308         $download = $this->download_package( $package ); 
    309         if ( is_wp_error($download) ) { 
    310             $this->skin->error($download); 
    311             $this->skin->after(); 
    312             return $download; 
    313         } 
    314  
    315         $delete_package = ($download != $package); // Do not delete a "local" file 
    316  
    317         //Unzips the file into a temporary directory 
    318         $working_dir = $this->unpack_package( $download, $delete_package ); 
    319         if ( is_wp_error($working_dir) ) { 
    320             $this->skin->error($working_dir); 
    321             $this->skin->after(); 
    322             return $working_dir; 
    323         } 
    324  
    325         //With the given options, this installs it to the destination directory. 
    326         $result = $this->install_package( array( 
    327                                             'source' => $working_dir, 
    328                                             'destination' => $destination, 
    329                                             'clear_destination' => $clear_destination, 
    330                                             'abort_if_destination_exists' => $abort_if_destination_exists, 
    331                                             'clear_working' => $clear_working, 
    332                                             'hook_extra' => $hook_extra 
    333                                         ) ); 
    334         $this->skin->set_result($result); 
    335         if ( is_wp_error($result) ) { 
    336             $this->skin->error($result); 
    337             $this->skin->feedback('process_failed'); 
    338         } else { 
    339             //Install Succeeded 
    340             $this->skin->feedback('process_success'); 
    341         } 
    342         $this->skin->after(); 
    343  
    344         if ( !$is_multi ) 
    345             $this->skin->footer(); 
    346  
    347         return $result; 
    348     } 
    349  
    350     function maintenance_mode($enable = false) { 
    351         global $wp_filesystem; 
    352         $file = $wp_filesystem->abspath() . '.maintenance'; 
    353         if ( $enable ) { 
    354             $this->skin->feedback('maintenance_start'); 
    355             // Create maintenance file to signal that we are upgrading 
    356             $maintenance_string = '<?php $upgrading = ' . time() . '; ?>'; 
    357             $wp_filesystem->delete($file); 
    358             $wp_filesystem->put_contents($file, $maintenance_string, FS_CHMOD_FILE); 
    359         } else if ( !$enable && $wp_filesystem->exists($file) ) { 
    360             $this->skin->feedback('maintenance_end'); 
    361             $wp_filesystem->delete($file); 
    362         } 
    363     } 
    364  
    365 } 
    366  
    367 /** 
    368  * Plugin Upgrader class for WordPress Plugins, It is designed to upgrade/install plugins from a local zip, remote zip URL, or uploaded zip file. 
    369  * 
    370  * @TODO More Detailed docs, for methods as well. 
    371  * 
    372  * @package WordPress 
    373  * @subpackage Upgrader 
    374  * @since 2.8.0 
    375  */ 
    376 class Plugin_Upgrader extends WP_Upgrader { 
    377  
    378     var $result; 
    379     var $bulk = false; 
    380     var $show_before = ''; 
    381  
    382     function upgrade_strings() { 
    383         $this->strings['up_to_date'] = __('The plugin is at the latest version.'); 
    384         $this->strings['no_package'] = __('Update package not available.'); 
    385         $this->strings['downloading_package'] = __('Downloading update from <span class="code">%s</span>&#8230;'); 
    386         $this->strings['unpack_package'] = __('Unpacking the update&#8230;'); 
    387         $this->strings['remove_old'] = __('Removing the old version of the plugin&#8230;'); 
    388         $this->strings['remove_old_failed'] = __('Could not remove the old plugin.'); 
    389         $this->strings['process_failed'] = __('Plugin update failed.'); 
    390         $this->strings['process_success'] = __('Plugin updated successfully.'); 
    391     } 
    392  
    393     function install_strings() { 
    394         $this->strings['no_package'] = __('Install package not available.'); 
    395         $this->strings['downloading_package'] = __('Downloading install package from <span class="code">%s</span>&#8230;'); 
    396         $this->strings['unpack_package'] = __('Unpacking the package&#8230;'); 
    397         $this->strings['installing_package'] = __('Installing the plugin&#8230;'); 
    398         $this->strings['no_files'] = __('The plugin contains no files.'); 
    399         $this->strings['process_failed'] = __('Plugin install failed.'); 
    400         $this->strings['process_success'] = __('Plugin installed successfully.'); 
    401     } 
    402  
    403     function install($package) { 
    404  
    405         $this->init(); 
    406         $this->install_strings(); 
    407  
    408         add_filter('upgrader_source_selection', array(&$this, 'check_package') ); 
    409  
    410         $this->run(array( 
    411                     'package' => $package, 
    412                     'destination' => WP_PLUGIN_DIR, 
    413                     'clear_destination' => false, //Do not overwrite files. 
    414                     'clear_working' => true, 
    415                     'hook_extra' => array() 
    416                     )); 
    417  
    418         remove_filter('upgrader_source_selection', array(&$this, 'check_package') ); 
    419  
    420         if ( ! $this->result || is_wp_error($this->result) ) 
    421             return $this->result; 
    422  
    423         // Force refresh of plugin update information 
    424         delete_site_transient('update_plugins'); 
    425         wp_cache_delete( 'plugins', 'plugins' ); 
    426         do_action( 'upgrader_process_complete', $this, array( 'action' => 'install', 'type' => 'plugin' ), $package ); 
    427  
    428         return true; 
    429     } 
    430  
    431     function upgrade($plugin) { 
    432  
    433         $this->init(); 
    434         $this->upgrade_strings(); 
    435  
    436         $current = get_site_transient( 'update_plugins' ); 
    437         if ( !isset( $current->response[ $plugin ] ) ) { 
    438             $this->skin->before(); 
    439             $this->skin->set_result(false); 
    440             $this->skin->error('up_to_date'); 
    441             $this->skin->after(); 
    442             return false; 
    443         } 
    444  
    445         // Get the URL to the zip file 
    446         $r = $current->response[ $plugin ]; 
    447  
    448         add_filter('upgrader_pre_install', array(&$this, 'deactivate_plugin_before_upgrade'), 10, 2); 
    449         add_filter('upgrader_clear_destination', array(&$this, 'delete_old_plugin'), 10, 4); 
    450         //'source_selection' => array(&$this, 'source_selection'), //there's a trac ticket to move up the directory for zip's which are made a bit differently, useful for non-.org plugins. 
    451  
    452         $this->run(array( 
    453                     'package' => $r->package, 
    454                     'destination' => WP_PLUGIN_DIR, 
    455                     'clear_destination' => true, 
    456                     'clear_working' => true, 
    457                     'hook_extra' => array( 
    458                                 'plugin' => $plugin 
    459                     ) 
    460                 )); 
    461  
    462         // Cleanup our hooks, in case something else does a upgrade on this connection. 
    463         remove_filter('upgrader_pre_install', array(&$this, 'deactivate_plugin_before_upgrade')); 
    464         remove_filter('upgrader_clear_destination', array(&$this, 'delete_old_plugin')); 
    465  
    466         if ( ! $this->result || is_wp_error($this->result) ) 
    467             return $this->result; 
    468  
    469         // Force refresh of plugin update information 
    470         delete_site_transient('update_plugins'); 
    471         wp_cache_delete( 'plugins', 'plugins' ); 
    472         do_action( 'upgrader_process_complete', $this, array( 'action' => 'update', 'type' => 'plugin' ), $plugin ); 
    473  
    474         return true; 
    475     } 
    476  
    477     function bulk_upgrade($plugins) { 
    478  
    479         $this->init(); 
    480         $this->bulk = true; 
    481         $this->upgrade_strings(); 
    482  
    483         $current = get_site_transient( 'update_plugins' ); 
    484  
    485         add_filter('upgrader_clear_destination', array(&$this, 'delete_old_plugin'), 10, 4); 
    486  
    487         $this->skin->header(); 
    488  
    489         // Connect to the Filesystem first. 
    490         $res = $this->fs_connect( array(WP_CONTENT_DIR, WP_PLUGIN_DIR) ); 
    491         if ( ! $res ) { 
    492             $this->skin->footer(); 
    493             return false; 
    494         } 
    495  
    496         $this->skin->bulk_header(); 
    497  
    498         // Only start maintenance mode if: 
    499         // - running Multisite and there are one or more plugins specified, OR 
    500         // - a plugin with an update available is currently active. 
    501         // @TODO: For multisite, maintenance mode should only kick in for individual sites if at all possible. 
    502         $maintenance = ( is_multisite() && ! empty( $plugins ) ); 
    503         foreach ( $plugins as $plugin ) 
    504             $maintenance = $maintenance || ( is_plugin_active( $plugin ) && isset( $current->response[ $plugin] ) ); 
    505         if ( $maintenance ) 
    506             $this->maintenance_mode(true); 
    507  
    508         $results = array(); 
    509  
    510         $this->update_count = count($plugins); 
    511         $this->update_current = 0; 
    512         foreach ( $plugins as $plugin ) { 
    513             $this->update_current++; 
    514             $this->skin->plugin_info = get_plugin_data( WP_PLUGIN_DIR . '/' . $plugin, false, true); 
    515  
    516             if ( !isset( $current->response[ $plugin ] ) ) { 
    517                 $this->skin->set_result(true); 
    518                 $this->skin->before(); 
    519                 $this->skin->feedback('up_to_date'); 
    520                 $this->skin->after(); 
    521                 $results[$plugin] = true; 
    522                 continue; 
    523             } 
    524  
    525             // Get the URL to the zip file 
    526             $r = $current->response[ $plugin ]; 
    527  
    528             $this->skin->plugin_active = is_plugin_active($plugin); 
    529  
    530             $result = $this->run(array( 
    531                         'package' => $r->package, 
    532                         'destination' => WP_PLUGIN_DIR, 
    533                         'clear_destination' => true, 
    534                         'clear_working' => true, 
    535                         'is_multi' => true, 
    536                         'hook_extra' => array( 
    537                                     'plugin' => $plugin 
    538                         ) 
    539                     )); 
    540  
    541             $results[$plugin] = $this->result; 
    542  
    543             // Prevent credentials auth screen from displaying multiple times 
    544             if ( false === $result ) 
    545                 break; 
    546         } //end foreach $plugins 
    547  
    548         $this->maintenance_mode(false); 
    549  
    550         $this->skin->bulk_footer(); 
    551  
    552         $this->skin->footer(); 
    553  
    554         // Cleanup our hooks, in case something else does a upgrade on this connection. 
    555         remove_filter('upgrader_clear_destination', array(&$this, 'delete_old_plugin')); 
    556  
    557         // Force refresh of plugin update information 
    558         delete_site_transient('update_plugins'); 
    559         wp_cache_delete( 'plugins', 'plugins' ); 
    560         do_action( 'upgrader_process_complete', $this, array( 'action' => 'update', 'type' => 'plugin', 'bulk' => true ), $plugins ); 
    561  
    562         return $results; 
    563     } 
    564  
    565     function check_package($source) { 
    566         global $wp_filesystem; 
    567  
    568         if ( is_wp_error($source) ) 
    569             return $source; 
    570  
    571         $working_directory = str_replace( $wp_filesystem->wp_content_dir(), trailingslashit(WP_CONTENT_DIR), $source); 
    572         if ( ! is_dir($working_directory) ) // Sanity check, if the above fails, lets not prevent installation. 
    573             return $source; 
    574  
    575         // Check the folder contains at least 1 valid plugin. 
    576         $plugins_found = false; 
    577         foreach ( glob( $working_directory . '*.php' ) as $file ) { 
    578             $info = get_plugin_data($file, false, false); 
    579             if ( !empty( $info['Name'] ) ) { 
    580                 $plugins_found = true; 
    581                 break; 
    582             } 
    583         } 
    584  
    585         if ( ! $plugins_found ) 
    586             return new WP_Error( 'incompatible_archive', $this->strings['incompatible_archive'], __('No valid plugins were found.') ); 
    587  
    588         return $source; 
    589     } 
    590  
    591     //return plugin info. 
    592     function plugin_info() { 
    593         if ( ! is_array($this->result) ) 
    594             return false; 
    595         if ( empty($this->result['destination_name']) ) 
    596             return false; 
    597  
    598         $plugin = get_plugins('/' . $this->result['destination_name']); //Ensure to pass with leading slash 
    599         if ( empty($plugin) ) 
    600             return false; 
    601  
    602         $pluginfiles = array_keys($plugin); //Assume the requested plugin is the first in the list 
    603  
    604         return $this->result['destination_name'] . '/' . $pluginfiles[0]; 
    605     } 
    606  
    607     //Hooked to pre_install 
    608     function deactivate_plugin_before_upgrade($return, $plugin) { 
    609  
    610         if ( is_wp_error($return) ) //Bypass. 
    611             return $return; 
    612  
    613         $plugin = isset($plugin['plugin']) ? $plugin['plugin'] : ''; 
    614         if ( empty($plugin) ) 
    615             return new WP_Error('bad_request', $this->strings['bad_request']); 
    616  
    617         if ( is_plugin_active($plugin) ) { 
    618             //Deactivate the plugin silently, Prevent deactivation hooks from running. 
    619             deactivate_plugins($plugin, true); 
    620         } 
    621     } 
    622  
    623     //Hooked to upgrade_clear_destination 
    624     function delete_old_plugin($removed, $local_destination, $remote_destination, $plugin) { 
    625         global $wp_filesystem; 
    626  
    627         if ( is_wp_error($removed) ) 
    628             return $removed; //Pass errors through. 
    629  
    630         $plugin = isset($plugin['plugin']) ? $plugin['plugin'] : ''; 
    631         if ( empty($plugin) ) 
    632             return new WP_Error('bad_request', $this->strings['bad_request']); 
    633  
    634         $plugins_dir = $wp_filesystem->wp_plugins_dir(); 
    635         $this_plugin_dir = trailingslashit( dirname($plugins_dir . $plugin) ); 
    636  
    637         if ( ! $wp_filesystem->exists($this_plugin_dir) ) //If it's already vanished. 
    638             return $removed; 
    639  
    640         // If plugin is in its own directory, recursively delete the directory. 
    641         if ( strpos($plugin, '/') && $this_plugin_dir != $plugins_dir ) //base check on if plugin includes directory separator AND that it's not the root plugin folder 
    642             $deleted = $wp_filesystem->delete($this_plugin_dir, true); 
    643         else 
    644             $deleted = $wp_filesystem->delete($plugins_dir . $plugin); 
    645  
    646         if ( ! $deleted ) 
    647             return new WP_Error('remove_old_failed', $this->strings['remove_old_failed']); 
    648  
    649         return true; 
    650     } 
    651 } 
    652  
    653 /** 
    654  * Theme Upgrader class for WordPress Themes, It is designed to upgrade/install themes from a local zip, remote zip URL, or uploaded zip file. 
    655  * 
    656  * @TODO More Detailed docs, for methods as well. 
    657  * 
    658  * @package WordPress 
    659  * @subpackage Upgrader 
    660  * @since 2.8.0 
    661  */ 
    662 class Theme_Upgrader extends WP_Upgrader { 
    663  
    664     var $result; 
    665     var $bulk = false; 
    666  
    667     function upgrade_strings() { 
    668         $this->strings['up_to_date'] = __('The theme is at the latest version.'); 
    669         $this->strings['no_package'] = __('Update package not available.'); 
    670         $this->strings['downloading_package'] = __('Downloading update from <span class="code">%s</span>&#8230;'); 
    671         $this->strings['unpack_package'] = __('Unpacking the update&#8230;'); 
    672         $this->strings['remove_old'] = __('Removing the old version of the theme&#8230;'); 
    673         $this->strings['remove_old_failed'] = __('Could not remove the old theme.'); 
    674         $this->strings['process_failed'] = __('Theme update failed.'); 
    675         $this->strings['process_success'] = __('Theme updated successfully.'); 
    676     } 
    677  
    678     function install_strings() { 
    679         $this->strings['no_package'] = __('Install package not available.'); 
    680         $this->strings['downloading_package'] = __('Downloading install package from <span class="code">%s</span>&#8230;'); 
    681         $this->strings['unpack_package'] = __('Unpacking the package&#8230;'); 
    682         $this->strings['installing_package'] = __('Installing the theme&#8230;'); 
    683         $this->strings['no_files'] = __('The theme contains no files.'); 
    684         $this->strings['process_failed'] = __('Theme install failed.'); 
    685         $this->strings['process_success'] = __('Theme installed successfully.'); 
    686         /* translators: 1: theme name, 2: version */ 
    687         $this->strings['process_success_specific'] = __('Successfully installed the theme <strong>%1$s %2$s</strong>.'); 
    688         $this->strings['parent_theme_search'] = __('This theme requires a parent theme. Checking if it is installed&#8230;'); 
    689         /* translators: 1: theme name, 2: version */ 
    690         $this->strings['parent_theme_prepare_install'] = __('Preparing to install <strong>%1$s %2$s</strong>&#8230;'); 
    691         /* translators: 1: theme name, 2: version */ 
    692         $this->strings['parent_theme_currently_installed'] = __('The parent theme, <strong>%1$s %2$s</strong>, is currently installed.'); 
    693         /* translators: 1: theme name, 2: version */ 
    694         $this->strings['parent_theme_install_success'] = __('Successfully installed the parent theme, <strong>%1$s %2$s</strong>.'); 
    695         $this->strings['parent_theme_not_found'] = __('<strong>The parent theme could not be found.</strong> You will need to install the parent theme, <strong>%s</strong>, before you can use this child theme.'); 
    696     } 
    697  
    698     function check_parent_theme_filter($install_result, $hook_extra, $child_result) { 
    699         // Check to see if we need to install a parent theme 
    700         $theme_info = $this->theme_info(); 
    701  
    702         if ( ! $theme_info->parent() ) 
    703             return $install_result; 
    704  
    705         $this->skin->feedback( 'parent_theme_search' ); 
    706  
    707         if ( ! $theme_info->parent()->errors() ) { 
    708             $this->skin->feedback( 'parent_theme_currently_installed', $theme_info->parent()->display('Name'), $theme_info->parent()->display('Version') ); 
    709             // We already have the theme, fall through. 
    710             return $install_result; 
    711         } 
    712  
    713         // We don't have the parent theme, lets install it 
    714         $api = themes_api('theme_information', array('slug' => $theme_info->get('Template'), 'fields' => array('sections' => false, 'tags' => false) ) ); //Save on a bit of bandwidth. 
    715  
    716         if ( ! $api || is_wp_error($api) ) { 
    717             $this->skin->feedback( 'parent_theme_not_found', $theme_info->get('Template') ); 
    718             // Don't show activate or preview actions after install 
    719             add_filter('install_theme_complete_actions', array(&$this, 'hide_activate_preview_actions') ); 
    720             return $install_result; 
    721         } 
    722  
    723         // Backup required data we're going to override: 
    724         $child_api = $this->skin->api; 
    725         $child_success_message = $this->strings['process_success']; 
    726  
    727         // Override them 
    728         $this->skin->api = $api; 
    729         $this->strings['process_success_specific'] = $this->strings['parent_theme_install_success'];//, $api->name, $api->version); 
    730  
    731         $this->skin->feedback('parent_theme_prepare_install', $api->name, $api->version); 
    732  
    733         add_filter('install_theme_complete_actions', '__return_false', 999); // Don't show any actions after installing the theme. 
    734  
    735         // Install the parent theme 
    736         $parent_result = $this->run( array( 
    737             'package' => $api->download_link, 
    738             'destination' => get_theme_root(), 
    739             'clear_destination' => false, //Do not overwrite files. 
    740             'clear_working' => true 
    741         ) ); 
    742  
    743         if ( is_wp_error($parent_result) ) 
    744             add_filter('install_theme_complete_actions', array(&$this, 'hide_activate_preview_actions') ); 
    745  
    746         // Start cleaning up after the parents installation 
    747         remove_filter('install_theme_complete_actions', '__return_false', 999); 
    748  
    749         // Reset child's result and data 
    750         $this->result = $child_result; 
    751         $this->skin->api = $child_api; 
    752         $this->strings['process_success'] = $child_success_message; 
    753  
    754         return $install_result; 
    755     } 
    756  
    757     function hide_activate_preview_actions($actions) { 
    758         unset($actions['activate'], $actions['preview']); 
    759         return $actions; 
    760     } 
    761  
    762     function install($package) { 
    763  
    764         $this->init(); 
    765         $this->install_strings(); 
    766  
    767         add_filter('upgrader_source_selection', array(&$this, 'check_package') ); 
    768         add_filter('upgrader_post_install', array(&$this, 'check_parent_theme_filter'), 10, 3); 
    769  
    770         $options = array( 
    771             'package' => $package, 
    772             'destination' => get_theme_root(), 
    773             'clear_destination' => false, //Do not overwrite files. 
    774             'clear_working' => true 
    775         ); 
    776  
    777         $this->run($options); 
    778  
    779         remove_filter('upgrader_source_selection', array(&$this, 'check_package') ); 
    780         remove_filter('upgrader_post_install', array(&$this, 'check_parent_theme_filter')); 
    781  
    782         if ( ! $this->result || is_wp_error($this->result) ) 
    783             return $this->result; 
    784  
    785         // Force refresh of theme update information 
    786         wp_clean_themes_cache(); 
    787         do_action( 'upgrader_process_complete', $this, array( 'action' => 'install', 'type' => 'theme' ), $package ); 
    788  
    789         return true; 
    790     } 
    791  
    792     function upgrade($theme) { 
    793  
    794         $this->init(); 
    795         $this->upgrade_strings(); 
    796  
    797         // Is an update available? 
    798         $current = get_site_transient( 'update_themes' ); 
    799         if ( !isset( $current->response[ $theme ] ) ) { 
    800             $this->skin->before(); 
    801             $this->skin->set_result(false); 
    802             $this->skin->error('up_to_date'); 
    803             $this->skin->after(); 
    804             return false; 
    805         } 
    806  
    807         $r = $current->response[ $theme ]; 
    808  
    809         add_filter('upgrader_pre_install', array(&$this, 'current_before'), 10, 2); 
    810         add_filter('upgrader_post_install', array(&$this, 'current_after'), 10, 2); 
    811         add_filter('upgrader_clear_destination', array(&$this, 'delete_old_theme'), 10, 4); 
    812  
    813         $options = array( 
    814             'package' => $r['package'], 
    815             'destination' => get_theme_root( $theme ), 
    816             'clear_destination' => true, 
    817             'clear_working' => true, 
    818             'hook_extra' => array( 
    819                 'theme' => $theme 
    820             ), 
    821         ); 
    822  
    823         $this->run($options); 
    824  
    825         remove_filter('upgrader_pre_install', array(&$this, 'current_before')); 
    826         remove_filter('upgrader_post_install', array(&$this, 'current_after')); 
    827         remove_filter('upgrader_clear_destination', array(&$this, 'delete_old_theme')); 
    828  
    829         if ( ! $this->result || is_wp_error($this->result) ) 
    830             return $this->result; 
    831  
    832         // Force refresh of theme update information 
    833         wp_clean_themes_cache(); 
    834         do_action( 'upgrader_process_complete', $this, array( 'action' => 'update', 'type' => 'theme' ), $theme ); 
    835  
    836         return true; 
    837     } 
    838  
    839     function bulk_upgrade($themes) { 
    840  
    841         $this->init(); 
    842         $this->bulk = true; 
    843         $this->upgrade_strings(); 
    844  
    845         $current = get_site_transient( 'update_themes' ); 
    846  
    847         add_filter('upgrader_pre_install', array(&$this, 'current_before'), 10, 2); 
    848         add_filter('upgrader_post_install', array(&$this, 'current_after'), 10, 2); 
    849         add_filter('upgrader_clear_destination', array(&$this, 'delete_old_theme'), 10, 4); 
    850  
    851         $this->skin->header(); 
    852  
    853         // Connect to the Filesystem first. 
    854         $res = $this->fs_connect( array(WP_CONTENT_DIR) ); 
    855         if ( ! $res ) { 
    856             $this->skin->footer(); 
    857             return false; 
    858         } 
    859  
    860         $this->skin->bulk_header(); 
    861  
    862         // Only start maintenance mode if: 
    863         // - running Multisite and there are one or more themes specified, OR 
    864         // - a theme with an update available is currently in use. 
    865         // @TODO: For multisite, maintenance mode should only kick in for individual sites if at all possible. 
    866         $maintenance = ( is_multisite() && ! empty( $themes ) ); 
    867         foreach ( $themes as $theme ) 
    868             $maintenance = $maintenance || $theme == get_stylesheet() || $theme == get_template(); 
    869         if ( $maintenance ) 
    870             $this->maintenance_mode(true); 
    871  
    872         $results = array(); 
    873  
    874         $this->update_count = count($themes); 
    875         $this->update_current = 0; 
    876         foreach ( $themes as $theme ) { 
    877             $this->update_current++; 
    878  
    879             $this->skin->theme_info = $this->theme_info($theme); 
    880  
    881             if ( !isset( $current->response[ $theme ] ) ) { 
    882                 $this->skin->set_result(true); 
    883                 $this->skin->before(); 
    884                 $this->skin->feedback('up_to_date'); 
    885                 $this->skin->after(); 
    886                 $results[$theme] = true; 
    887                 continue; 
    888             } 
    889  
    890             // Get the URL to the zip file 
    891             $r = $current->response[ $theme ]; 
    892  
    893             $options = array( 
    894                 'package' => $r['package'], 
    895                 'destination' => get_theme_root( $theme ), 
    896                 'clear_destination' => true, 
    897                 'clear_working' => true, 
    898                 'hook_extra' => array( 
    899                     'theme' => $theme 
    900                 ), 
    901             ); 
    902  
    903             $result = $this->run($options); 
    904  
    905             $results[$theme] = $this->result; 
    906  
    907             // Prevent credentials auth screen from displaying multiple times 
    908             if ( false === $result ) 
    909                 break; 
    910         } //end foreach $plugins 
    911  
    912         $this->maintenance_mode(false); 
    913  
    914         $this->skin->bulk_footer(); 
    915  
    916         $this->skin->footer(); 
    917  
    918         // Cleanup our hooks, in case something else does a upgrade on this connection. 
    919         remove_filter('upgrader_pre_install', array(&$this, 'current_before')); 
    920         remove_filter('upgrader_post_install', array(&$this, 'current_after')); 
    921         remove_filter('upgrader_clear_destination', array(&$this, 'delete_old_theme')); 
    922  
    923         // Force refresh of theme update information 
    924         wp_clean_themes_cache(); 
    925         do_action( 'upgrader_process_complete', $this, array( 'action' => 'update', 'type' => 'theme', 'bulk' => true ), $themes ); 
    926  
    927         return $results; 
    928     } 
    929  
    930     function check_package($source) { 
    931         global $wp_filesystem; 
    932  
    933         if ( is_wp_error($source) ) 
    934             return $source; 
    935  
    936         // Check the folder contains a valid theme 
    937         $working_directory = str_replace( $wp_filesystem->wp_content_dir(), trailingslashit(WP_CONTENT_DIR), $source); 
    938         if ( ! is_dir($working_directory) ) // Sanity check, if the above fails, lets not prevent installation. 
    939             return $source; 
    940  
    941         // A proper archive should have a style.css file in the single subdirectory 
    942         if ( ! file_exists( $working_directory . 'style.css' ) ) 
    943             return new WP_Error( 'incompatible_archive', $this->strings['incompatible_archive'], __('The theme is missing the <code>style.css</code> stylesheet.') ); 
    944  
    945         $info = get_file_data( $working_directory . 'style.css', array( 'Name' => 'Theme Name', 'Template' => 'Template' ) ); 
    946  
    947         if ( empty( $info['Name'] ) ) 
    948             return new WP_Error( 'incompatible_archive', $this->strings['incompatible_archive'], __("The <code>style.css</code> stylesheet doesn't contain a valid theme header.") ); 
    949  
    950         // If it's not a child theme, it must have at least an index.php to be legit. 
    951         if ( empty( $info['Template'] ) && ! file_exists( $working_directory . 'index.php' ) ) 
    952             return new WP_Error( 'incompatible_archive', $this->strings['incompatible_archive'], __('The theme is missing the <code>index.php</code> file.') ); 
    953  
    954         return $source; 
    955     } 
    956  
    957     function current_before($return, $theme) { 
    958  
    959         if ( is_wp_error($return) ) 
    960             return $return; 
    961  
    962         $theme = isset($theme['theme']) ? $theme['theme'] : ''; 
    963  
    964         if ( $theme != get_stylesheet() ) //If not current 
    965             return $return; 
    966         //Change to maintenance mode now. 
    967         if ( ! $this->bulk ) 
    968             $this->maintenance_mode(true); 
    969  
    970         return $return; 
    971     } 
    972  
    973     function current_after($return, $theme) { 
    974         if ( is_wp_error($return) ) 
    975             return $return; 
    976  
    977         $theme = isset($theme['theme']) ? $theme['theme'] : ''; 
    978  
    979         if ( $theme != get_stylesheet() ) // If not current 
    980             return $return; 
    981  
    982         // Ensure stylesheet name hasn't changed after the upgrade: 
    983         if ( $theme == get_stylesheet() && $theme != $this->result['destination_name'] ) { 
    984             wp_clean_themes_cache(); 
    985             $stylesheet = $this->result['destination_name']; 
    986             switch_theme( $stylesheet ); 
    987         } 
    988  
    989         //Time to remove maintenance mode 
    990         if ( ! $this->bulk ) 
    991             $this->maintenance_mode(false); 
    992         return $return; 
    993     } 
    994  
    995     function delete_old_theme( $removed, $local_destination, $remote_destination, $theme ) { 
    996         global $wp_filesystem; 
    997  
    998         if ( is_wp_error( $removed ) ) 
    999             return $removed; // Pass errors through. 
    1000  
    1001         if ( ! isset( $theme['theme'] ) ) 
    1002             return $removed; 
    1003  
    1004         $theme = $theme['theme']; 
    1005         $themes_dir = trailingslashit( $wp_filesystem->wp_themes_dir( $theme ) ); 
    1006         if ( $wp_filesystem->exists( $themes_dir . $theme ) ) { 
    1007             if ( ! $wp_filesystem->delete( $themes_dir . $theme, true ) ) 
    1008                 return false; 
    1009         } 
    1010  
    1011         return true; 
    1012     } 
    1013  
    1014     function theme_info($theme = null) { 
    1015  
    1016         if ( empty($theme) ) { 
    1017             if ( !empty($this->result['destination_name']) ) 
    1018                 $theme = $this->result['destination_name']; 
    1019             else 
    1020                 return false; 
    1021         } 
    1022         return wp_get_theme( $theme ); 
    1023     } 
    1024  
    1025 } 
    1026  
    1027 /** 
    1028  * Core Upgrader class for WordPress. It allows for WordPress to upgrade itself in combination with the wp-admin/includes/update-core.php file 
    1029  * 
    1030  * @TODO More Detailed docs, for methods as well. 
    1031  * 
    1032  * @package WordPress 
    1033  * @subpackage Upgrader 
    1034  * @since 2.8.0 
    1035  */ 
    1036 class Core_Upgrader extends WP_Upgrader { 
    1037  
    1038     function upgrade_strings() { 
    1039         $this->strings['up_to_date'] = __('WordPress is at the latest version.'); 
    1040         $this->strings['no_package'] = __('Update package not available.'); 
    1041         $this->strings['downloading_package'] = __('Downloading update from <span class="code">%s</span>&#8230;'); 
    1042         $this->strings['unpack_package'] = __('Unpacking the update&#8230;'); 
    1043         $this->strings['copy_failed'] = __('Could not copy files.'); 
    1044         $this->strings['copy_failed_space'] = __('Could not copy files. You may have run out of disk space.' ); 
    1045     } 
    1046  
    1047     function upgrade($current) { 
    1048         global $wp_filesystem, $wp_version; 
    1049  
    1050         $this->init(); 
    1051         $this->upgrade_strings(); 
    1052  
    1053         // Is an update available? 
    1054         if ( !isset( $current->response ) || $current->response == 'latest' ) 
    1055             return new WP_Error('up_to_date', $this->strings['up_to_date']); 
    1056  
    1057         $res = $this->fs_connect( array(ABSPATH, WP_CONTENT_DIR) ); 
    1058         if ( is_wp_error($res) ) 
    1059             return $res; 
    1060  
    1061         $wp_dir = trailingslashit($wp_filesystem->abspath()); 
    1062  
    1063         // If partial update is returned from the API, use that, unless we're doing a reinstall. 
    1064         // If we cross the new_bundled version number, then use the new_bundled zip. 
    1065         // Don't though if the constant is set to skip bundled items. 
    1066         // If the API returns a no_content zip, go with it. Finally, default to the full zip. 
    1067         if ( $current->packages->partial && 'reinstall' != $current->response && $wp_version == $current->partial_version ) 
    1068             $to_download = 'partial'; 
    1069         elseif ( $current->packages->new_bundled && version_compare( $wp_version, $current->new_bundled, '<' ) 
    1070             && ( ! defined( 'CORE_UPGRADE_SKIP_NEW_BUNDLED' ) || ! CORE_UPGRADE_SKIP_NEW_BUNDLED ) ) 
    1071             $to_download = 'new_bundled'; 
    1072         elseif ( $current->packages->no_content ) 
    1073             $to_download = 'no_content'; 
    1074         else 
    1075             $to_download = 'full'; 
    1076  
    1077         $download = $this->download_package( $current->packages->$to_download ); 
    1078         if ( is_wp_error($download) ) 
    1079             return $download; 
    1080  
    1081         $working_dir = $this->unpack_package( $download ); 
    1082         if ( is_wp_error($working_dir) ) 
    1083             return $working_dir; 
    1084  
    1085         // Copy update-core.php from the new version into place. 
    1086         if ( !$wp_filesystem->copy($working_dir . '/wordpress/wp-admin/includes/update-core.php', $wp_dir . 'wp-admin/includes/update-core.php', true) ) { 
    1087             $wp_filesystem->delete($working_dir, true); 
    1088             return new WP_Error('copy_failed', $this->strings['copy_failed']); 
    1089         } 
    1090         $wp_filesystem->chmod($wp_dir . 'wp-admin/includes/update-core.php', FS_CHMOD_FILE); 
    1091  
    1092         require(ABSPATH . 'wp-admin/includes/update-core.php'); 
    1093  
    1094         if ( ! function_exists( 'update_core' ) ) 
    1095             return new WP_Error( 'copy_failed_space', $this->strings['copy_failed_space'] ); 
    1096  
    1097         $result = update_core( $working_dir, $wp_dir ); 
    1098         do_action( 'upgrader_process_complete', $this, array( 'action' => 'update', 'type' => 'core' ), $result ); 
    1099         return $result; 
    1100     } 
    1101  
    1102 } 
    1103  
    1104 /** 
    110511 * Generic Skin for the WordPress Upgrader classes. This skin is designed to be extended for specific purposes. 
    1106  * 
    1107  * @TODO More Detailed docs, for methods as well. 
    110812 * 
    110913 * @package WordPress 
     
    119599 * Plugin Upgrader Skin for WordPress Plugin Upgrades. 
    1196100 * 
    1197  * @TODO More Detailed docs, for methods as well. 
    1198  * 
    1199101 * @package WordPress 
    1200102 * @subpackage Upgrader 
     
    1433335 * Plugin Installer Skin for WordPress Plugin Installer. 
    1434336 * 
    1435  * @TODO More Detailed docs, for methods as well. 
    1436  * 
    1437337 * @package WordPress 
    1438338 * @subpackage Upgrader 
     
    1498398 * Theme Installer Skin for the WordPress Theme Installer. 
    1499399 * 
    1500  * @TODO More Detailed docs, for methods as well. 
    1501  * 
    1502400 * @package WordPress 
    1503401 * @subpackage Upgrader 
     
    1572470/** 
    1573471 * Theme Upgrader Skin for WordPress Theme Upgrades. 
    1574  * 
    1575  * @TODO More Detailed docs, for methods as well. 
    1576472 * 
    1577473 * @package WordPress 
     
    1632528    } 
    1633529} 
    1634  
    1635 /** 
    1636  * Upgrade Skin helper for File uploads. This class handles the upload process and passes it as if it's a local file to the Upgrade/Installer functions. 
    1637  * 
    1638  * @TODO More Detailed docs, for methods as well. 
    1639  * 
    1640  * @package WordPress 
    1641  * @subpackage Upgrader 
    1642  * @since 2.8.0 
    1643  */ 
    1644 class File_Upload_Upgrader { 
    1645     var $package; 
    1646     var $filename; 
    1647     var $id = 0; 
    1648  
    1649     function __construct($form, $urlholder) { 
    1650  
    1651         if ( empty($_FILES[$form]['name']) && empty($_GET[$urlholder]) ) 
    1652             wp_die(__('Please select a file')); 
    1653  
    1654         //Handle a newly uploaded file, Else assume it's already been uploaded 
    1655         if ( ! empty($_FILES) ) { 
    1656             $overrides = array( 'test_form' => false, 'test_type' => false ); 
    1657             $file = wp_handle_upload( $_FILES[$form], $overrides ); 
    1658  
    1659             if ( isset( $file['error'] ) ) 
    1660                 wp_die( $file['error'] ); 
    1661  
    1662             $this->filename = $_FILES[$form]['name']; 
    1663             $this->package = $file['file']; 
    1664  
    1665             // Construct the object array 
    1666             $object = array( 
    1667                 'post_title' => $this->filename, 
    1668                 'post_content' => $file['url'], 
    1669                 'post_mime_type' => $file['type'], 
    1670                 'guid' => $file['url'], 
    1671                 'context' => 'upgrader', 
    1672                 'post_status' => 'private' 
    1673             ); 
    1674  
    1675             // Save the data 
    1676             $this->id = wp_insert_attachment( $object, $file['file'] ); 
    1677  
    1678             // schedule a cleanup for 2 hours from now in case of failed install 
    1679             wp_schedule_single_event( time() + 7200, 'upgrader_scheduled_cleanup', array( $this->id ) ); 
    1680  
    1681         } elseif ( is_numeric( $_GET[$urlholder] ) ) { 
    1682             // Numeric Package = previously uploaded file, see above. 
    1683             $this->id = (int) $_GET[$urlholder]; 
    1684             $attachment = get_post( $this->id ); 
    1685             if ( empty($attachment) ) 
    1686                 wp_die(__('Please select a file')); 
    1687  
    1688             $this->filename = $attachment->post_title; 
    1689             $this->package = get_attached_file( $attachment->ID ); 
    1690         } else { 
    1691             // Else, It's set to something, Back compat for plugins using the old (pre-3.3) File_Uploader handler. 
    1692             if ( ! ( ( $uploads = wp_upload_dir() ) && false === $uploads['error'] ) ) 
    1693                 wp_die( $uploads['error'] ); 
    1694  
    1695             $this->filename = $_GET[$urlholder]; 
    1696             $this->package = $uploads['basedir'] . '/' . $this->filename; 
    1697         } 
    1698     } 
    1699  
    1700     function cleanup() { 
    1701         if ( $this->id ) 
    1702             wp_delete_attachment( $this->id ); 
    1703  
    1704         elseif ( file_exists( $this->package ) ) 
    1705             return @unlink( $this->package ); 
    1706  
    1707         return true; 
    1708     } 
    1709 } 
  • trunk/src/wp-admin/includes/class-wp-upgrader.php

    r25181 r25227  
    1212 */ 
    1313 
     14require ABSPATH . 'wp-admin/includes/class-wp-upgrader-skins.php'; 
     15 
    1416/** 
    1517 * WordPress Upgrader class for Upgrading/Installing a local set of files via the Filesystem Abstraction classes from a Zip file. 
    16  * 
    17  * @TODO More Detailed docs, for methods as well. 
    1818 * 
    1919 * @package WordPress 
     
    368368 * Plugin Upgrader class for WordPress Plugins, It is designed to upgrade/install plugins from a local zip, remote zip URL, or uploaded zip file. 
    369369 * 
    370  * @TODO More Detailed docs, for methods as well. 
    371  * 
    372370 * @package WordPress 
    373371 * @subpackage Upgrader 
     
    653651/** 
    654652 * Theme Upgrader class for WordPress Themes, It is designed to upgrade/install themes from a local zip, remote zip URL, or uploaded zip file. 
    655  * 
    656  * @TODO More Detailed docs, for methods as well. 
    657653 * 
    658654 * @package WordPress 
     
    10281024 * Core Upgrader class for WordPress. It allows for WordPress to upgrade itself in combination with the wp-admin/includes/update-core.php file 
    10291025 * 
    1030  * @TODO More Detailed docs, for methods as well. 
    1031  * 
    10321026 * @package WordPress 
    10331027 * @subpackage Upgrader 
     
    11031097 
    11041098/** 
    1105  * Generic Skin for the WordPress Upgrader classes. This skin is designed to be extended for specific purposes. 
    1106  * 
    1107  * @TODO More Detailed docs, for methods as well. 
    1108  * 
    1109  * @package WordPress 
    1110  * @subpackage Upgrader 
    1111  * @since 2.8.0 
    1112  */ 
    1113 class WP_Upgrader_Skin { 
    1114  
    1115     var $upgrader; 
    1116     var $done_header = false; 
    1117     var $result = false; 
    1118  
    1119     function __construct($args = array()) { 
    1120         $defaults = array( 'url' => '', 'nonce' => '', 'title' => '', 'context' => false ); 
    1121         $this->options = wp_parse_args($args, $defaults); 
    1122     } 
    1123  
    1124     function set_upgrader(&$upgrader) { 
    1125         if ( is_object($upgrader) ) 
    1126             $this->upgrader =& $upgrader; 
    1127         $this->add_strings(); 
    1128     } 
    1129  
    1130     function add_strings() { 
    1131     } 
    1132  
    1133     function set_result($result) { 
    1134         $this->result = $result; 
    1135     } 
    1136  
    1137     function request_filesystem_credentials($error = false) { 
    1138         $url = $this->options['url']; 
    1139         $context = $this->options['context']; 
    1140         if ( !empty($this->options['nonce']) ) 
    1141             $url = wp_nonce_url($url, $this->options['nonce']); 
    1142         return request_filesystem_credentials($url, '', $error, $context); //Possible to bring inline, Leaving as is for now. 
    1143     } 
    1144  
    1145     function header() { 
    1146         if ( $this->done_header ) 
    1147             return; 
    1148         $this->done_header = true; 
    1149         echo '<div class="wrap">'; 
    1150         screen_icon(); 
    1151         echo '<h2>' . $this->options['title'] . '</h2>'; 
    1152     } 
    1153     function footer() { 
    1154         echo '</div>'; 
    1155     } 
    1156  
    1157     function error($errors) { 
    1158         if ( ! $this->done_header ) 
    1159             $this->header(); 
    1160         if ( is_string($errors) ) { 
    1161             $this->feedback($errors); 
    1162         } elseif ( is_wp_error($errors) && $errors->get_error_code() ) { 
    1163             foreach ( $errors->get_error_messages() as $message ) { 
    1164                 if ( $errors->get_error_data() ) 
    1165                     $this->feedback($message . ' ' . esc_html( $errors->get_error_data() ) ); 
    1166                 else 
    1167                     $this->feedback($message); 
    1168             } 
    1169         } 
    1170     } 
    1171  
    1172     function feedback($string) { 
    1173         if ( isset( $this->upgrader->strings[$string] ) ) 
    1174             $string = $this->upgrader->strings[$string]; 
    1175  
    1176         if ( strpos($string, '%') !== false ) { 
    1177             $args = func_get_args(); 
    1178             $args = array_splice($args, 1); 
    1179             if ( $args ) { 
    1180                 $args = array_map( 'strip_tags', $args ); 
    1181                 $args = array_map( 'esc_html', $args ); 
    1182                 $string = vsprintf($string, $args); 
    1183             } 
    1184         } 
    1185         if ( empty($string) ) 
    1186             return; 
    1187         show_message($string); 
    1188     } 
    1189     function before() {} 
    1190     function after() {} 
    1191  
    1192 } 
    1193  
    1194 /** 
    1195  * Plugin Upgrader Skin for WordPress Plugin Upgrades. 
    1196  * 
    1197  * @TODO More Detailed docs, for methods as well. 
    1198  * 
    1199  * @package WordPress 
    1200  * @subpackage Upgrader 
    1201  * @since 2.8.0 
    1202  */ 
    1203 class Plugin_Upgrader_Skin extends WP_Upgrader_Skin { 
    1204     var $plugin = ''; 
    1205     var $plugin_active = false; 
    1206     var $plugin_network_active = false; 
    1207  
    1208     function __construct($args = array()) { 
    1209         $defaults = array( 'url' => '', 'plugin' => '', 'nonce' => '', 'title' => __('Update Plugin') ); 
    1210         $args = wp_parse_args($args, $defaults); 
    1211  
    1212         $this->plugin = $args['plugin']; 
    1213  
    1214         $this->plugin_active = is_plugin_active( $this->plugin ); 
    1215         $this->plugin_network_active = is_plugin_active_for_network( $this->plugin ); 
    1216  
    1217         parent::__construct($args); 
    1218     } 
    1219  
    1220     function after() { 
    1221         $this->plugin = $this->upgrader->plugin_info(); 
    1222         if ( !empty($this->plugin) && !is_wp_error($this->result) && $this->plugin_active ){ 
    1223             echo '<iframe style="border:0;overflow:hidden" width="100%" height="170px" src="' . wp_nonce_url('update.php?action=activate-plugin&networkwide=' . $this->plugin_network_active . '&plugin=' . urlencode( $this->plugin ), 'activate-plugin_' . $this->plugin) .'"></iframe>'; 
    1224         } 
    1225  
    1226         $update_actions =  array( 
    1227             'activate_plugin' => '<a href="' . wp_nonce_url('plugins.php?action=activate&amp;plugin=' . urlencode( $this->plugin ), 'activate-plugin_' . $this->plugin) . '" title="' . esc_attr__('Activate this plugin') . '" target="_parent">' . __('Activate Plugin') . '</a>', 
    1228             'plugins_page' => '<a href="' . self_admin_url('plugins.php') . '" title="' . esc_attr__('Go to plugins page') . '" target="_parent">' . __('Return to Plugins page') . '</a>' 
    1229         ); 
    1230         if ( $this->plugin_active || ! $this->result || is_wp_error( $this->result ) || ! current_user_can( 'activate_plugins' ) ) 
    1231             unset( $update_actions['activate_plugin'] ); 
    1232  
    1233         $update_actions = apply_filters('update_plugin_complete_actions', $update_actions, $this->plugin); 
    1234         if ( ! empty($update_actions) ) 
    1235             $this->feedback(implode(' | ', (array)$update_actions)); 
    1236     } 
    1237  
    1238     function before() { 
    1239         if ( $this->upgrader->show_before ) { 
    1240             echo $this->upgrader->show_before; 
    1241             $this->upgrader->show_before = ''; 
    1242         } 
    1243     } 
    1244 } 
    1245  
    1246 /** 
    1247  * Plugin Upgrader Skin for WordPress Plugin Upgrades. 
    1248  * 
    1249  * @package WordPress 
    1250  * @subpackage Upgrader 
    1251  * @since 3.0.0 
    1252  */ 
    1253 class Bulk_Upgrader_Skin extends WP_Upgrader_Skin { 
    1254     var $in_loop = false; 
    1255     var $error = false; 
    1256  
    1257     function __construct($args = array()) { 
    1258         $defaults = array( 'url' => '', 'nonce' => '' ); 
    1259         $args = wp_parse_args($args, $defaults); 
    1260  
    1261         parent::__construct($args); 
    1262     } 
    1263  
    1264     function add_strings() { 
    1265         $this->upgrader->strings['skin_upgrade_start'] = __('The update process is starting. This process may take a while on some hosts, so please be patient.'); 
    1266         $this->upgrader->strings['skin_update_failed_error'] = __('An error occurred while updating %1$s: <strong>%2$s</strong>'); 
    1267         $this->upgrader->strings['skin_update_failed'] = __('The update of %1$s failed.'); 
    1268         $this->upgrader->strings['skin_update_successful'] = __('%1$s updated successfully.').' <a onclick="%2$s" href="#" class="hide-if-no-js"><span>'.__('Show Details').'</span><span class="hidden">'.__('Hide Details').'</span>.</a>'; 
    1269         $this->upgrader->strings['skin_upgrade_end'] = __('All updates have been completed.'); 
    1270     } 
    1271  
    1272     function feedback($string) { 
    1273         if ( isset( $this->upgrader->strings[$string] ) ) 
    1274             $string = $this->upgrader->strings[$string]; 
    1275  
    1276         if ( strpos($string, '%') !== false ) { 
    1277             $args = func_get_args(); 
    1278             $args = array_splice($args, 1); 
    1279             if ( $args ) { 
    1280                 $args = array_map( 'strip_tags', $args ); 
    1281                 $args = array_map( 'esc_html', $args ); 
    1282                 $string = vsprintf($string, $args); 
    1283             } 
    1284         } 
    1285         if ( empty($string) ) 
    1286             return; 
    1287         if ( $this->in_loop ) 
    1288             echo "$string<br />\n"; 
    1289         else 
    1290             echo "<p>$string</p>\n"; 
    1291     } 
    1292  
    1293     function header() { 
    1294         // Nothing, This will be displayed within a iframe. 
    1295     } 
    1296  
    1297     function footer() { 
    1298         // Nothing, This will be displayed within a iframe. 
    1299     } 
    1300     function error($error) { 
    1301         if ( is_string($error) && isset( $this->upgrader->strings[$error] ) ) 
    1302             $this->error = $this->upgrader->strings[$error]; 
    1303  
    1304         if ( is_wp_error($error) ) { 
    1305             foreach ( $error->get_error_messages() as $emessage ) { 
    1306                 if ( $error->get_error_data() ) 
    1307                     $messages[] = $emessage . ' ' . esc_html( $error->get_error_data() ); 
    1308                 else 
    1309                     $messages[] = $emessage; 
    1310             } 
    1311             $this->error = implode(', ', $messages); 
    1312         } 
    1313         echo '<script type="text/javascript">jQuery(\'.waiting-' . esc_js($this->upgrader->update_current) . '\').hide();</script>'; 
    1314     } 
    1315  
    1316     function bulk_header() { 
    1317         $this->feedback('skin_upgrade_start'); 
    1318     } 
    1319  
    1320     function bulk_footer() { 
    1321         $this->feedback('skin_upgrade_end'); 
    1322     } 
    1323  
    1324     function before($title = '') { 
    1325         $this->in_loop = true; 
    1326         printf( '<h4>' . $this->upgrader->strings['skin_before_update_header'] . ' <span class="spinner waiting-' . $this->upgrader->update_current . '"></span></h4>',  $title, $this->upgrader->update_current, $this->upgrader->update_count); 
    1327         echo '<script type="text/javascript">jQuery(\'.waiting-' . esc_js($this->upgrader->update_current) . '\').css("display", "inline-block");</script>'; 
    1328         echo '<div class="update-messages hide-if-js" id="progress-' . esc_attr($this->upgrader->update_current) . '"><p>'; 
    1329         $this->flush_output(); 
    1330     } 
    1331  
    1332     function after($title = '') { 
    1333         echo '</p></div>'; 
    1334         if ( $this->error || ! $this->result ) { 
    1335             if ( $this->error ) 
    1336                 echo '<div class="error"><p>' . sprintf($this->upgrader->strings['skin_update_failed_error'], $title, $this->error) . '</p></div>'; 
    1337             else 
    1338                 echo '<div class="error"><p>' . sprintf($this->upgrader->strings['skin_update_failed'], $title) . '</p></div>'; 
    1339  
    1340             echo '<script type="text/javascript">jQuery(\'#progress-' . esc_js($this->upgrader->update_current) . '\').show();</script>'; 
    1341         } 
    1342         if ( $this->result && ! is_wp_error( $this->result ) ) { 
    1343             if ( ! $this->error ) 
    1344                 echo '<div class="updated"><p>' . sprintf($this->upgrader->strings['skin_update_successful'], $title, 'jQuery(\'#progress-' . esc_js($this->upgrader->update_current) . '\').toggle();jQuery(\'span\', this).toggle(); return false;') . '</p></div>'; 
    1345             echo '<script type="text/javascript">jQuery(\'.waiting-' . esc_js($this->upgrader->update_current) . '\').hide();</script>'; 
    1346         } 
    1347  
    1348         $this->reset(); 
    1349         $this->flush_output(); 
    1350     } 
    1351  
    1352     function reset() { 
    1353         $this->in_loop = false; 
    1354         $this->error = false; 
    1355     } 
    1356  
    1357     function flush_output() { 
    1358         wp_ob_end_flush_all(); 
    1359         flush(); 
    1360     } 
    1361 } 
    1362  
    1363 class Bulk_Plugin_Upgrader_Skin extends Bulk_Upgrader_Skin { 
    1364     var $plugin_info = array(); // Plugin_Upgrader::bulk() will fill this in. 
    1365  
    1366     function __construct($args = array()) { 
    1367         parent::__construct($args); 
    1368     } 
    1369  
    1370     function add_strings() { 
    1371         parent::add_strings(); 
    1372         $this->upgrader->strings['skin_before_update_header'] = __('Updating Plugin %1$s (%2$d/%3$d)'); 
    1373     } 
    1374  
    1375     function before($title = '') { 
    1376         parent::before($this->plugin_info['Title']); 
    1377     } 
    1378  
    1379     function after($title = '') { 
    1380         parent::after($this->plugin_info['Title']); 
    1381     } 
    1382     function bulk_footer() { 
    1383         parent::bulk_footer(); 
    1384         $update_actions =  array( 
    1385             'plugins_page' => '<a href="' . self_admin_url('plugins.php') . '" title="' . esc_attr__('Go to plugins page') . '" target="_parent">' . __('Return to Plugins page') . '</a>', 
    1386             'updates_page' => '<a href="' . self_admin_url('update-core.php') . '" title="' . esc_attr__('Go to WordPress Updates page') . '" target="_parent">' . __('Return to WordPress Updates') . '</a>' 
    1387         ); 
    1388         if ( ! current_user_can( 'activate_plugins' ) ) 
    1389             unset( $update_actions['plugins_page'] ); 
    1390  
    1391         $update_actions = apply_filters('update_bulk_plugins_complete_actions', $update_actions, $this->plugin_info); 
    1392         if ( ! empty($update_actions) ) 
    1393             $this->feedback(implode(' | ', (array)$update_actions)); 
    1394     } 
    1395 } 
    1396  
    1397 class Bulk_Theme_Upgrader_Skin extends Bulk_Upgrader_Skin { 
    1398     var $theme_info = array(); // Theme_Upgrader::bulk() will fill this in. 
    1399  
    1400     function __construct($args = array()) { 
    1401         parent::__construct($args); 
    1402     } 
    1403  
    1404     function add_strings() { 
    1405         parent::add_strings(); 
    1406         $this->upgrader->strings['skin_before_update_header'] = __('Updating Theme %1$s (%2$d/%3$d)'); 
    1407     } 
    1408  
    1409     function before($title = '') { 
    1410         parent::before( $this->theme_info->display('Name') ); 
    1411     } 
    1412  
    1413     function after($title = '') { 
    1414         parent::after( $this->theme_info->display('Name') ); 
    1415     } 
    1416  
    1417     function bulk_footer() { 
    1418         parent::bulk_footer(); 
    1419         $update_actions =  array( 
    1420             'themes_page' => '<a href="' . self_admin_url('themes.php') . '" title="' . esc_attr__('Go to themes page') . '" target="_parent">' . __('Return to Themes page') . '</a>', 
    1421             'updates_page' => '<a href="' . self_admin_url('update-core.php') . '" title="' . esc_attr__('Go to WordPress Updates page') . '" target="_parent">' . __('Return to WordPress Updates') . '</a>' 
    1422         ); 
    1423         if ( ! current_user_can( 'switch_themes' ) && ! current_user_can( 'edit_theme_options' ) ) 
    1424             unset( $update_actions['themes_page'] ); 
    1425  
    1426         $update_actions = apply_filters('update_bulk_theme_complete_actions', $update_actions, $this->theme_info ); 
    1427         if ( ! empty($update_actions) ) 
    1428             $this->feedback(implode(' | ', (array)$update_actions)); 
    1429     } 
    1430 } 
    1431  
    1432 /** 
    1433  * Plugin Installer Skin for WordPress Plugin Installer. 
    1434  * 
    1435  * @TODO More Detailed docs, for methods as well. 
    1436  * 
    1437  * @package WordPress 
    1438  * @subpackage Upgrader 
    1439  * @since 2.8.0 
    1440  */ 
    1441 class Plugin_Installer_Skin extends WP_Upgrader_Skin { 
    1442     var $api; 
    1443     var $type; 
    1444  
    1445     function __construct($args = array()) { 
    1446         $defaults = array( 'type' => 'web', 'url' => '', 'plugin' => '', 'nonce' => '', 'title' => '' ); 
    1447         $args = wp_parse_args($args, $defaults); 
    1448  
    1449         $this->type = $args['type']; 
    1450         $this->api = isset($args['api']) ? $args['api'] : array(); 
    1451  
    1452         parent::__construct($args); 
    1453     } 
    1454  
    1455     function before() { 
    1456         if ( !empty($this->api) ) 
    1457             $this->upgrader->strings['process_success'] = sprintf( __('Successfully installed the plugin <strong>%s %s</strong>.'), $this->api->name, $this->api->version); 
    1458     } 
    1459  
    1460     function after() { 
    1461  
    1462         $plugin_file = $this->upgrader->plugin_info(); 
    1463  
    1464         $install_actions = array(); 
    1465  
    1466         $from = isset($_GET['from']) ? wp_unslash( $_GET['from'] ) : 'plugins'; 
    1467  
    1468         if ( 'import' == $from ) 
    1469             $install_actions['activate_plugin'] = '<a href="' . wp_nonce_url('plugins.php?action=activate&amp;from=import&amp;plugin=' . urlencode( $plugin_file ), 'activate-plugin_' . $plugin_file) . '" title="' . esc_attr__('Activate this plugin') . '" target="_parent">' . __('Activate Plugin &amp; Run Importer') . '</a>'; 
    1470         else 
    1471             $install_actions['activate_plugin'] = '<a href="' . wp_nonce_url('plugins.php?action=activate&amp;plugin=' . urlencode( $plugin_file ), 'activate-plugin_' . $plugin_file) . '" title="' . esc_attr__('Activate this plugin') . '" target="_parent">' . __('Activate Plugin') . '</a>'; 
    1472  
    1473         if ( is_multisite() && current_user_can( 'manage_network_plugins' ) ) { 
    1474             $install_actions['network_activate'] = '<a href="' . wp_nonce_url('plugins.php?action=activate&amp;networkwide=1&amp;plugin=' . urlencode( $plugin_file ), 'activate-plugin_' . $plugin_file) . '" title="' . esc_attr__('Activate this plugin for all sites in this network') . '" target="_parent">' . __('Network Activate') . '</a>'; 
    1475             unset( $install_actions['activate_plugin'] ); 
    1476         } 
    1477  
    1478         if ( 'import' == $from ) 
    1479             $install_actions['importers_page'] = '<a href="' . admin_url('import.php') . '" title="' . esc_attr__('Return to Importers') . '" target="_parent">' . __('Return to Importers') . '</a>'; 
    1480         else if ( $this->type == 'web' ) 
    1481             $install_actions['plugins_page'] = '<a href="' . self_admin_url('plugin-install.php') . '" title="' . esc_attr__('Return to Plugin Installer') . '" target="_parent">' . __('Return to Plugin Installer') . '</a>'; 
    1482         else 
    1483             $install_actions['plugins_page'] = '<a href="' . self_admin_url('plugins.php') . '" title="' . esc_attr__('Return to Plugins page') . '" target="_parent">' . __('Return to Plugins page') . '</a>'; 
    1484  
    1485         if ( ! $this->result || is_wp_error($this->result) ) { 
    1486             unset( $install_actions['activate_plugin'], $install_actions['network_activate'] ); 
    1487         } elseif ( ! current_user_can( 'activate_plugins' ) ) { 
    1488             unset( $install_actions['activate_plugin'] ); 
    1489         } 
    1490  
    1491         $install_actions = apply_filters('install_plugin_complete_actions', $install_actions, $this->api, $plugin_file); 
    1492         if ( ! empty($install_actions) ) 
    1493             $this->feedback(implode(' | ', (array)$install_actions)); 
    1494     } 
    1495 } 
    1496  
    1497 /** 
    1498  * Theme Installer Skin for the WordPress Theme Installer. 
    1499  * 
    1500  * @TODO More Detailed docs, for methods as well. 
    1501  * 
    1502  * @package WordPress 
    1503  * @subpackage Upgrader 
    1504  * @since 2.8.0 
    1505  */ 
    1506 class Theme_Installer_Skin extends WP_Upgrader_Skin { 
    1507     var $api; 
    1508     var $type; 
    1509  
    1510     function __construct($args = array()) { 
    1511         $defaults = array( 'type' => 'web', 'url' => '', 'theme' => '', 'nonce' => '', 'title' => '' ); 
    1512         $args = wp_parse_args($args, $defaults); 
    1513  
    1514         $this->type = $args['type']; 
    1515         $this->api = isset($args['api']) ? $args['api'] : array(); 
    1516  
    1517         parent::__construct($args); 
    1518     } 
    1519  
    1520     function before() { 
    1521         if ( !empty($this->api) ) 
    1522             $this->upgrader->strings['process_success'] = sprintf( $this->upgrader->strings['process_success_specific'], $this->api->name, $this->api->version); 
    1523     } 
    1524  
    1525     function after() { 
    1526         if ( empty($this->upgrader->result['destination_name']) ) 
    1527             return; 
    1528  
    1529         $theme_info = $this->upgrader->theme_info(); 
    1530         if ( empty( $theme_info ) ) 
    1531             return; 
    1532  
    1533         $name       = $theme_info->display('Name'); 
    1534         $stylesheet = $this->upgrader->result['destination_name']; 
    1535         $template   = $theme_info->get_template(); 
    1536  
    1537         $preview_link = add_query_arg( array( 
    1538             'preview'    => 1, 
    1539             'template'   => urlencode( $template ), 
    1540             'stylesheet' => urlencode( $stylesheet ), 
    1541         ), trailingslashit( home_url() ) ); 
    1542  
    1543         $activate_link = add_query_arg( array( 
    1544             'action'     => 'activate', 
    1545             'template'   => urlencode( $template ), 
    1546             'stylesheet' => urlencode( $stylesheet ), 
    1547         ), admin_url('themes.php') ); 
    1548         $activate_link = wp_nonce_url( $activate_link, 'switch-theme_' . $stylesheet ); 
    1549  
    1550         $install_actions = array(); 
    1551         $install_actions['preview']  = '<a href="' . esc_url( $preview_link ) . '" class="hide-if-customize" title="' . esc_attr( sprintf( __('Preview &#8220;%s&#8221;'), $name ) ) . '">' . __('Preview') . '</a>'; 
    1552         $install_actions['preview'] .= '<a href="' . wp_customize_url( $stylesheet ) . '" class="hide-if-no-customize load-customize" title="' . esc_attr( sprintf( __('Preview &#8220;%s&#8221;'), $name ) ) . '">' . __('Live Preview') . '</a>'; 
    1553         $install_actions['activate'] = '<a href="' . esc_url( $activate_link ) . '" class="activatelink" title="' . esc_attr( sprintf( __('Activate &#8220;%s&#8221;'), $name ) ) . '">' . __('Activate') . '</a>'; 
    1554  
    1555         if ( is_network_admin() && current_user_can( 'manage_network_themes' ) ) 
    1556             $install_actions['network_enable'] = '<a href="' . esc_url( wp_nonce_url( 'themes.php?action=enable&amp;theme=' . urlencode( $stylesheet ), 'enable-theme_' . $stylesheet ) ) . '" title="' . esc_attr__( 'Enable this theme for all sites in this network' ) . '" target="_parent">' . __( 'Network Enable' ) . '</a>'; 
    1557  
    1558         if ( $this->type == 'web' ) 
    1559             $install_actions['themes_page'] = '<a href="' . self_admin_url('theme-install.php') . '" title="' . esc_attr__('Return to Theme Installer') . '" target="_parent">' . __('Return to Theme Installer') . '</a>'; 
    1560         elseif ( current_user_can( 'switch_themes' ) || current_user_can( 'edit_theme_options' ) ) 
    1561             $install_actions['themes_page'] = '<a href="' . self_admin_url('themes.php') . '" title="' . esc_attr__('Themes page') . '" target="_parent">' . __('Return to Themes page') . '</a>'; 
    1562  
    1563         if ( ! $this->result || is_wp_error($this->result) || is_network_admin() || ! current_user_can( 'switch_themes' ) ) 
    1564             unset( $install_actions['activate'], $install_actions['preview'] ); 
    1565  
    1566         $install_actions = apply_filters('install_theme_complete_actions', $install_actions, $this->api, $stylesheet, $theme_info); 
    1567         if ( ! empty($install_actions) ) 
    1568             $this->feedback(implode(' | ', (array)$install_actions)); 
    1569     } 
    1570 } 
    1571  
    1572 /** 
    1573  * Theme Upgrader Skin for WordPress Theme Upgrades. 
    1574  * 
    1575  * @TODO More Detailed docs, for methods as well. 
    1576  * 
    1577  * @package WordPress 
    1578  * @subpackage Upgrader 
    1579  * @since 2.8.0 
    1580  */ 
    1581 class Theme_Upgrader_Skin extends WP_Upgrader_Skin { 
    1582     var $theme = ''; 
    1583  
    1584     function __construct($args = array()) { 
    1585         $defaults = array( 'url' => '', 'theme' => '', 'nonce' => '', 'title' => __('Update Theme') ); 
    1586         $args = wp_parse_args($args, $defaults); 
    1587  
    1588         $this->theme = $args['theme']; 
    1589  
    1590         parent::__construct($args); 
    1591     } 
    1592  
    1593     function after() { 
    1594  
    1595         $update_actions = array(); 
    1596         if ( ! empty( $this->upgrader->result['destination_name'] ) && $theme_info = $this->upgrader->theme_info() ) { 
    1597             $name       = $theme_info->display('Name'); 
    1598             $stylesheet = $this->upgrader->result['destination_name']; 
    1599             $template   = $theme_info->get_template(); 
    1600  
    1601             $preview_link = add_query_arg( array( 
    1602                 'preview'    => 1, 
    1603                 'template'   => urlencode( $template ), 
    1604                 'stylesheet' => urlencode( $stylesheet ), 
    1605             ), trailingslashit( home_url() ) ); 
    1606  
    1607             $activate_link = add_query_arg( array( 
    1608                 'action'     => 'activate', 
    1609                 'template'   => urlencode( $template ), 
    1610                 'stylesheet' => urlencode( $stylesheet ), 
    1611             ), admin_url('themes.php') ); 
    1612             $activate_link = wp_nonce_url( $activate_link, 'switch-theme_' . $stylesheet ); 
    1613  
    1614             if ( get_stylesheet() == $stylesheet ) { 
    1615                 if ( current_user_can( 'edit_theme_options' ) ) 
    1616                     $update_actions['preview']  = '<a href="' . wp_customize_url( $stylesheet ) . '" class="hide-if-no-customize load-customize" title="' . esc_attr( sprintf( __('Customize &#8220;%s&#8221;'), $name ) ) . '">' . __('Customize') . '</a>'; 
    1617             } elseif ( current_user_can( 'switch_themes' ) ) { 
    1618                 $update_actions['preview']  = '<a href="' . esc_url( $preview_link ) . '" class="hide-if-customize" title="' . esc_attr( sprintf( __('Preview &#8220;%s&#8221;'), $name ) ) . '">' . __('Preview') . '</a>'; 
    1619                 $update_actions['preview'] .= '<a href="' . wp_customize_url( $stylesheet ) . '" class="hide-if-no-customize load-customize" title="' . esc_attr( sprintf( __('Preview &#8220;%s&#8221;'), $name ) ) . '">' . __('Live Preview') . '</a>'; 
    1620                 $update_actions['activate'] = '<a href="' . esc_url( $activate_link ) . '" class="activatelink" title="' . esc_attr( sprintf( __('Activate &#8220;%s&#8221;'), $name ) ) . '">' . __('Activate') . '</a>'; 
    1621             } 
    1622  
    1623             if ( ! $this->result || is_wp_error( $this->result ) || is_network_admin() ) 
    1624                 unset( $update_actions['preview'], $update_actions['activate'] ); 
    1625         } 
    1626  
    1627         $update_actions['themes_page'] = '<a href="' . self_admin_url('themes.php') . '" title="' . esc_attr__('Return to Themes page') . '" target="_parent">' . __('Return to Themes page') . '</a>'; 
    1628  
    1629         $update_actions = apply_filters('update_theme_complete_actions', $update_actions, $this->theme); 
    1630         if ( ! empty($update_actions) ) 
    1631             $this->feedback(implode(' | ', (array)$update_actions)); 
    1632     } 
    1633 } 
    1634  
    1635 /** 
    16361099 * Upgrade Skin helper for File uploads. This class handles the upload process and passes it as if it's a local file to the Upgrade/Installer functions. 
    1637  * 
    1638  * @TODO More Detailed docs, for methods as well. 
    16391100 * 
    16401101 * @package WordPress 
Note: See TracChangeset for help on using the changeset viewer.