theme_name = $theme_name; $this->short_name = $short_name; $this->xml_url = $xml_url; $this->cache_interval = $cache_interval; $this->update_page_name = $update_page_name; $this->options_url = $options_url; } /** * Inits the main update functionality, adds the actions. */ public function init() { $theme_data = wp_get_theme($this->short_name); if(!$theme_data->Version){ $theme_data = wp_get_theme(); } $this->current_version = $theme_data->Version; //add the actions add_action( 'admin_menu', array( &$this, 'add_menu_noification' ) ); add_action( 'admin_bar_menu', array( &$this, 'add_admin_bar_noification' ), 1000 ); if ( isset( $_GET['page'] ) && $_GET['page']==$this->update_page_name ) { add_action( 'admin_init', array( &$this, 'init_update_functionality' ) ); add_action( 'admin_notices', array( &$this, 'add_update_notices' ) ); } } /** * Adds an update notification to the WordPress Dashboard menu. */ public function add_menu_noification() { if ( function_exists( 'simplexml_load_string' ) ) { // Stop if simplexml_load_string funtion isn't available if ( $this->is_new_version_available() ) { $count = ( isset( $_GET[self::UPDATE_ATTRIBUTE] ) && $_GET[self::UPDATE_ATTRIBUTE]=='true' )?'':'1'; add_dashboard_page( $this->theme_name . ' Theme Updates', $this->theme_name . ' Update '.$count, 'administrator', $this->update_page_name, array( &$this, "print_update_page" ) ); } } } /** * Adds an update notification to the WordPress 3.1+ Admin Bar. */ public function add_admin_bar_noification() { if ( function_exists( 'simplexml_load_string' ) ) { // Stop if simplexml_load_string funtion isn't available global $wp_admin_bar, $wpdb; if ( !is_super_admin() || !is_admin_bar_showing() ) // Don't display notification in admin bar if it's disabled or the current user isn't an administrator return; if ( $this->is_new_version_available() ) { // Compare current theme version with the remote XML version $wp_admin_bar->add_menu( array( 'id' => 'pexeto_update_notifier', 'title' => '' . $this->theme_name . ' New Updates', 'href' => get_admin_url() . 'index.php?page='.$this->update_page_name ) ); } } } /** * Checks if a new version of the theme is available. * * @return boolean true if a new version is available and false if there isn't a new version available */ public function is_new_version_available() { if ( !isset( $this->new_available ) ) { $xml = $this->get_update_xml(); // Get the latest remote XML file on our server $this->new_available = $this->is_version_newer( $this->current_version, $xml->latest ); } return $this->new_available; } /** * Compares between two versions if one of them is newer. * * @param [type] $current_ver the current version * @param [type] $latest_ver the latest version * @return boolean true if $latest_ver is newer than $current_ver and false in all other cases */ public function is_version_newer( $current_ver, $latest_ver ) { $latest = explode( '.', $latest_ver ); $current= explode( '.', $current_ver ); $new_available=false; for ( $i=0; $i(int)$latest[$i] ) { $new_available=false; break; } } return $new_available; } /** * Get the remote XML file contents and return its data (Version and Changelog). * Uses the cached version if available and inside the time interval defined. * * @return XML object containing the parsed XML data */ public function get_update_xml() { if ( !isset( $this->xml ) ) { $db_cache_field = 'notifier-cache-'.$this->short_name; $db_cache_field_last_updated = 'notifier-cache-last-updated-'.$this->short_name; $last = get_option( $db_cache_field_last_updated ); $now = time(); // check the cache if ( !$last || ( ( $now - $last ) > $this->cache_interval ) ) { // cache doesn't exist, or is old, so refresh it $res = wp_remote_get( $this->xml_url ); $cache=wp_remote_retrieve_body( $res ); if ( $cache ) { // we got good results update_option( $db_cache_field, $cache ); update_option( $db_cache_field_last_updated, time() ); } // read from the cache file $notifier_data = get_option( $db_cache_field ); }else { // cache file is fresh enough, so read from it $notifier_data = get_option( $db_cache_field ); } // Let's see if the $xml data was returned as we expected it to. // If it didn't, use the default 1.0 as the latest version so that we don't have problems when the remote server hosting the XML file is down if ( strpos( (string)$notifier_data, '' ) === false ) { $notifier_data = '1.0'; } // Load the remote XML data into a variable and return it $this->xml = simplexml_load_string( $notifier_data ); } return $this->xml; } /** * Inits the update functionality. If update is set, validates all the requirements: * - user role must be super admin * - nonce field must verify * - cUrl must be enabled * - the Envato API username and key must be set * and if all the requirements are met, updates the theme. * It sets the protected properties: * $this->theme_updated - will be true if the theme is updated successfully and false in all other cases. * $this->message - will contain an error message if there is an error. */ public function init_update_functionality() { if ( isset( $_GET[self::UPDATE_ATTRIBUTE] ) && $_GET[self::UPDATE_ATTRIBUTE]=='true' ) { $this->theme_updated = false; //test the user capability if ( !is_super_admin() ) { $this->update_message = 'Error: You are not allowed to update the theme with this user role. Please login as super admin to update the theme.'; return; } //test the nonce $nonce=$_GET[self::NONCE]; if ( !wp_verify_nonce( $nonce, self::NONCE ) ) { $this->update_message = 'Error: Your nonce did not verify. Please re-open this page and try again.'; return; } //test if cURL is enabled - the Envato Toolkit uses cURL, so the update can be performed if ( !in_array( 'curl', get_loaded_extensions() ) ) { $this->update_message = 'Error: The theme was not updated, because the cURL extension is not enabled on your server. In order to update the theme automatically, the Envato Toolkit Library requires cURL to be enabled on your server. You can contact your hosting provider to enable this extension for you.'; return; } $tf_username = pexeto_option( 'tf_username' ); $tf_api_key = pexeto_option( 'tf_api_key' ); if ( !$tf_username || !$tf_api_key ) { $this->update_message = $this->get_empty_details_message(); return; } // include the library include_once get_template_directory().'/'.self::ENVATO_LIB_PATH; //update the theme $allow_cache=true; $upgrader = new Envato_WordPress_Theme_Upgrader( $tf_username, $tf_api_key ); $upgrader->check_for_theme_update($this->theme_name, $allow_cache); $res = $upgrader->upgrade_theme($this->theme_name, $allow_cache); $success = $res->success; $this->theme_updated = $success; } } /** * Adds an update message to the standard admin notices if there is a message set. * Requires the $this->theme_updated to be set to true or false and if it is set to false * (meaning that the update was not successful), it uses the global $this->update_message to display the message. */ public function add_update_notices() { $message_type="updated"; if ( isset( $this->theme_updated ) ) { if ( $this->theme_updated ) { $message = 'The theme has been updated successfully'; }else { $message = $this->update_message? $this->update_message : 'An error occurred, the theme has not been updated. Please try again later or install the update manually.'; $message_type = "error"; } } if ( isset( $message ) ) { echo '

'.$message.'

'; } if ( isset( $this->a ) ) { echo $this->a; } } public function print_update_notification_message( $add_link = false ) { $xml = $this->get_update_xml(); $message = '

'.$xml->message .' You have version '.$this->current_version.' installed. Please '; if ( $add_link ) { $message.= ''; } $message .= 'update to version '. $xml->latest; if ( $add_link ) { $message.= ''; } $message .='.

'; echo $message; } /** * Prints the update page containing instructions, update changelog and an option to update the theme automatically. */ public function print_update_page() { $xml = $this->get_update_xml(); echo '

'.$this->theme_name.'Theme Updates

'; if ( !( isset( $_GET[self::UPDATE_ATTRIBUTE] ) && $_GET[self::UPDATE_ATTRIBUTE]=='true' ) ) { $this->print_update_notification_message(); $this->print_instructions(); } //print the changelog echo '

Update Changes

'.$xml->changelog.'

'; } /** * Prints the update instructions including the option links to update the theme automatically. */ protected function print_instructions() { $nonce = wp_create_nonce( self::NONCE ); $update_url= admin_url( 'index.php?page='.$this->update_page_name.'&'.self::UPDATE_ATTRIBUTE.'=true&'.self::NONCE.'='.$nonce ); $envato_details = ( pexeto_option( 'tf_username' ) && pexeto_option( 'tf_api_key' ) )?"true":"false"; echo '

Automatic Update Instructions

Important: Please note that with the automatic theme update any code modifications done in the theme\'s code will be lost, so please make sure you have a backup copy of the theme files before you update the theme.

In order to use this functionality, you have to:
1. Go to "'.$this->theme_name.' Options" » "General" » "Theme Update" section and insert your Envato Marketplace username and API Key in the relevant fields.
2. Make sure that the name of the folder that contains the theme files is called "'.$this->short_name.'". This is the default folder name, so if you haven\'t modified it manually, the name of the folder on your server should be called "'. $this->short_name.'"

Are you sure you want to update the theme and replace all your current theme files with the new updated files?

'.$this->get_empty_details_message().'

Automatically Update Theme

Manual Update Instructions

It is recommended to manually install the update if you have done some modifications to the theme\'s code. If so, first create a backup copy of the current theme you have installed and modified and then you can proceed with installing the update.

View Update Instructions

To download the latest update of the theme, login to ThemeForest, head over to your Downloads section and re-download the theme like you did when you bought it.

You have to first unzip the zipped theme file and then you can use an FTP client (such as FileZilla) and replace all the theme files with the updated ones.

Note: Please note that with the file replacing all the code changes you have made to the files (if you have made any) will be lost, so please make sure you have a backup copy of the theme files before you do the replacement. All the settings that you have made from the admin panel won\'t be lost- they will be still available.

For more information about the updates, please refer to the "Updates" section of the documentation included.

'; } /** * Returns the message that will be displayed when the Envato API username and key are not inserted. * * @return string the error message */ protected function get_empty_details_message() { return 'You haven\'t inserted your Marketplace username and API Key - please go to the '.$this->theme_name .' Options page and populate the required data in the "Theme Update" section.'; } }