FM / SetupWizard

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

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

Name	Size	Mode	Actions
RestApi.php	6613	0666	edit dl rm
Screen.php	6543	0666	edit dl rm

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

<?php

namespace WPForms\Lite\SetupWizard;

use WPForms\SetupWizard\Bridge;
use WPForms\SetupWizard\Screen as BaseScreen;
use WPForms\SetupWizard\SetupWizard;

/**
 * Setup Wizard launch screen (Lite).
 *
 * Renders the Welcome screen locally instead of handing off to the SPA
 * sight-unseen: the first screen must live on the WP site (#18533). The
 * consent is persisted through the same StateManager path the SPA's
 * `/update` uses, so the mirror into `wpforms_settings` (and the consent
 * timestamp stamping) stays identical. The CTA's AJAX call also writes
 * `first_screen_completed` into `wizard_settings`, which reaches the SPA on
 * every hydrate, so it survives refreshes and resume handshakes without
 * depending on a session.
 *
 * @since 2.0.1
 */
class Screen extends BaseScreen {

/**
	 * Nonce action for the first-screen AJAX endpoint.
	 *
	 * @since 2.0.1
	 *
	 * @var string
	 */
	private const NONCE_ACTION = 'wpforms_setup_wizard_screen';

/**
	 * Register hooks.
	 *
	 * @since 2.0.1
	 */
	public function hooks(): void {

add_action( 'wp_ajax_wpforms_setup_wizard_screen_update', [ $this, 'handle_update' ] );
	}

/**
	 * Render the local Welcome document instead of the bridge handoff.
	 *
	 * No SPA preflight here: the local screen always renders, and
	 * reachability is checked at CTA time by `handle_update()`, which surfaces
	 * an inline error instead of a redirect.
	 *
	 * @since 2.0.1
	 *
	 * @return bool Whether a real launch happened (as opposed to a fallback redirect).
	 */
	public function launch(): bool {

// A mid-wizard re-entry (Stripe OAuth return) must resume in the SPA, not
		// show the first screen again. A force-step transient with no first-screen
		// marker behind it is stale, so it must not skip the local screen.
		if ( $this->is_resume_request() && $this->has_completed_first_screen() ) {
			return parent::launch();
		}

Bridge::send_standalone_document_headers();

// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
		echo wpforms_render(
			'admin/setup-wizard/shell',
			[
				'view'     => $this->get_view(),
				'config'   => $this->get_js_config(),
				'exit_url' => $this->get_exit_url(),
				'assets'   => $this->get_assets(),
			],
			true
		);

return true;
	}

/**
	 * `wp_ajax` handler: save the Lite Connect consent and return the handoff data.
	 *
	 * @since 2.0.1
	 */
	public function handle_update(): void {

if ( check_ajax_referer( self::NONCE_ACTION, 'nonce', false ) === false ) {
			wp_send_json_error(
				[ 'message' => __( 'Your session has expired. Please reload the page and try again.', 'wpforms-lite' ) ],
				403
			);
		}

if ( ! current_user_can( 'manage_options' ) ) {
			wp_send_json_error( [ 'message' => __( 'You are not allowed to run the Setup Wizard.', 'wpforms-lite' ) ], 403 );
		}

// Every launch path honors the kill switch; the AJAX twin must too, or a site
		// with the wizard switched off still writes settings, mints a wizard token and
		// hands the browser off to the SPA.
		if ( SetupWizard::is_disabled() ) {
			wp_send_json_error( [ 'message' => __( 'The Setup Wizard is disabled on this site.', 'wpforms-lite' ) ], 403 );
		}

if ( ! $this->bridge->is_spa_reachable() ) {
			wp_send_json_error( [ 'message' => __( 'The Setup Wizard is temporarily unavailable. Please try again in a few minutes.', 'wpforms-lite' ) ], 503 );
		}

$is_consent_given = (bool) absint( $_POST['consent'] ?? 0 );

$state           = $this->state_manager->get_state();
		$wizard_settings = (array) ( $state['wizard_settings'] ?? [] );

// The marker records that this run's first screen was rendered locally and
		// acted on. It travels to the SPA inside wizard_settings on every hydrate,
		// so it survives refreshes and resume handshakes without a session.
		$this->state_manager->save_wizard_settings(
			array_merge(
				$wizard_settings,
				[
					'lite-connect-enabled'   => $is_consent_given,
					'first_screen_completed' => true,
				]
			)
		);

wp_send_json_success(
			[
				'handoff' => $this->bridge->get_handoff_data( $this->get_exit_url(), $this->get_restart_url() ),
			]
		);
	}

/**
	 * Whether this wizard run already rendered the local first screen.
	 *
	 * Distinguishes a real mid-wizard re-entry from a stale StripeConnect
	 * force-step transient: that transient is site-wide, lives for an hour and is
	 * only consumed inside the bridge payload filter, so an abandoned OAuth return
	 * leaves it armed for every administrator on the site.
	 *
	 * @since 2.0.1
	 *
	 * @return bool
	 */
	private function has_completed_first_screen(): bool {

$state = $this->state_manager->get_state();

return ! empty( $state['wizard_settings']['first_screen_completed'] );
	}

/**
	 * Render the Welcome view.
	 *
	 * @since 2.0.1
	 *
	 * @return string
	 */
	private function get_view(): string {

// The option holds every answer, this run's included: save_wizard_settings()
		// mirrors the whitelisted keys into wpforms_settings on the same call, so
		// reading wizard_settings first would only ever repeat what is here.
		// The option is read directly, not through wpforms_setting(): that helper
		// resolves with ! empty(), so a stored false comes back as the default and an
		// explicit decline becomes indistinguishable from no answer at all. Absent
		// means never answered, and that defaults to checked.
		$settings = (array) get_option( 'wpforms_settings', [] );
		$stored   = $settings['lite-connect-enabled'] ?? null;

return (string) wpforms_render(
			'admin/setup-wizard/welcome',
			[
				'exit_url'           => $this->get_exit_url(),
				'is_consent_checked' => $stored === null ? true : (bool) $stored,
			],
			true
		);
	}

/**
	 * JS configuration printed into the shell as JSON.
	 *
	 * @since 2.0.1
	 *
	 * @return array
	 */
	private function get_js_config(): array {

return [
			'ajax_url' => admin_url( 'admin-ajax.php' ),
			'nonce'    => wp_create_nonce( self::NONCE_ACTION ),
			'strings'  => [
				'generic_error' => __( 'Something went wrong. Please try again.', 'wpforms-lite' ),
			],
		];
	}

/**
	 * Compiled asset URLs for the shell template.
	 *
	 * @since 2.0.1
	 *
	 * @return array{css: string[], js: string[]}
	 */
	private function get_assets(): array {

$min = wpforms_get_min_suffix();

return [
			'css' => [ WPFORMS_PLUGIN_URL . "assets/lite/css/admin/setup-wizard{$min}.css?ver=" . WPFORMS_VERSION ],
			'js'  => [ WPFORMS_PLUGIN_URL . "assets/lite/js/admin/setup-wizard{$min}.js?ver=" . WPFORMS_VERSION ],
		];
	}
}

cmd: