JezK

Edit File: onboarding-progress-manager.php

<?php

namespace Elementor\App\Modules\Onboarding\Storage;

use Elementor\App\Modules\Onboarding\Module;
use Elementor\App\Modules\Onboarding\Storage\Entities\User_Choices;
use Elementor\App\Modules\Onboarding\Storage\Entities\User_Progress;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

class Onboarding_Progress_Manager {

const PROGRESS_OPTION_KEY = 'elementor_onboarding_progress';
	const CHOICES_OPTION_KEY = 'elementor_onboarding_choices';
	const DEFAULT_TOTAL_STEPS = 5;

private static ?Onboarding_Progress_Manager $instance = null;

public static function instance(): Onboarding_Progress_Manager {
		if ( null === self::$instance ) {
			self::$instance = new self();
		}

return self::$instance;
	}

public function get_progress(): User_Progress {
		$data = get_option( self::PROGRESS_OPTION_KEY, [] );

return User_Progress::from_array( $data );
	}

public function save_progress( User_Progress $progress ): User_Progress {
		update_option( self::PROGRESS_OPTION_KEY, $progress->to_array() );

return $progress;
	}

public function update_progress( array $params ): User_Progress {
		$progress = $this->get_progress();

if ( isset( $params['current_step'] ) ) {
			$progress->set_current_step( (int) $params['current_step'] );
		}

if ( isset( $params['completed_steps'] ) ) {
			$progress->set_completed_steps( (array) $params['completed_steps'] );
		}

if ( isset( $params['exit_type'] ) ) {
			$progress->set_exit_type( $params['exit_type'] );
		}

if ( isset( $params['complete_step'] ) ) {
			$step = $params['complete_step'];
			$progress->add_completed_step( $step );

$step_index = $params['step_index'] ?? $progress->get_current_step_index();
			$total_steps = $params['total_steps'] ?? self::DEFAULT_TOTAL_STEPS;
			$next_index = $step_index + 1;

if ( $next_index < $total_steps ) {
				$progress->set_current_step_index( $next_index );
				$progress->set_current_step_id( null );
			}
		}

if ( ! empty( $params['skip_step'] ) ) {
			$step_index = $params['step_index'] ?? $progress->get_current_step_index();
			$total_steps = $params['total_steps'] ?? self::DEFAULT_TOTAL_STEPS;
			$next_index = $step_index + 1;

if ( $next_index < $total_steps ) {
				$progress->set_current_step_index( $next_index );
				$progress->set_current_step_id( null );
			}
		}

if ( isset( $params['start'] ) && $params['start'] ) {
			$progress->set_started_at( current_time( 'timestamp' ) );
			$progress->set_exit_type( null );
		}

if ( isset( $params['complete'] ) && $params['complete'] ) {
			$progress->set_exit_type( 'user_exit' );
			update_option( Module::ONBOARDING_OPTION, Module::VERSION );
		}

if ( isset( $params['user_exit'] ) && $params['user_exit'] ) {
			$progress->set_exit_type( 'user_exit' );
		}

if ( isset( $params['starter_dismissed'] ) && $params['starter_dismissed'] ) {
			$progress->set_starter_dismissed( true );
		}

$progress->set_last_active_timestamp( current_time( 'timestamp' ) );

return $this->save_progress( $progress );
	}

public function get_choices(): User_Choices {
		$data = get_option( self::CHOICES_OPTION_KEY, [] );

return User_Choices::from_array( $data );
	}

public function save_choices( User_Choices $choices ): User_Choices {
		update_option( self::CHOICES_OPTION_KEY, $choices->to_array() );

return $choices;
	}

public function update_choices( array $params ): User_Choices {
		$choices = $this->get_choices();

if ( isset( $params['building_for'] ) ) {
			$choices->set_building_for( $params['building_for'] );
		}

if ( isset( $params['site_about'] ) ) {
			$choices->set_site_about( (array) $params['site_about'] );
		}

if ( isset( $params['experience_level'] ) ) {
			$choices->set_experience_level( $params['experience_level'] );
		}

if ( isset( $params['theme_selection'] ) ) {
			$choices->set_theme_selection( $params['theme_selection'] );
		}

if ( isset( $params['site_features'] ) ) {
			$choices->set_site_features( (array) $params['site_features'] );
		}

return $this->save_choices( $choices );
	}

public function reset(): void {
		delete_option( self::PROGRESS_OPTION_KEY );
		delete_option( self::CHOICES_OPTION_KEY );
	}

private function __construct() {}
}