zZzzZ. — /home2/zrzvbdry/public_html/wp-content/plugins/elementor/core/upgrade

Editing: upgrades.php

<?php
namespace Elementor\Core\Upgrade;

use Elementor\Api;
use Elementor\Core\Breakpoints\Manager as Breakpoints_Manager;
use Elementor\Core\Experiments\Manager as Experiments_Manager;
use Elementor\Core\Settings\Manager as SettingsManager;
use Elementor\Core\Settings\Page\Manager as SettingsPageManager;
use Elementor\Icons_Manager;
use Elementor\Includes\Elements\Container;
use Elementor\Modules\Usage\Module;
use Elementor\Plugin;
use Elementor\Tracker;
use Elementor\App\Modules\ImportExport\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 {

public static function _on_each_version( $updater ) {
		self::recalc_usage_data( $updater );
		self::remove_remote_info_api_data();

$uploads_manager = Plugin::$instance->uploads_manager;

$temp_dir = $uploads_manager->get_temp_dir();

if ( file_exists( $temp_dir ) ) {
			$uploads_manager->remove_file_or_dir( $temp_dir );
		}
	}

/**
	 * 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();
		}
	}

/**
	 * @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 );
		}

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();
		}

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 );
	}

/**
	 * 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 ) {
		if ( ! Tracker::is_allow_track() ) {
			return false;
		}

/** @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 );
	}

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 );
	}

public static function _v_3_4_8_fix_font_awesome_default_value_from_1_to_yes() {
		// if `Icons_Manager::LOAD_FA4_SHIM_OPTION_KEY` value is '1', then set it to `yes`.
		$load_fa4_shim_option = get_option( Icons_Manager::LOAD_FA4_SHIM_OPTION_KEY );

if ( '1' === $load_fa4_shim_option ) {
			update_option( Icons_Manager::LOAD_FA4_SHIM_OPTION_KEY, 'yes' );
		}
	}

public static function _v_3_5_0_remove_old_elementor_scheme() {
		global $wpdb;

$wpdb->query( "DELETE FROM {$wpdb->options} WHERE option_name LIKE 'elementor_scheme_%';" );
	}

public static function _v_3_8_0_fix_php8_image_custom_size() {
		global $wpdb;

$attachment_ids = $wpdb->get_col(
			'SELECT `post_id` FROM `' . $wpdb->postmeta . '`
				WHERE `meta_key` = "_wp_attachment_metadata"
					AND (
						`meta_value` LIKE \'%elementor_custom_%\'
					);'
		);

foreach ( $attachment_ids as $attachment_id ) {
			$attachment_metadata = wp_get_attachment_metadata( $attachment_id );
			if ( empty( $attachment_metadata['sizes'] ) || ! is_array( $attachment_metadata['sizes'] ) ) {
				continue;
			}

$old_attachment_metadata = $attachment_metadata;
			foreach ( $attachment_metadata['sizes'] as $size_key => $size_value ) {
				if ( 0 !== strpos( $size_key, 'elementor_custom_' ) ) {
					continue;
				}

if ( absint( $size_value['width'] ) !== $size_value['width'] ) {
					$attachment_metadata['sizes'][ $size_key ]['width'] = (int) $size_value['width'];
				}

if ( absint( $size_value['height'] ) !== $size_value['height'] ) {
					$attachment_metadata['sizes'][ $size_key ]['height'] = (int) $size_value['height'];
				}
			}

if ( $old_attachment_metadata['sizes'] === $attachment_metadata['sizes'] ) {
				continue;
			}

wp_update_attachment_metadata( $attachment_id, $attachment_metadata );
		}
	}

public static function _v_3_16_0_container_updates( $updater ) {
		$post_ids = self::get_post_ids_by_element_type( $updater, 'container' );

if ( empty( $post_ids ) ) {
			return false;
		}

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 = self::iterate_containers( $data );

self::save_updated_document( $post_id, $data );
		}
	}

public static function _v_3_17_0_site_settings_updates() {
		$options = [ 'elementor_active_kit', 'elementor_previous_kit' ];

foreach ( $options as $option_name ) {
			self::maybe_add_gap_control_data( $option_name );
		}
	}

/**
	 * Upgrade Elementor 3.26.0 - Delete old experiments from the DB.
	 *
	 * @since 3.26.0
	 * @static
	 * @access public
	 */
	public static function _v_3_26_0() {
		delete_option( 'elementor_experiment-ai-layout' );
		delete_option( 'elementor_experiment-block_editor_assets_optimize' );
		delete_option( 'elementor_experiment-container_grid' );
		delete_option( 'elementor_experiment-display-conditions' );
		delete_option( 'elementor_experiment-e_dom_optimization' );
		delete_option( 'elementor_experiment-e_global_styleguide' );
		delete_option( 'elementor_experiment-e_image_loading_optimization' );
		delete_option( 'elementor_experiment-e_lazyload' );
		delete_option( 'elementor_experiment-e_optimized_assets_loading' );
		delete_option( 'elementor_experiment-e_optimized_css_loading' );
		delete_option( 'elementor_experiment-e_scroll_snap' );
		delete_option( 'elementor_experiment-floating-buttons' );
		delete_option( 'elementor_experiment-form-submissions' );
		delete_option( 'elementor_experiment-link-in-bio' );
		delete_option( 'elementor_experiment-loop' );
		delete_option( 'elementor_experiment-notes' );
		delete_option( 'elementor_experiment-off-canvas' );
		delete_option( 'elementor_experiment-page-transitions' );
		delete_option( 'elementor_experiment-search' );
		delete_option( 'elementor_experiment-taxonomy-filter' );
	}

private static function maybe_add_gap_control_data( $option_name ) {
		$kit_id = get_option( $option_name );

if ( ! $kit_id ) {
			return;
		}

$kit_data_array = get_post_meta( (int) $kit_id, '_elementor_page_settings', true );

$setting_not_exist = ! isset( $kit_data_array['space_between_widgets'] );
		$already_processed = isset( $kit_data_array['space_between_widgets']['column'] );

if ( $setting_not_exist || $already_processed ) {
			return;
		}

$kit_data_array['space_between_widgets'] = Utils::update_space_between_widgets_values( $kit_data_array['space_between_widgets'] );

update_post_meta( (int) $kit_id, '_elementor_page_settings', $kit_data_array );
	}

public static function remove_remote_info_api_data() {
		global $wpdb;

$key = Api::TRANSIENT_KEY_PREFIX;

return $wpdb->query( "DELETE FROM {$wpdb->options} WHERE option_name LIKE '{$key}%';" ); // phpcs:ignore
	}

/**
	 * @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 );
	}

public static function get_post_ids_by_element_type( $updater, string $element_type ): array {
		global $wpdb;

return $updater->query_col(
			'SELECT `post_id`
					FROM `' . $wpdb->postmeta . '`
					WHERE `meta_key` = "_elementor_data"
					AND `meta_value` LIKE \'%"elType":"' . $element_type . '"%\';'
		);
	}
	/**
	 * @param $data
	 *
	 * @return array|mixed
	 */
	private static function iterate_containers( $data ) {
		return Plugin::$instance->db->iterate_data(
			$data, function ( $element ) {

if ( 'container' !== $element['elType'] || ! isset( $element['elements'] ) ) {
					return $element;
				}

$element = self::maybe_convert_to_inner_container( $element );
				$element = self::maybe_convert_to_grid_container( $element );
				return Container::slider_to_gaps_converter( $element );
			}
		);
	}

/**
	 * @param $element
	 *
	 * @return array
	 */
	private static function maybe_convert_to_inner_container( $element ) {
		foreach ( $element['elements'] as &$inner_element ) {
			if ( 'container' === $inner_element['elType'] && ! $inner_element['isInner'] ) {
				$inner_element['isInner'] = true;
			}
		}

return $element;
	}

/**
	 * @param $element
	 *
	 * @return array
	 */
	private static function maybe_convert_to_grid_container( $element ) {
		$is_grid_container = isset( $element['settings']['container_type'] ) && 'grid' === $element['settings']['container_type'];
		if ( 'container' !== $element['elType'] || empty( $element['settings'] ) || ! $is_grid_container ) {
			return $element;
		}

$element['settings']['presetTitle'] = 'Grid';
		$element['settings']['presetIcon'] = 'eicon-container-grid';

return $element;
	}

/**
	 * @param $post_id
	 * @param $data
	 *
	 * @return void
	 */
	private static function save_updated_document( $post_id, $data ) {
		$json_value = wp_slash( wp_json_encode( $data ) );

update_metadata( 'post', $post_id, '_elementor_data', $json_value );
	}
}