first commit

wp-content/plugins/elementor-3.2.5-bck4/core/upgrade/elementor-3-re-migrate-globals.php

@@ -0,0 +1,157 @@
+<?php
+namespace Elementor\Core\Upgrade;
+
+use Elementor\Core\Common\Modules\Ajax\Module as Ajax;
+use Elementor\Core\Settings\Manager as SettingsManager;
+use Elementor\Core\Settings\Page\Manager as SettingsPageManager;
+use Elementor\Plugin;
+use Elementor\Tools;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit; // Exit if accessed directly
+}
+
+class Elementor_3_Re_Migrate_Globals {
+
+	public function register_ajax_actions( Ajax $ajax ) {
+		$ajax->register_ajax_action( 're_migrate_globals', [ $this, 'ajax_re_migrate_globals' ] );
+	}
+
+	public function ajax_re_migrate_globals() {
+		$this->run();
+
+		return true;
+	}
+
+	/**
+	 * @deprecated 3.1.0
+	 */
+	public function admin_localize_settings() {
+		Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0' );
+
+		return [];
+	}
+
+	public function register_admin_tools_fields( Tools $tools ) {
+		// Add the re-migrate button only if needed.
+		if ( ! $this->has_typography() && ! $this->has_colors() && ! $this->has_saved_colors() ) {
+			return;
+		}
+
+		// Add the button to the rollback screen.
+		$tools->add_fields( 'versions', 'rollback', [
+			're_migrate_globals_separator' => [
+				'field_args' => [
+					'type' => 'raw_html',
+					'html' => '<hr>',
+				],
+			],
+			're_migrate_globals' => [
+				'label' => __( 'Rerun Update Script', 'elementor' ),
+				'field_args' => [
+					'type' => 'raw_html',
+					'html' => sprintf(
+						'<a href="#" data-nonce="%s" class="button elementor-button-spinner elementor-re-migrate-globals-button">%s</a>',
+						wp_create_nonce( 'elementor_re_migrate_globals' ),
+						__( 'Migrate to v3.0', 'elementor' )
+					),
+					'desc' => '<span style="color: red;">' . __( 'Warning: This will reset your current Global Fonts and Colors, and will migrate your previous settings from v2.x versions.', 'elementor' ) . '</span>',
+				],
+			],
+		] );
+	}
+
+	private function run() {
+		$this->notice( 'Re-migrate 3.0.0 globals: Start' );
+
+		$callbacks = [];
+
+		$active_kit_id = Plugin::$instance->kits_manager->get_active_id();
+		$kit = Plugin::$instance->documents->get( $active_kit_id );
+		// Already exist. use raw settings that doesn't have default values.
+		$meta_key = SettingsPageManager::META_KEY;
+		$kit_raw_settings = $kit->get_meta( $meta_key );
+
+		if ( $this->has_typography() ) {
+			$callbacks[] = [ Upgrades::class, '_v_3_0_0_move_default_typography_to_kit' ];
+			unset( $kit_raw_settings['system_typography'] );
+		} else {
+			$this->notice( 'Typography not found' );
+		}
+
+		if ( $this->has_colors() ) {
+			$callbacks[] = [ Upgrades::class, '_v_3_0_0_move_default_colors_to_kit' ];
+			unset( $kit_raw_settings['system_colors'] );
+		} else {
+			$this->notice( 'Colors not found' );
+		}
+
+		if ( $this->has_saved_colors() ) {
+			$callbacks[] = [ Upgrades::class, '_v_3_0_0_move_saved_colors_to_kit' ];
+			unset( $kit_raw_settings['custom_colors'] );
+		} else {
+			$this->notice( 'Saved Colors not found' );
+		}
+
+		if ( ! empty( $callbacks ) ) {
+			$page_settings_manager = SettingsManager::get_settings_managers( 'page' );
+			$page_settings_manager->save_settings( $kit_raw_settings, $active_kit_id );
+
+			$this->run_callbacks( $callbacks );
+		}
+
+		Plugin::$instance->files_manager->clear_cache();
+
+		$this->notice( 'Re-migrate 3.0.0 globals: End' );
+	}
+
+	private function run_callbacks( $callbacks ) {
+		foreach ( $callbacks as $callback ) {
+			$updater = $this->create_updater();
+
+			$this->notice( 'Re-migrate 3.0.0 globals: ' . $callback[1] );
+
+			// Run upgrade.
+			call_user_func( $callback, $updater, false );
+		}
+	}
+
+	/**
+	 * @return Updater
+	 */
+	private function create_updater() {
+		$upgrades_manager = new Manager();
+
+		/** @var Updater $updater */
+		$updater = $upgrades_manager->get_task_runner();
+
+		$updater->set_current_item( [
+			'iterate_num' => 1,
+		] );
+
+		return $updater;
+	}
+
+	private function has_typography() {
+		return ! ! get_option( 'elementor_scheme_typography' );
+	}
+
+	private function has_colors() {
+		return ! ! get_option( 'elementor_scheme_color' );
+	}
+
+	private function has_saved_colors() {
+		return ! ! get_option( 'elementor_scheme_color-picker' );
+	}
+
+	private function notice( $message ) {
+		$logger = Plugin::$instance->logger->get_logger();
+		$logger->notice( $message );
+	}
+
+	public function __construct() {
+		add_action( 'elementor/admin/after_create_settings/' . Tools::PAGE_ID, [ $this, 'register_admin_tools_fields' ], 60 /* After plugins rollback */ );
+		add_action( 'elementor/ajax/register_actions', [ $this, 'register_ajax_actions' ] );
+
+	}
+}

