FM / SetupWizard

/home/techb158/public_html/wp-content/plugins/wpforms-lite/src/SetupWizard/

/home/techb158/public_html/wp-content/plugins/wpforms-lite/src/SetupWizard

Name	Size	Mode	Actions
Service/	-	0755	rm
AbstractStripeConnect.php	6060	0666	edit dl rm
Auth.php	3611	0666	edit dl rm
Bridge.php	6821	0666	edit dl rm
FailedInstallsNotice.php	7592	0666	edit dl rm
RestApi.php	18944	0666	edit dl rm
Screen.php	3745	0666	edit dl rm
SetupWizard.php	13721	0666	edit dl rm
StripeConnect.php	3831	0666	edit dl rm

Edit: /home/techb158/public_html/wp-content/plugins/wpforms-lite/src/SetupWizard/Screen.php (3745B)

<?php

namespace WPForms\SetupWizard;

use WPForms\SetupChecklist\Page;
use WPForms\SetupWizard\Service\StateManager;

/**
 * Setup Wizard launch screen.
 *
 * The seam `SetupWizard::maybe_launch()` delegates the launch tail to. The
 * base implementation keeps the historical behavior: preflight the SPA and
 * either redirect to the Welcome fallback or render the auto-POST bridge.
 * The Lite override renders the local Welcome screen instead (the wizard's
 * first screen must live on the WP site, see #18533).
 *
 * @since 2.0.1
 */
class Screen {

/**
	 * Bridge service.
	 *
	 * @since 2.0.1
	 *
	 * @var Bridge
	 */
	protected $bridge;

/**
	 * State manager service (edition-resolved).
	 *
	 * Unused by the base flow; stored because the constructor is shared with
	 * the Lite override, which persists the Welcome consent through it.
	 *
	 * @since 2.0.1
	 *
	 * @var StateManager
	 */
	protected $state_manager;

/**
	 * Constructor.
	 *
	 * @since 2.0.1
	 *
	 * @param Bridge       $bridge        Bridge service.
	 * @param StateManager $state_manager State manager service.
	 */
	public function __construct( Bridge $bridge, StateManager $state_manager ) {

$this->bridge        = $bridge;
		$this->state_manager = $state_manager;
	}

/**
	 * Register hooks.
	 *
	 * The base flow has none; the Lite override registers its AJAX endpoint.
	 *
	 * @since 2.0.1
	 */
	public function hooks(): void {
	}

/**
	 * Launch the wizard for the current request.
	 *
	 * Never exits; `SetupWizard::maybe_launch()` exits after this returns.
	 *
	 * @since 2.0.1
	 *
	 * @return bool Whether a real launch happened (as opposed to a fallback redirect).
	 */
	public function launch(): bool {

// Preflight: a top-level POST abandons the bridge page, so the only way
		// to recover from an unreachable or erroring SPA is to check it here,
		// before the handoff, and send the user to the Welcome fallback instead.
		if ( ! $this->bridge->is_spa_reachable() ) {
			wp_safe_redirect( $this->get_fallback_url() );

return false;
		}

$this->bridge->render(
			$this->bridge->build_payload( $this->get_exit_url(), $this->get_restart_url() )
		);

return true;
	}

/**
	 * Whether the current launch is a mid-wizard re-entry rather than a first launch.
	 *
	 * The Stripe OAuth round-trip returns the user to wp-admin with the manual
	 * launch argument and a forced-step transient; such a launch must resume
	 * in the SPA, not restart at the first screen.
	 *
	 * @since 2.0.1
	 *
	 * @return bool
	 */
	protected function is_resume_request(): bool {

$is_resume_request = get_transient( StripeConnect::TRANSIENT_FORCE_STEP ) !== false;

/**
		 * Filter whether the current launch is a mid-wizard re-entry rather than a first launch.
		 *
		 * Allows other OAuth-style round-trips to signal a resume without editing this shared class.
		 *
		 * @since 2.0.1
		 *
		 * @param bool $is_resume_request Whether the current launch should resume in the SPA.
		 */
		return (bool) apply_filters( 'wpforms_setup_wizard_screen_is_resume_request', $is_resume_request );
	}

/**
	 * Get the URL the wizard should return the user to on exit.
	 *
	 * @since 2.0.1
	 *
	 * @return string
	 */
	protected function get_exit_url(): string {

return Page::get_url();
	}

/**
	 * Get the URL the wizard should restart from.
	 *
	 * @since 2.0.1
	 *
	 * @return string
	 */
	protected function get_restart_url(): string {

return add_query_arg( SetupWizard::QUERY_ARG, 1, $this->get_exit_url() );
	}

/**
	 * Get the Welcome getting-started URL used as the launch fallback.
	 *
	 * @since 2.0.1
	 *
	 * @return string
	 */
	private function get_fallback_url(): string {

return admin_url( 'index.php?page=wpforms-getting-started' );
	}
}

bridge = $bridge; $this->state_manager = $state_manager; } /** * Register hooks. * * The base flow has none; the Lite override registers its AJAX endpoint. * * @since 2.0.1 */ public function hooks(): void { } /** * Launch the wizard for the current request. * * Never exits; `SetupWizard::maybe_launch()` exits after this returns. * * @since 2.0.1 * * @return bool Whether a real launch happened (as opposed to a fallback redirect). */ public function launch(): bool { // Preflight: a top-level POST abandons the bridge page, so the only way // to recover from an unreachable or erroring SPA is to check it here, // before the handoff, and send the user to the Welcome fallback instead. if ( ! $this->bridge->is_spa_reachable() ) { wp_safe_redirect( $this->get_fallback_url() ); return false; } $this->bridge->render( $this->bridge->build_payload( $this->get_exit_url(), $this->get_restart_url() ) ); return true; } /** * Whether the current launch is a mid-wizard re-entry rather than a first launch. * * The Stripe OAuth round-trip returns the user to wp-admin with the manual * launch argument and a forced-step transient; such a launch must resume * in the SPA, not restart at the first screen. * * @since 2.0.1 * * @return bool */ protected function is_resume_request(): bool { $is_resume_request = get_transient( StripeConnect::TRANSIENT_FORCE_STEP ) !== false; /** * Filter whether the current launch is a mid-wizard re-entry rather than a first launch. * * Allows other OAuth-style round-trips to signal a resume without editing this shared class. * * @since 2.0.1 * * @param bool $is_resume_request Whether the current launch should resume in the SPA. */ return (bool) apply_filters( 'wpforms_setup_wizard_screen_is_resume_request', $is_resume_request ); } /** * Get the URL the wizard should return the user to on exit. * * @since 2.0.1 * * @return string */ protected function get_exit_url(): string { return Page::get_url(); } /** * Get the URL the wizard should restart from. * * @since 2.0.1 * * @return string */ protected function get_restart_url(): string { return add_query_arg( SetupWizard::QUERY_ARG, 1, $this->get_exit_url() ); } /** * Get the Welcome getting-started URL used as the launch fallback. * * @since 2.0.1 * * @return string */ private function get_fallback_url(): string { return admin_url( 'index.php?page=wpforms-getting-started' ); } }