wp-content/plugins/elementor-3.2.5-bck4/core/upgrade/manager.php

@@ -0,0 +1,85 @@
+<?php
+namespace Elementor\Core\Upgrade;
+
+use Elementor\Core\Base\DB_Upgrades_Manager;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit; // Exit if accessed directly
+}
+
+class Manager extends DB_Upgrades_Manager {
+
+	const INSTALLS_HISTORY_META = 'elementor_install_history';
+
+	// todo: remove in future releases
+	public function should_upgrade() {
+		if ( ( 'elementor' === $this->get_plugin_name() ) && version_compare( get_option( $this->get_version_option_name() ), '2.4.2', '<' ) ) {
+			delete_option( 'elementor_log' );
+		}
+
+		return parent::should_upgrade();
+	}
+
+	public function get_name() {
+		return 'upgrade';
+	}
+
+	public function get_action() {
+		return 'elementor_updater';
+	}
+
+	public function get_plugin_name() {
+		return 'elementor';
+	}
+
+	public function get_plugin_label() {
+		return __( 'Elementor', 'elementor' );
+	}
+
+	public function get_updater_label() {
+		return __( 'Elementor Data Updater', 'elementor' );
+	}
+
+	public function get_new_version() {
+		return ELEMENTOR_VERSION;
+	}
+
+	public function get_version_option_name() {
+		return 'elementor_version';
+	}
+
+	public function get_upgrades_class() {
+		return 'Elementor\Core\Upgrade\Upgrades';
+	}
+
+	public static function get_installs_history() {
+		return get_option( self::INSTALLS_HISTORY_META, [] );
+	}
+
+	public static function install_compare( $version, $operator ) {
+		$installs_history = self::get_installs_history();
+
+		return version_compare( key( $installs_history ), $version, $operator );
+	}
+
+	protected function update_db_version() {
+		parent::update_db_version();
+
+		$installs_history = self::get_installs_history();
+
+		$time = time();
+
+		$installs_history[ ELEMENTOR_VERSION ] = $time;
+
+		$old_version = $this->get_current_version();
+
+		// If there was an old version of Elementor, and there's no record for that install yet
+		if ( $old_version && empty( $installs_history[ $old_version ] ) ) {
+			$installs_history[ $old_version ] = $installs_history[ ELEMENTOR_VERSION ] - 1;
+		}
+
+		uksort( $installs_history, 'version_compare' );
+
+		update_option( self::INSTALLS_HISTORY_META, $installs_history );
+	}
+}

wp-content/plugins/elementor-3.2.5-bck4/core/upgrade/updater.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Elementor\Core\Upgrade;
+
+use Elementor\Core\Base\Background_Task;
+use Elementor\Core\Base\DB_Upgrades_Manager;
+
+defined( 'ABSPATH' ) || exit;
+
+class Updater extends Background_Task {
+
+	/**
+	 * @var DB_Upgrades_Manager
+	 */
+	protected $manager;
+
+	protected function format_callback_log( $item ) {
+		return $this->manager->get_plugin_label() . '/Upgrades - ' . $item['callback'][1];
+	}
+
+	public function set_limit( $limit ) {
+		$this->manager->set_query_limit( $limit );
+	}
+}

wp-content/plugins/elementor-3.2.5-bck4/core/upgrade/upgrade-utils.php

@@ -0,0 +1,77 @@
+<?php
+namespace Elementor\Core\Upgrade;
+
+use Elementor\Plugin;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit; // Exit if accessed directly
+}
+
+class Upgrade_Utils {
+
+	/**
+	 *  _update_widget_settings
+	 *
+	 * @param string $widget_id  widget type id
+	 * @param Updater $updater   updater instance
+	 * @param array $changes     array containing updating control_ids, callback and other data needed by the callback
+	 *
+	 * @return bool
+	 */
+	public static function _update_widget_settings( $widget_id, $updater, $changes ) {
+		global $wpdb;
+
+		$post_ids = $updater->query_col(
+			'SELECT `post_id` 
+					FROM `' . $wpdb->postmeta . '` 
+					WHERE `meta_key` = "_elementor_data" 
+					AND `meta_value` LIKE \'%"widgetType":"' . $widget_id . '"%\';'
+		);
+
+		if ( empty( $post_ids ) ) {
+			return false;
+		}
+
+		foreach ( $post_ids as $post_id ) {
+			$do_update = false;
+
+			$document = Plugin::instance()->documents->get( $post_id );
+
+			if ( ! $document ) {
+				continue;
+			}
+
+			$data = $document->get_elements_data();
+
+			if ( empty( $data ) ) {
+				continue;
+			}
+
+			// loop thru callbacks & array
+			foreach ( $changes as $change ) {
+				$args = [
+					'do_update' => &$do_update,
+					'widget_id' => $widget_id,
+					'control_ids' => $change['control_ids'],
+				];
+
+				if ( isset( $change['prefix'] ) ) {
+					$args['prefix'] = $change['prefix'];
+					$args['new_id'] = $change['new_id'];
+				}
+
+				$data = Plugin::instance()->db->iterate_data( $data, $change['callback'], $args );
+				if ( ! $do_update ) {
+					continue;
+				}
+
+				// We need the `wp_slash` in order to avoid the unslashing during the `update_metadata`
+				$json_value = wp_slash( wp_json_encode( $data ) );
+
+				update_metadata( 'post', $post_id, '_elementor_data', $json_value );
+			}
+		} // End foreach().
+
+		return $updater->should_run_again( $post_ids );
+	}
+}

wp-content/plugins/elementor-3.2.5-bck4/core/upgrade/upgrades.php

@@ -0,0 +1,965 @@
+<?php
+namespace Elementor\Core\Upgrade;
+
+use Elementor\Core\Breakpoints\Manager as Breakpoints_Manager;
+use Elementor\Core\Experiments\Manager as Experiments_Manager;
+use Elementor\Core\Kits\Documents\Tabs\Settings_Layout;
+use Elementor\Core\Responsive\Responsive;
+use Elementor\Core\Settings\Manager as SettingsManager;
+use Elementor\Core\Settings\Page\Manager as SettingsPageManager;
+use Elementor\Icons_Manager;
+use Elementor\Modules\Usage\Module;
+use Elementor\Plugin;
+use Elementor\Utils;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit; // Exit if accessed directly.
+}
+
+/**
+ * Elementor upgrades.
+ *
+ * Elementor upgrades handler class is responsible for updating different
+ * Elementor versions.
+ *
+ * @since 1.0.0
+ */
+class Upgrades {
+
+	/**
+	 * Upgrade Elementor 0.3.2
+	 *
+	 * Change the image widget link URL, setting is to `custom` link.
+	 *
+	 * @since 2.0.0
+	 * @static
+	 * @access public
+	 */
+	public static function _v_0_3_2() {
+		global $wpdb;
+
+		$post_ids = $wpdb->get_col(
+			'SELECT `post_id` FROM `' . $wpdb->postmeta . '`
+					WHERE `meta_key` = \'_elementor_version\'
+						AND `meta_value` = \'0.1\';'
+		);
+
+		if ( empty( $post_ids ) ) {
+			return;
+		}
+
+		foreach ( $post_ids as $post_id ) {
+			$document = Plugin::$instance->documents->get( $post_id );
+
+			if ( $document ) {
+				$data = $document->get_elements_data();
+			}
+
+			if ( empty( $data ) ) {
+				continue;
+			}
+
+			$data = Plugin::$instance->db->iterate_data( $data, function( $element ) {
+				if ( empty( $element['widgetType'] ) || 'image' !== $element['widgetType'] ) {
+					return $element;
+				}
+
+				if ( ! empty( $element['settings']['link']['url'] ) && ! isset( $element['settings']['link_to'] ) ) {
+					$element['settings']['link_to'] = 'custom';
+				}
+
+				return $element;
+			} );
+
+			$document = Plugin::$instance->documents->get( $post_id );
+
+			$document->save( [
+				'elements' => $data,
+			] );
+		}
+	}
+
+	/**
+	 * Upgrade Elementor 0.9.2
+	 *
+	 * Change the icon widget, icon-box widget and the social-icons widget,
+	 * setting their icon padding size to an empty string.
+	 *
+	 * Change the image widget, setting the image size to full image size.
+	 *
+	 * @since 2.0.0
+	 * @static
+	 * @access public
+	 */
+	public static function _v_0_9_2() {
+		global $wpdb;
+
+		// Fix Icon/Icon Box Widgets padding.
+		$post_ids = $wpdb->get_col(
+			'SELECT `post_id` FROM `' . $wpdb->postmeta . '`
+					WHERE `meta_key` = \'_elementor_version\'
+						AND `meta_value` = \'0.2\';'
+		);
+
+		if ( empty( $post_ids ) ) {
+			return;
+		}
+
+		foreach ( $post_ids as $post_id ) {
+			$document = Plugin::$instance->documents->get( $post_id );
+
+			if ( $document ) {
+				$data = $document->get_elements_data();
+			}
+
+			if ( empty( $data ) ) {
+				continue;
+			}
+
+			$data = Plugin::$instance->db->iterate_data( $data, function( $element ) {
+				if ( empty( $element['widgetType'] ) ) {
+					return $element;
+				}
+
+				if ( in_array( $element['widgetType'], [ 'icon', 'icon-box', 'social-icons' ] ) ) {
+					if ( ! empty( $element['settings']['icon_padding']['size'] ) ) {
+						$element['settings']['icon_padding']['size'] = '';
+					}
+				}
+
+				if ( 'image' === $element['widgetType'] ) {
+					if ( empty( $element['settings']['image_size'] ) ) {
+						$element['settings']['image_size'] = 'full';
+					}
+				}
+
+				return $element;
+			} );
+
+			$document = Plugin::$instance->documents->get( $post_id );
+
+			$document->save( [
+				'elements' => $data,
+			] );
+		}
+	}
+
+	/**
+	 * Upgrade Elementor 0.11.0
+	 *
+	 * Change the button widget sizes, setting up new button sizes.
+	 *
+	 * @since 2.0.0
+	 * @static
+	 * @access public
+	 */
+	public static function _v_0_11_0() {
+		global $wpdb;
+
+		// Fix Button widget to new sizes options.
+		$post_ids = $wpdb->get_col(
+			'SELECT `post_id` FROM `' . $wpdb->postmeta . '`
+					WHERE `meta_key` = \'_elementor_version\'
+						AND `meta_value` = \'0.3\';'
+		);
+
+		if ( empty( $post_ids ) ) {
+			return;
+		}
+
+		foreach ( $post_ids as $post_id ) {
+			$document = Plugin::$instance->documents->get( $post_id );
+
+			if ( $document ) {
+				$data = $document->get_elements_data();
+			}
+
+			if ( empty( $data ) ) {
+				continue;
+			}
+
+			$data = Plugin::$instance->db->iterate_data( $data, function( $element ) {
+				if ( empty( $element['widgetType'] ) ) {
+					return $element;
+				}
+
+				if ( 'button' === $element['widgetType'] ) {
+					$size_to_replace = [
+						'small' => 'xs',
+						'medium' => 'sm',
+						'large' => 'md',
+						'xl' => 'lg',
+						'xxl' => 'xl',
+					];
+
+					if ( ! empty( $element['settings']['size'] ) ) {
+						$old_size = $element['settings']['size'];
+
+						if ( isset( $size_to_replace[ $old_size ] ) ) {
+							$element['settings']['size'] = $size_to_replace[ $old_size ];
+						}
+					}
+				}
+
+				return $element;
+			} );
+
+			$document = Plugin::$instance->documents->get( $post_id );
+
+			$document->save( [
+				'elements' => $data,
+			] );
+		}
+	}
+
+	/**
+	 * Upgrade Elementor 2.0.0
+	 *
+	 * Fix post titles for old autosave drafts that saved with the format 'Auto Save 2018-03-18 17:24'.
+	 *
+	 * @static
+	 * @since 2.0.0
+	 * @access public
+	 */
+	public static function _v_2_0_0() {
+		global $wpdb;
+
+		$posts = $wpdb->get_results(
+			'SELECT `ID`, `post_title`, `post_parent`
+					FROM `' . $wpdb->posts . '` p
+					LEFT JOIN `' . $wpdb->postmeta . '` m ON p.ID = m.post_id
+					WHERE `post_status` = \'inherit\'
+					AND `post_title` = CONCAT(\'Auto Save \', DATE_FORMAT(post_date, "%Y-%m-%d %H:%i"))
+					AND  m.`meta_key` = \'_elementor_data\';'
+		);
+
+		if ( empty( $posts ) ) {
+			return;
+		}
+
+		foreach ( $posts as $post ) {
+			wp_update_post( [
+				'ID' => $post->ID,
+				'post_title' => get_the_title( $post->post_parent ),
+			] );
+		}
+	}
+
+	/**
+	 * Upgrade Elementor 2.0.1
+	 *
+	 * Fix post titles for old autosave drafts that saved with the format 'Auto Save...'.
+	 *
+	 * @since 2.0.2
+	 * @static
+	 * @access public
+	 */
+	public static function _v_2_0_1() {
+		global $wpdb;
+
+		$posts = $wpdb->get_results(
+			'SELECT `ID`, `post_title`, `post_parent`
+					FROM `' . $wpdb->posts . '` p
+					LEFT JOIN `' . $wpdb->postmeta . '` m ON p.ID = m.post_id
+					WHERE `post_status` = \'inherit\'
+					AND `post_title` REGEXP \'^Auto Save [0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}$\'
+					AND  m.`meta_key` = \'_elementor_data\';'
+		);
+
+		if ( empty( $posts ) ) {
+			return;
+		}
+
+		foreach ( $posts as $post ) {
+			$parent = get_post( $post->post_parent );
+			$title = isset( $parent->post_title ) ? $parent->post_title : '';
+
+			wp_update_post( [
+				'ID' => $post->ID,
+				'post_title' => $title,
+			] );
+		}
+	}
+
+	/**
+	 * Upgrade Elementor 2.0.10
+	 *
+	 * Fix post titles for old autosave drafts that saved with the format 'Auto Save...'.
+	 * Fix also Translated titles.
+	 *
+	 * @since 2.0.10
+	 * @static
+	 * @access public
+	 */
+	public static function _v_2_0_10() {
+		global $wpdb;
+
+		$posts = $wpdb->get_results(
+			'SELECT `ID`, `post_title`, `post_parent`
+					FROM `' . $wpdb->posts . '` p
+					LEFT JOIN `' . $wpdb->postmeta . '` m ON p.ID = m.post_id
+					WHERE `post_status` = \'inherit\'
+					AND `post_title` REGEXP \'[[:alnum:]]+ [[:alnum:]]+ [0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}$\'
+					AND  m.`meta_key` = \'_elementor_data\';'
+		);
+
+		if ( empty( $posts ) ) {
+			return;
+		}
+
+		foreach ( $posts as $post ) {
+			$parent = get_post( $post->post_parent );
+			$title = isset( $parent->post_title ) ? $parent->post_title : '';
+
+			wp_update_post( [
+				'ID' => $post->ID,
+				'post_title' => $title,
+			] );
+		}
+	}
+
+	public static function _v_2_1_0() {
+		global $wpdb;
+
+		// upgrade `video` widget settings (merge providers).
+		$post_ids = $wpdb->get_col(
+			'SELECT `post_id` FROM `' . $wpdb->postmeta . '` WHERE `meta_key` = "_elementor_data" AND `meta_value` LIKE \'%"widgetType":"video"%\';'
+		);
+
+		if ( empty( $post_ids ) ) {
+			return;
+		}
+
+		foreach ( $post_ids as $post_id ) {
+			$do_update = false;
+			$document = Plugin::$instance->documents->get( $post_id );
+
+			if ( $document ) {
+				$data = $document->get_elements_data();
+			}
+
+			if ( empty( $data ) ) {
+				continue;
+			}
+
+			$data = Plugin::$instance->db->iterate_data( $data, function( $element ) use ( &$do_update ) {
+				if ( empty( $element['widgetType'] ) || 'video' !== $element['widgetType'] ) {
+					return $element;
+				}
+
+				$replacements = [];
+
+				if ( empty( $element['settings']['video_type'] ) || 'youtube' === $element['settings']['video_type'] ) {
+					$replacements = [
+						'yt_autoplay' => 'autoplay',
+						'yt_controls' => 'controls',
+						'yt_mute' => 'mute',
+						'yt_rel' => 'rel',
+						'link' => 'youtube_url',
+					];
+				} elseif ( 'vimeo' === $element['settings']['video_type'] ) {
+					$replacements = [
+						'vimeo_autoplay' => 'autoplay',
+						'vimeo_loop' => 'loop',
+						'vimeo_color' => 'color',
+						'vimeo_link' => 'vimeo_url',
+					];
+				}
+
+				// cleanup old unused settings.
+				unset( $element['settings']['yt_rel_videos'] );
+
+				foreach ( $replacements as $old => $new ) {
+					if ( ! empty( $element['settings'][ $old ] ) ) {
+						$element['settings'][ $new ] = $element['settings'][ $old ];
+						$do_update = true;
+					}
+				}
+
+				return $element;
+			} );
+
+			// Only update if needed.
+			if ( ! $do_update ) {
+				continue;
+			}
+
+			// We need the `wp_slash` in order to avoid the unslashing during the `update_post_meta`
+			$json_value = wp_slash( wp_json_encode( $data ) );
+
+			update_metadata( 'post', $post_id, '_elementor_data', $json_value );
+
+			// Clear WP cache for next step.
+			wp_cache_flush();
+		} // End foreach().
+	}
+
+	/**
+	 * @param Updater $updater
+	 *
+	 * @return bool
+	 */
+	public static function _v_2_3_0_widget_image( $updater ) {
+		global $wpdb;
+
+		// upgrade `video` widget settings (merge providers).
+		$post_ids = $updater->query_col(
+			'SELECT `post_id` FROM `' . $wpdb->postmeta . '` WHERE `meta_key` = "_elementor_data" AND (
+			`meta_value` LIKE \'%"widgetType":"image"%\'
+			OR `meta_value` LIKE \'%"widgetType":"theme-post-featured-image"%\'
+			OR `meta_value` LIKE \'%"widgetType":"theme-site-logo"%\'
+			OR `meta_value` LIKE \'%"widgetType":"woocommerce-category-image"%\'
+			);'
+		);
+
+		if ( empty( $post_ids ) ) {
+			return false;
+		}
+
+		$widgets = [
+			'image',
+			'theme-post-featured-image',
+			'theme-site-logo',
+			'woocommerce-category-image',
+		];
+
+		foreach ( $post_ids as $post_id ) {
+			// Clear WP cache for next step.
+			wp_cache_flush();
+
+			$do_update = false;
+
+			$document = Plugin::$instance->documents->get( $post_id );
+
+			if ( ! $document ) {
+				continue;
+			}
+
+			$data = $document->get_elements_data();
+
+			if ( empty( $data ) ) {
+				continue;
+			}
+
+			$data = Plugin::$instance->db->iterate_data( $data, function( $element ) use ( &$do_update, $widgets ) {
+				if ( empty( $element['widgetType'] ) || ! in_array( $element['widgetType'], $widgets ) ) {
+					return $element;
+				}
+
+				if ( ! empty( $element['settings']['caption'] ) ) {
+					if ( ! isset( $element['settings']['caption_source'] ) ) {
+						$element['settings']['caption_source'] = 'custom';
+
+						$do_update = true;
+					}
+				}
+
+				return $element;
+			} );
+
+			// Only update if needed.
+			if ( ! $do_update ) {
+				continue;
+			}
+
+			// We need the `wp_slash` in order to avoid the unslashing during the `update_post_meta`
+			$json_value = wp_slash( wp_json_encode( $data ) );
+
+			update_metadata( 'post', $post_id, '_elementor_data', $json_value );
+		} // End foreach().
+
+		return $updater->should_run_again( $post_ids );
+	}
+
+	/**
+	 * @param Updater $updater
+	 *
+	 * @return bool
+	 */
+	public static function _v_2_3_0_template_type( $updater ) {
+		global $wpdb;
+
+		$post_ids = $updater->query_col(
+			'SELECT p.ID
+					FROM `' . $wpdb->posts . '` AS p
+					LEFT JOIN `' . $wpdb->postmeta . '` AS pm1 ON (p.ID = pm1.post_id)
+					LEFT JOIN `' . $wpdb->postmeta . '` AS pm2 ON (pm1.post_id = pm2.post_id AND pm2.meta_key = "_elementor_template_type")
+					WHERE p.post_status != "inherit" AND pm1.`meta_key` = "_elementor_data" AND pm2.post_id IS NULL;'
+		);
+
+		if ( empty( $post_ids ) ) {
+			return false;
+		}
+
+		foreach ( $post_ids as $post_id ) {
+			// Clear WP cache for next step.
+			wp_cache_flush();
+
+			$document = Plugin::$instance->documents->get( $post_id );
+
+			if ( ! $document ) {
+				continue;
+			}
+
+			$document->save_template_type();
+		} // End foreach().
+
+		return $updater->should_run_again( $post_ids );
+	}
+
+	/**
+	 * Set FontAwesome Migration needed flag
+	 */
+	public static function _v_2_6_0_fa4_migration_flag() {
+		add_option( 'elementor_icon_manager_needs_update', 'yes' );
+		add_option( 'elementor_load_fa4_shim', 'yes' );
+	}
+
+	/**
+	 * migrate Icon control string value to Icons control array value
+	 *
+	 * @param array $element
+	 * @param array $args
+	 *
+	 * @return mixed
+	 */
+	public static function _migrate_icon_fa4_value( $element, $args ) {
+		$widget_id = $args['widget_id'];
+
+		if ( empty( $element['widgetType'] ) || $widget_id !== $element['widgetType'] ) {
+			return $element;
+		}
+		foreach ( $args['control_ids'] as $old_name => $new_name ) {
+			// exit if new value exists
+			if ( isset( $element['settings'][ $new_name ] ) ) {
+				continue;
+			}
+
+			// exit if no value to migrate
+			if ( ! isset( $element['settings'][ $old_name ] ) ) {
+				continue;
+			}
+
+			$element['settings'][ $new_name ] = Icons_Manager::fa4_to_fa5_value_migration( $element['settings'][ $old_name ] );
+			$args['do_update'] = true;
+		}
+		return $element;
+	}
+
+	/**
+	 * Set FontAwesome 5 value Migration on for button widget
+	 *
+	 * @param Updater $updater
+	 */
+	public static function _v_2_6_6_fa4_migration_button( $updater ) {
+		$changes = [
+			[
+				'callback' => [ 'Elementor\Core\Upgrade\Upgrades', '_migrate_icon_fa4_value' ],
+				'control_ids' => [
+					'icon' => 'selected_icon',
+				],
+			],
+		];
+		Upgrade_Utils::_update_widget_settings( 'button', $updater, $changes );
+		Upgrade_Utils::_update_widget_settings( 'icon-box', $updater, $changes );
+	}
+
+	/**
+	 *  Update database to separate page from post.
+	 *
+	 * @param Updater $updater
+	 *
+	 * @param string $type
+	 *
+	 * @return bool
+	 */
+	public static function rename_document_base_to_wp( $updater, $type ) {
+		global $wpdb;
+
+		$post_ids = $updater->query_col( $wpdb->prepare(
+			"SELECT p1.ID FROM {$wpdb->posts} AS p
+					LEFT JOIN {$wpdb->posts} AS p1 ON (p.ID = p1.post_parent || p.ID = p1.ID)
+					WHERE p.post_type = %s;", $type ) );
+
+		if ( empty( $post_ids ) ) {
+			return false;
+		}
+
+		$sql_post_ids = implode( ',', $post_ids );
+
+		$wpdb->query( $wpdb->prepare(
+			"UPDATE $wpdb->postmeta SET meta_value = %s
+			WHERE meta_key = '_elementor_template_type' && post_id in ( %s );
+		 ", 'wp-' . $type, $sql_post_ids ) );
+
+		return $updater->should_run_again( $post_ids );
+	}
+
+	/**
+	 *  Update database to separate page from post.
+	 *
+	 * @param Updater $updater
+	 *
+	 * @return bool
+	 */
+	// Because the query is slow on large sites, temporary don't upgrade.
+	/*	public static function _v_2_7_0_rename_document_types_to_wp( $updater ) {
+		return self::rename_document_base_to_wp( $updater, 'post' ) || self::rename_document_base_to_wp( $updater, 'page' );
+	}*/
+
+	// Upgrade code was fixed & moved to _v_2_7_1_remove_old_usage_data.
+	/* public static function _v_2_7_0_remove_old_usage_data() {} */
+
+	// Upgrade code moved to _v_2_7_1_recalc_usage_data.
+	/* public static function _v_2_7_0_recalc_usage_data( $updater ) {} */
+
+	/**
+	 * Don't use the old data anymore.
+	 * Since 2.7.1 the key was changed from `elementor_elements_usage` to `elementor_controls_usage`.
+	 */
+	public static function _v_2_7_1_remove_old_usage_data() {
+		delete_option( 'elementor_elements_usage' );
+		delete_post_meta_by_key( '_elementor_elements_usage' );
+	}
+
+	/**
+	 * Recalc usage.
+	 *
+	 * @param Updater $updater
+	 *
+	 * @return bool
+	 */
+	public static function recalc_usage_data( $updater ) {
+		/** @var Module $module */
+		$module = Plugin::$instance->modules_manager->get_modules( 'usage' );
+
+		$post_count = $module->recalc_usage( $updater->get_limit(), $updater->get_current_offset() );
+
+		return ( $post_count === $updater->get_limit() );
+	}
+
+	public static function _v_2_7_1_recalc_usage_data( $updater ) {
+		return self::recalc_usage_data( $updater );
+	}
+
+	public static function _v_2_8_3_recalc_usage_data( $updater ) {
+		// Re-calc since older version(s) had invalid values.
+		return self::recalc_usage_data( $updater );
+	}
+
+	/**
+	 * Move general & lightbox settings to active kit and all it's revisions.
+	 *
+	 * @param Updater $updater
+	 *
+	 * @return bool
+	 */
+	public static function _v_3_0_0_move_general_settings_to_kit( $updater ) {
+		$callback = function( $kit_id ) {
+			$kit = Plugin::$instance->documents->get( $kit_id );
+
+			if ( ! $kit ) {
+				self::notice( 'Kit not found. nothing to do.' );
+				return;
+			}
+
+			$meta_key = SettingsPageManager::META_KEY;
+			$current_settings = get_option( '_elementor_general_settings', [] );
+			// Take the `space_between_widgets` from the option due to a bug on E < 3.0.0 that the value `0` is stored separated.
+			$current_settings['space_between_widgets'] = get_option( 'elementor_space_between_widgets', '' );
+			$current_settings[ Breakpoints_Manager::BREAKPOINT_SETTING_PREFIX . 'md' ] = get_option( 'elementor_viewport_md', '' );
+			$current_settings[ Breakpoints_Manager::BREAKPOINT_SETTING_PREFIX . 'lg' ] = get_option( 'elementor_viewport_lg', '' );
+
+			$kit_settings = $kit->get_meta( $meta_key );
+
+			// Already exist.
+			if ( isset( $kit_settings['default_generic_fonts'] ) ) {
+				self::notice( 'General Settings already exist. nothing to do.' );
+				return;
+			}
+
+			if ( empty( $current_settings ) ) {
+				self::notice( 'Current settings are empty. nothing to do.' );
+				return;
+			}
+
+			if ( ! $kit_settings ) {
+				$kit_settings = [];
+			}
+
+			// Convert some setting to Elementor slider format.
+			$settings_to_slider = [
+				'container_width',
+				'space_between_widgets',
+			];
+
+			foreach ( $settings_to_slider as $setting ) {
+				if ( isset( $current_settings[ $setting ] ) ) {
+					$current_settings[ $setting ] = [
+						'unit' => 'px',
+						'size' => $current_settings[ $setting ],
+					];
+				}
+			}
+
+			$kit_settings = array_merge( $kit_settings, $current_settings );
+
+			$page_settings_manager = SettingsManager::get_settings_managers( 'page' );
+			$page_settings_manager->save_settings( $kit_settings, $kit_id );
+		};
+
+		return self::move_settings_to_kit( $callback, $updater );
+	}
+
+	/**
+	 * Move default colors settings to active kit and all it's revisions.
+	 *
+	 * @param Updater $updater
+	 *
+	 * @return bool
+	 */
+	public static function _v_3_0_0_move_default_colors_to_kit( $updater, $include_revisions = true ) {
+		$callback = function( $kit_id ) {
+			if ( ! Plugin::$instance->kits_manager->is_custom_colors_enabled() ) {
+				self::notice( 'System colors are disabled. nothing to do.' );
+				return;
+			}
+
+			$kit = Plugin::$instance->documents->get( $kit_id );
+
+			// Already exist. use raw settings that doesn't have default values.
+			$meta_key = SettingsPageManager::META_KEY;
+			$kit_raw_settings = $kit->get_meta( $meta_key );
+			if ( isset( $kit_raw_settings['system_colors'] ) ) {
+				self::notice( 'System colors already exist. nothing to do.' );
+				return;
+			}
+
+			$scheme_obj = Plugin::$instance->schemes_manager->get_scheme( 'color' );
+
+			$default_colors = $scheme_obj->get_scheme();
+
+			$new_ids = [
+				'primary',
+				'secondary',
+				'text',
+				'accent',
+			];
+
+			foreach ( $default_colors as $index => $color ) {
+				$kit->add_repeater_row( 'system_colors', [
+					'_id' => $new_ids[ $index - 1 ], // $default_colors starts from 1.
+					'title' => $color['title'],
+					'color' => strtoupper( $color['value'] ),
+				] );
+			}
+		};
+
+		return self::move_settings_to_kit( $callback, $updater, $include_revisions );
+	}
+
+	/**
+	 * Move saved colors settings to active kit and all it's revisions.
+	 *
+	 * @param Updater $updater
+	 *
+	 * @return bool
+	 */
+	public static function _v_3_0_0_move_saved_colors_to_kit( $updater, $include_revisions = true ) {
+		$callback = function( $kit_id ) {
+			$kit = Plugin::$instance->documents->get( $kit_id );
+
+			// Already exist. use raw settings that doesn't have default values.
+			$meta_key = SettingsPageManager::META_KEY;
+			$kit_raw_settings = $kit->get_meta( $meta_key );
+			if ( isset( $kit_raw_settings['custom_colors'] ) ) {
+				self::notice( 'Custom colors already exist. nothing to do.' );
+				return;
+			}
+
+			$system_colors_rows = $kit->get_settings( 'system_colors' );
+
+			if ( ! $system_colors_rows ) {
+				$system_colors_rows = [];
+			}
+
+			$system_colors = [];
+
+			foreach ( $system_colors_rows as $color_row ) {
+				$system_colors[] = strtoupper( $color_row['color'] );
+			}
+
+			$saved_scheme_obj = Plugin::$instance->schemes_manager->get_scheme( 'color-picker' );
+
+			$current_saved_colors_rows = $saved_scheme_obj->get_scheme();
+
+			$current_saved_colors = [];
+
+			foreach ( $current_saved_colors_rows as $color_row ) {
+				$current_saved_colors[] = strtoupper( $color_row['value'] );
+			}
+
+			$colors_to_save = array_diff( $current_saved_colors, $system_colors );
+
+			if ( empty( $colors_to_save ) ) {
+				self::notice( 'Saved colors not found. nothing to do.' );
+				return;
+			}
+
+			foreach ( $colors_to_save as $index => $color ) {
+				$kit->add_repeater_row( 'custom_colors', [
+					'_id' => Utils::generate_random_string(),
+					'title' => __( 'Saved Color', 'elementor' ) . ' #' . ( $index + 1 ),
+					'color' => $color,
+				] );
+			}
+		};
+
+		return self::move_settings_to_kit( $callback, $updater, $include_revisions );
+	}
+
+	/**
+	 * Move default typography settings to active kit and all it's revisions.
+	 *
+	 * @param Updater $updater
+	 *
+	 * @return bool
+	 */
+	public static function _v_3_0_0_move_default_typography_to_kit( $updater, $include_revisions = true ) {
+		$callback = function( $kit_id ) {
+			if ( ! Plugin::$instance->kits_manager->is_custom_typography_enabled() ) {
+				self::notice( 'System typography is disabled. nothing to do.' );
+				return;
+			}
+
+			$kit = Plugin::$instance->documents->get( $kit_id );
+
+			// Already exist. use raw settings that doesn't have default values.
+			$meta_key = SettingsPageManager::META_KEY;
+			$kit_raw_settings = $kit->get_meta( $meta_key );
+			if ( isset( $kit_raw_settings['system_typography'] ) ) {
+				self::notice( 'System typography already exist. nothing to do.' );
+				return;
+			}
+
+			$scheme_obj = Plugin::$instance->schemes_manager->get_scheme( 'typography' );
+
+			$default_typography = $scheme_obj->get_scheme();
+
+			$new_ids = [
+				'primary',
+				'secondary',
+				'text',
+				'accent',
+			];
+
+			foreach ( $default_typography as $index => $typography ) {
+				$kit->add_repeater_row( 'system_typography', [
+					'_id' => $new_ids[ $index - 1 ], // $default_typography starts from 1.
+					'title' => $typography['title'],
+					'typography_typography' => 'custom',
+					'typography_font_family' => $typography['value']['font_family'],
+					'typography_font_weight' => $typography['value']['font_weight'],
+				] );
+			}
+		};
+
+		return self::move_settings_to_kit( $callback, $updater, $include_revisions );
+	}
+
+	public static function v_3_1_0_move_optimized_dom_output_to_experiments() {
+		$saved_option = get_option( 'elementor_optimized_dom_output' );
+
+		if ( $saved_option ) {
+			$new_option = 'enabled' === $saved_option ? Experiments_Manager::STATE_ACTIVE : Experiments_Manager::STATE_INACTIVE;
+
+			add_option( 'elementor_experiment-e_dom_optimization', $new_option );
+		}
+	}
+
+	public static function _v_3_2_0_migrate_breakpoints_to_new_system( $updater, $include_revisions = true ) {
+		$callback = function( $kit_id ) {
+			$kit = Plugin::$instance->documents->get( $kit_id );
+
+			$kit_settings = $kit->get_meta( SettingsPageManager::META_KEY );
+
+			if ( ! $kit_settings ) {
+				// Nothing to upgrade.
+				return;
+			}
+
+			$prefix = Breakpoints_Manager::BREAKPOINT_SETTING_PREFIX;
+			$old_mobile_option_key = $prefix . 'md';
+			$old_tablet_option_key = $prefix . 'lg';
+
+			$breakpoint_values = [
+				$old_mobile_option_key => Plugin::$instance->kits_manager->get_current_settings( $old_mobile_option_key ),
+				$old_tablet_option_key => Plugin::$instance->kits_manager->get_current_settings( $old_tablet_option_key ),
+			];
+
+			// Breakpoint values are either a number, or an empty string (empty setting).
+			array_walk( $breakpoint_values, function( &$breakpoint_value, $breakpoint_key ) {
+				if ( $breakpoint_value ) {
+					// If the saved breakpoint value is a number, 1px is reduced because the new breakpoints system is
+					// based on max-width, as opposed to the old breakpoints system that worked based on min-width.
+					$breakpoint_value--;
+				}
+
+				return $breakpoint_value;
+			} );
+
+			$kit_settings[ $prefix . Breakpoints_Manager::BREAKPOINT_KEY_MOBILE ] = $breakpoint_values[ $old_mobile_option_key ];
+			$kit_settings[ $prefix . Breakpoints_Manager::BREAKPOINT_KEY_TABLET ] = $breakpoint_values[ $old_tablet_option_key ];
+
+			$page_settings_manager = SettingsManager::get_settings_managers( 'page' );
+			$page_settings_manager->save_settings( $kit_settings, $kit_id );
+		};
+
+		return self::move_settings_to_kit( $callback, $updater, $include_revisions );
+	}
+
+	/**
+	 * @param callback $callback
+	 * @param Updater  $updater
+	 *
+	 * @param bool     $include_revisions
+	 *
+	 * @return mixed
+	 */
+	private static function move_settings_to_kit( $callback, $updater, $include_revisions = true ) {
+		$active_kit_id = Plugin::$instance->kits_manager->get_active_id();
+		if ( ! $active_kit_id ) {
+			self::notice( 'Active kit not found. nothing to do.' );
+			return false;
+		}
+
+		$offset = $updater->get_current_offset();
+
+		// On first iteration apply on active kit itself.
+		// (don't include it with revisions in order to avoid offset/iteration count wrong numbers)
+		if ( 0 === $offset ) {
+			$callback( $active_kit_id );
+		}
+
+		if ( ! $include_revisions ) {
+			return false;
+		}
+
+		$revisions_ids = wp_get_post_revisions( $active_kit_id, [
+			'fields' => 'ids',
+			'posts_per_page' => $updater->get_limit(),
+			'offset' => $offset,
+		] );
+
+		foreach ( $revisions_ids as $revision_id ) {
+			$callback( $revision_id );
+		}
+
+		return $updater->should_run_again( $revisions_ids );
+	}
+
+	private static function notice( $message ) {
+		$logger = Plugin::$instance->logger->get_logger();
+		$logger->notice( $message );
+	}
+}