<?php
/**
 * Shared Divi Powers admin dashboard and Feature Manager.
 *
 * @package DiviPowers
 */

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

final class Divi_Powers_Admin {
	private const ADMIN_OVERVIEWS_META = '_divi_powers_dismissed_admin_overviews';
	private const ADMIN_OVERVIEWS_NONCE = 'divi_powers_admin_overview';

	/** @var Divi_Powers_Plugin */
	private $plugin;

	public function __construct( Divi_Powers_Plugin $plugin ) {
		$this->plugin = $plugin;
	}

	public function register() {
		add_action( 'admin_menu', array( $this, 'add_menu' ) );
		add_action( 'admin_init', array( $this, 'register_settings' ) );
		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );
		add_action( 'wp_ajax_divi_powers_save_settings', array( $this, 'ajax_save_settings' ) );
		add_action( 'wp_ajax_divi_powers_save_admin_overview_state', array( $this, 'ajax_save_admin_overview_state' ) );
		add_filter( 'admin_body_class', array( $this, 'filter_admin_body_class' ) );
	}

	public function add_menu() {
		add_menu_page(
			__( '5D Powers for Divi', '5d-powers-for-divi' ),
			__( '5D Powers for Divi', '5d-powers-for-divi' ),
			'manage_options',
			'divi-powers',
			array( $this, 'render_page' ),
			'dashicons-superhero-alt',
			58
		);

		if ( ! Divi_Powers_Plugin::is_pro_active() ) {
			add_submenu_page(
				'divi-powers',
				__( '5D Powers for Divi Pro', '5d-powers-for-divi' ),
				__( 'Upgrade to Pro', '5d-powers-for-divi' ),
				'manage_options',
				'divi-powers-upgrade',
				array( $this, 'render_upgrade_page' )
			);
		}
	}

	public function register_settings() {
		register_setting(
			'divi_powers_settings_group',
			Divi_Powers_Plugin::OPTION_KEY,
			array(
				'type'              => 'array',
				'sanitize_callback' => array( $this, 'sanitize_settings' ),
				'default'           => Divi_Powers_Plugin::defaults(),
			)
		);
	}

	/** Preserve dormant add-on values while updating every currently registered switch. */
	public function sanitize_settings( $input ) {
		$input    = is_array( $input ) ? $input : array();
		$current  = get_option( Divi_Powers_Plugin::OPTION_KEY, array() );
		$current  = is_array( $current ) ? $current : array();
		$defaults = Divi_Powers_Plugin::defaults();

		foreach ( array_keys( $defaults ) as $key ) {
			$current[ $key ] = empty( $input[ $key ] ) ? 0 : 1;
		}

		return $current;
	}

	public function enqueue_assets( $hook_suffix ) {
		unset( $hook_suffix );
		$page = isset( $_GET['page'] ) ? sanitize_key( wp_unslash( $_GET['page'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended

		if ( current_user_can( 'manage_options' ) ) {
			wp_enqueue_style(
				'divi-powers-admin-navigation',
				DIVI_POWERS_URL . 'assets/css/admin-navigation.css',
				array(),
				DIVI_POWERS_VERSION
			);
			wp_enqueue_script(
				'divi-powers-admin-navigation',
				DIVI_POWERS_URL . 'assets/js/admin-navigation.js',
				array(),
				DIVI_POWERS_VERSION,
				true
			);
			wp_localize_script(
				'divi-powers-admin-navigation',
				'DiviPowersProductNav',
				array(
					'isProductPage'          => 0 === strpos( $page, 'divi-powers' ),
					'pageSlug'               => $page,
					'moreLabel'              => __( 'More', '5d-powers-for-divi' ),
					'allPowersLabel'         => __( 'All powers', '5d-powers-for-divi' ),
					'searchLabel'            => __( 'Search powers', '5d-powers-for-divi' ),
					'searchPlaceholder'      => __( 'Search by name or purpose…', '5d-powers-for-divi' ),
					'allLabel'               => __( 'All', '5d-powers-for-divi' ),
					'enabledLabel'           => __( 'Enabled', '5d-powers-for-divi' ),
					'disabledLabel'          => __( 'Disabled', '5d-powers-for-divi' ),
					'openSettingsLabel'      => __( 'Open settings', '5d-powers-for-divi' ),
					'noResultsLabel'         => __( 'No powers match those filters.', '5d-powers-for-divi' ),
					'powerSingularLabel'     => __( 'power', '5d-powers-for-divi' ),
					'powerPluralLabel'       => __( 'powers', '5d-powers-for-divi' ),
					'dismissedOverviews'     => 0 === strpos( $page, 'divi-powers' ) ? $this->dismissed_admin_overviews() : array(),
					'overviewNonce'          => wp_create_nonce( self::ADMIN_OVERVIEWS_NONCE ),
					'ajaxUrl'                => admin_url( 'admin-ajax.php' ),
					'hideOverviewLabel'      => __( 'Hide this overview', '5d-powers-for-divi' ),
					'showOverviewLabel'      => __( 'Show overview', '5d-powers-for-divi' ),
					'overviewHiddenLabel'    => __( 'overview hidden', '5d-powers-for-divi' ),
					'overviewSaveErrorLabel' => __( 'The overview preference could not be saved. Try again.', '5d-powers-for-divi' ),
					'groups'                  => $this->admin_groups(),
					'featureRoutes'           => $this->feature_routes(),
				)
			);
		}

		if ( 0 !== strpos( $page, 'divi-powers' ) ) {
			return;
		}

		wp_enqueue_style(
			'divi-powers-admin',
			DIVI_POWERS_URL . 'assets/css/admin.css',
			array(),
			DIVI_POWERS_VERSION
		);

		wp_enqueue_script(
			'divi-powers-confirmation-dialog',
			DIVI_POWERS_URL . 'assets/js/confirmation-dialog.js',
			array(),
			DIVI_POWERS_VERSION,
			true
		);
		wp_localize_script(
			'divi-powers-confirmation-dialog',
			'DiviPowersDialogConfig',
			array(
				'eyebrow'      => __( 'Please confirm', '5d-powers-for-divi' ),
				'title'        => __( 'Continue with this action?', '5d-powers-for-divi' ),
				'inputLabel'   => __( 'New value', '5d-powers-for-divi' ),
				'cancelLabel'  => __( 'Cancel', '5d-powers-for-divi' ),
				'confirmLabel' => __( 'Continue', '5d-powers-for-divi' ),
			)
		);

		wp_enqueue_script(
			'divi-powers-admin-notices',
			DIVI_POWERS_URL . 'assets/js/admin-notices.js',
			array( 'wp-i18n' ),
			DIVI_POWERS_VERSION,
			true
		);
		wp_set_script_translations( 'divi-powers-admin-notices', '5d-powers-for-divi' );

		wp_enqueue_script(
			'divi-powers-admin-autosave',
			DIVI_POWERS_URL . 'assets/js/admin-autosave.js',
			array( 'wp-i18n' ),
			DIVI_POWERS_VERSION,
			true
		);
		wp_set_script_translations( 'divi-powers-admin-autosave', '5d-powers-for-divi' );

		wp_add_inline_script(
			'divi-powers-admin-autosave',
			'window.DiviPowersAdminAutosave = ' . wp_json_encode(
				array(
					'ajaxUrl'          => admin_url( 'admin-ajax.php' ),
					'powersNonce'      => wp_create_nonce( 'divi_powers_save_settings' ),
					'savingText'       => __( 'Saving…', '5d-powers-for-divi' ),
					'savedText'        => __( 'Saved', '5d-powers-for-divi' ),
					'errorText'        => __( 'Could not save. Please try again.', '5d-powers-for-divi' ),
				)
			),
			'before'
		);
	}

	/** Prevent a flash of the flat menu before the accessible organizer runs. */
	public function filter_admin_body_class( $classes ) {
		if ( ! current_user_can( 'manage_options' ) ) {
			return $classes;
		}

		$classes = trim( (string) $classes );
		if ( false === strpos( ' ' . $classes . ' ', ' dp-admin-navigation-pending ' ) ) {
			$classes .= ( '' === $classes ? '' : ' ' ) . 'dp-admin-navigation-pending';
		}

		$page = isset( $_GET['page'] ) ? sanitize_key( wp_unslash( $_GET['page'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
		if ( 0 === strpos( $page, 'divi-powers' ) && false === strpos( ' ' . $classes . ' ', ' dp-admin-product-page ' ) ) {
			$classes .= ' dp-admin-product-page';
		}

		return $classes;
	}

	/** Persist one administrator's collapsed/expanded overview preference. */
	public function ajax_save_admin_overview_state() {
		check_ajax_referer( self::ADMIN_OVERVIEWS_NONCE, 'nonce' );

		if ( ! current_user_can( 'manage_options' ) ) {
			wp_send_json_error( array( 'message' => __( 'You do not have permission to change this admin preference.', '5d-powers-for-divi' ) ), 403 );
		}

		$section = isset( $_POST['section'] ) ? sanitize_key( wp_unslash( $_POST['section'] ) ) : '';
		if ( ! $this->valid_admin_overview_key( $section ) ) {
			wp_send_json_error( array( 'message' => __( 'That overview section is not valid.', '5d-powers-for-divi' ) ), 400 );
		}

		$collapsed = isset( $_POST['collapsed'] ) && '1' === sanitize_text_field( wp_unslash( $_POST['collapsed'] ) );
		$dismissed = $this->dismissed_admin_overviews();
		if ( $collapsed ) {
			$dismissed[] = $section;
			$dismissed   = array_slice( array_values( array_unique( $dismissed ) ), 0, 60 );
		} else {
			$dismissed = array_values( array_diff( $dismissed, array( $section ) ) );
		}

		sort( $dismissed );
		update_user_meta( get_current_user_id(), self::ADMIN_OVERVIEWS_META, $dismissed );
		wp_send_json_success( array( 'dismissed' => $dismissed ) );
	}

	/** Return the current administrator's saved overview identifiers. */
	private function dismissed_admin_overviews() {
		$saved  = get_user_meta( get_current_user_id(), self::ADMIN_OVERVIEWS_META, true );
		$saved  = is_array( $saved ) ? $saved : array();
		$output = array();

		foreach ( $saved as $section ) {
			$section = sanitize_key( (string) $section );
			if ( $this->valid_admin_overview_key( $section ) ) {
				$output[] = $section;
			}
		}

		return array_values( array_unique( $output ) );
	}

	/** Keep stored overview keys scoped to known Divi Powers admin routes. */
	private function valid_admin_overview_key( $section ) {
		return is_string( $section )
			&& strlen( $section ) <= 120
			&& 1 === preg_match( '/^divi-powers(?:-[a-z0-9-]+)?--[a-z0-9_-]+$/', $section );
	}

	/** Shared taxonomy for the toolbar, WordPress submenu, and Feature Manager. */
	private function admin_groups() {
		$groups = array(
			array(
				'key'         => 'build',
				'label'       => __( 'Build', '5d-powers-for-divi' ),
				'title'       => __( 'Build & Design', '5d-powers-for-divi' ),
				'icon'        => '✦',
				'description' => __( 'Create engaging Divi pages, reusable layouts, interactions, and funnels.', '5d-powers-for-divi' ),
				'items'       => array( 'divi-powers-getting-started', 'divi-powers-plus-funnel', 'divi-powers-design-library' ),
				'features'    => array( 'dismissible', 'trigger_target', 'content_toggle', 'motion_3d', 'media_scroller', 'design_library', 'builder_bridge', 'builder_drawer_fallback', 'plus_funnel' ),
			),
			array(
				'key'         => 'sell',
				'label'       => __( 'Sell', '5d-powers-for-divi' ),
				'title'       => __( 'Commerce & Checkout', '5d-powers-for-divi' ),
				'icon'        => '◆',
				'description' => __( 'Improve checkout, guide customers to the right products, and control cart and order behavior.', '5d-powers-for-divi' ),
				'items'       => array( 'divi-powers-plus-checkout', 'divi-powers-commerce-utilities' ),
				'features'    => array( 'commerce_utilities', 'plus_checkout' ),
			),
			array(
				'key'         => 'optimize',
				'label'       => __( 'Optimize', '5d-powers-for-divi' ),
				'title'       => __( 'Optimize & Grow', '5d-powers-for-divi' ),
				'icon'        => '↗',
				'description' => __( 'Connect your marketing tools and learn what helps customers complete a purchase.', '5d-powers-for-divi' ),
				'items'       => array(),
				'features'    => array( 'mailchimp_tags' ),
			),
			array(
				'key'         => 'members',
				'label'       => __( 'Members', '5d-powers-for-divi' ),
				'title'       => __( 'Members & Access', '5d-powers-for-divi' ),
				'icon'        => '◉',
				'description' => __( 'Personalize pages and navigation for signed-in customers and members.', '5d-powers-for-divi' ),
				'items'       => array(),
				'features'    => array( 'current_user_shortcodes' ),
			),
			array(
				'key'         => 'site',
				'label'       => __( 'Site', '5d-powers-for-divi' ),
				'title'       => __( 'Site Experience', '5d-powers-for-divi' ),
				'icon'        => '▣',
				'description' => __( 'Add useful editing shortcuts and improve everyday site management.', '5d-powers-for-divi' ),
				'items'       => array(),
				'features'    => array( 'admin_bar_auto_hide', 'admin_bar_links', 'duplicate_content' ),
			),
			array(
				'key'         => 'account',
				'label'       => __( 'Account', '5d-powers-for-divi' ),
				'title'       => __( 'Connections & Account', '5d-powers-for-divi' ),
				'icon'        => '⚙',
				'description' => __( 'Connect an AI assistant, manage optional services, support, and your product edition.', '5d-powers-for-divi' ),
				'items'       => array( 'divi-powers-ai-connector', 'divi-powers-support', 'divi-powers-upgrade' ),
				'features'    => array( 'ai_connection', 'cloud_catalog', 'model_registry' ),
			),
		);

		$groups = apply_filters( 'divi_powers_admin_groups', $groups );
		return is_array( $groups ) ? array_values( $groups ) : array();
	}

	/** Destination URLs for Powers with their own settings workspace. */
	private function feature_routes() {
		$routes = array(
			'cloud_catalog'      => admin_url( 'admin.php?page=divi-powers-design-library' ),
			'model_registry'     => admin_url( 'admin.php?page=divi-powers-ai-connector' ),
			'ai_connection'      => admin_url( 'admin.php?page=divi-powers-ai-connector' ),
			'design_library'     => admin_url( 'admin.php?page=divi-powers-design-library' ),
			'builder_bridge'     => admin_url( 'admin.php?page=divi-powers-ai-connector' ),
			'commerce_utilities' => admin_url( 'admin.php?page=divi-powers-commerce-utilities' ),
			'plus_checkout'      => admin_url( 'admin.php?page=divi-powers-plus-checkout' ),
			'plus_funnel'        => admin_url( 'admin.php?page=divi-powers-plus-funnel' ),
		);

		$routes = apply_filters( 'divi_powers_feature_routes', $routes );
		return is_array( $routes ) ? $routes : array();
	}

	public function render_page() {
		if ( ! current_user_can( 'manage_options' ) ) {
			return;
		}

		$settings       = $this->plugin->settings();
		$features       = Divi_Powers_Plugin::feature_definitions();
		$divi_available = function_exists( 'et_builder_d5_enabled' );
		$divi_5_enabled = $divi_available && et_builder_d5_enabled();
		$integration_ok = class_exists( '\ET\Builder\VisualBuilder\Assets\PackageBuildManager' );
		$setup          = class_exists( 'Divi_Powers_Onboarding' ) ? Divi_Powers_Onboarding::setup_summary() : array( 'percent' => 0, 'done' => 0, 'total' => 3, 'starter_ok' => false );
		$setup_complete = ! empty( $setup['total'] ) && (int) $setup['done'] >= (int) $setup['total'];
		$cards          = $this->dashboard_cards( $setup );
		$highlights     = $this->edition_highlights();
		$statuses       = $this->status_definitions( $features, $settings, $divi_available, $divi_5_enabled, $integration_ok );
		$next_step      = $this->next_step();
		?>
		<div class="wrap divi-powers-admin">
			<div class="divi-powers-hero">
				<div>
					<span class="divi-powers-eyebrow"><?php echo esc_html( Divi_Powers_Plugin::is_pro_active() ? __( 'DESIGN, FUNNELS & COMMERCE FOR DIVI', '5d-powers-for-divi' ) : __( '5D POWERS FOR DIVI · FREE', '5d-powers-for-divi' ) ); ?></span>
					<h1><?php echo esc_html( Divi_Powers_Plugin::product_name() ); ?></h1>
					<p><?php echo esc_html( Divi_Powers_Plugin::is_pro_active() ? __( 'Build engaging pages, sales funnels, and customer experiences with the Divi elements you already use.', '5d-powers-for-divi' ) : __( 'Add useful design, funnel, checkout, and site features to Divi without replacing the tools you already use.', '5d-powers-for-divi' ) ); ?></p>
				</div>
				<span class="divi-powers-version"><?php echo esc_html( Divi_Powers_Plugin::version_label() ); ?></span>
			</div>

			<?php settings_errors(); ?>

			<?php $this->render_edition_highlights( $highlights ); ?>

			<section class="divi-powers-product-home<?php echo $setup_complete ? ' is-setup-complete' : ''; ?>">
				<?php if ( ! $setup_complete ) : ?>
					<div class="divi-powers-product-home__progress">
						<div>
							<h2><?php esc_html_e( 'Setup progress', '5d-powers-for-divi' ); ?></h2>
							<p><?php echo esc_html( sprintf( 
								/* translators: 1: completed setup steps, 2: total setup steps. */
								__( '%1$d of %2$d essential setup steps are complete.', '5d-powers-for-divi' ), (int) $setup['done'], (int) $setup['total'] ) ); ?></p>
						</div>
						<div class="divi-powers-product-home__meter"><div class="divi-powers-product-home__track"><span style="width:<?php echo esc_attr( (int) $setup['percent'] ); ?>%"></span></div><strong><?php echo esc_html( (int) $setup['percent'] ); ?>%</strong><a class="button button-primary" href="<?php echo esc_url( admin_url( 'admin.php?page=divi-powers-getting-started' ) ); ?>"><?php esc_html_e( 'Continue setup', '5d-powers-for-divi' ); ?></a></div>
					</div>
				<?php endif; ?>
				<div class="divi-powers-product-home__cards">
					<?php foreach ( $cards as $index => $card ) : ?>
						<article class="<?php echo ! empty( $card['class'] ) ? esc_attr( $card['class'] ) : ''; ?>">
							<div class="dp-dashboard-card__top">
								<span class="dp-dashboard-card__number"><?php echo esc_html( isset( $card['number'] ) ? $card['number'] : $index + 1 ); ?></span>
								<?php if ( ! empty( $card['badge'] ) ) : ?>
									<em class="dp-tier-badge dp-tier-badge--<?php echo esc_attr( ! empty( $card['badge_tone'] ) ? sanitize_key( $card['badge_tone'] ) : 'lite' ); ?>"><?php echo esc_html( $card['badge'] ); ?></em>
								<?php endif; ?>
							</div>
							<h3><?php echo esc_html( $card['title'] ); ?></h3>
							<p><?php echo esc_html( $card['description'] ); ?></p>
							<a href="<?php echo esc_url( $card['url'] ); ?>"><?php echo esc_html( $card['link'] ); ?></a>
						</article>
					<?php endforeach; ?>
				</div>
			</section>

			<div class="divi-powers-layout">
				<form action="options.php" method="post" class="divi-powers-panel" data-divi-powers-autosave-form="powers">
					<?php settings_fields( 'divi_powers_settings_group' ); ?>
					<div class="divi-powers-panel-header">
						<h2><?php esc_html_e( 'Feature Manager', '5d-powers-for-divi' ); ?></h2>
						<p><?php esc_html_e( 'Turn features on or off. Changes save automatically.', '5d-powers-for-divi' ); ?></p>
						<span class="divi-powers-autosave-status" aria-live="polite"></span>
					</div>

					<?php foreach ( $features as $slug => $feature ) : ?>
						<?php $this->feature_card( $slug, $feature, ! empty( $settings[ $slug ] ) ); ?>
					<?php endforeach; ?>

					<?php submit_button( __( 'Save changes', '5d-powers-for-divi' ) ); ?>
				</form>

				<aside class="divi-powers-panel divi-powers-status">
					<div class="divi-powers-panel-header">
						<h2><?php esc_html_e( 'System Status', '5d-powers-for-divi' ); ?></h2>
						<p><?php esc_html_e( 'Check that Divi and the features you want to use are ready.', '5d-powers-for-divi' ); ?></p>
					</div>

					<?php foreach ( $statuses as $status ) : ?>
						<?php $this->status_row( $status['label'], ! empty( $status['ready'] ), isset( $status['negative'] ) ? $status['negative'] : __( 'Not detected', '5d-powers-for-divi' ) ); ?>
					<?php endforeach; ?>

					<div class="divi-powers-next-step">
						<strong><?php echo esc_html( $next_step['title'] ); ?></strong>
						<p><?php echo esc_html( $next_step['description'] ); ?></p>
						<p><a class="button button-primary" href="<?php echo esc_url( $next_step['url'] ); ?>"><?php echo esc_html( $next_step['button'] ); ?></a></p>
					</div>
				</aside>
			</div>
		</div>
		<?php
	}

	/** Save Feature Manager changes without requiring a full options-page submit. */
	public function ajax_save_settings() {
		if ( ! current_user_can( 'manage_options' ) ) {
			wp_send_json_error( array( 'message' => __( 'You do not have permission to change 5D Powers for Divi settings.', '5d-powers-for-divi' ) ), 403 );
		}

		$nonce = isset( $_POST['nonce'] ) ? sanitize_text_field( wp_unslash( $_POST['nonce'] ) ) : '';
		if ( ! wp_verify_nonce( $nonce, 'divi_powers_save_settings' ) ) {
			wp_send_json_error( array( 'message' => __( 'Your settings session has expired. Refresh the page and try again.', '5d-powers-for-divi' ) ), 403 );
		}

		$option_key = Divi_Powers_Plugin::OPTION_KEY;
		$input      = isset( $_POST[ $option_key ] ) && is_array( $_POST[ $option_key ] ) ? wp_unslash( $_POST[ $option_key ] ) : array(); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Sanitized field-by-field by sanitize_settings() immediately below.
		$settings   = $this->sanitize_settings( $input );

		update_option( $option_key, $settings );
		wp_send_json_success( array( 'settings' => $settings ) );
	}


	private function edition_highlights() {
		$highlights = array(
			'tone'        => 'lite',
			'eyebrow'     => __( 'INCLUDED WITH FREE', '5d-powers-for-divi' ),
			'title'       => __( 'Unlimited basic funnels are included with Free.', '5d-powers-for-divi' ),
			'description' => __( 'Create funnels with editable Divi pages, WooCommerce checkout, and basic activity reporting. Upgrade to Pro when you need advanced funnel management, testing, and reporting.', '5d-powers-for-divi' ),
			'items'       => array(
				__( 'Commerce Utilities', '5d-powers-for-divi' ),
				__( 'Three Checkout Layouts', '5d-powers-for-divi' ),
				__( 'Unlimited Basic Funnels', '5d-powers-for-divi' ),
				__( 'Basic Funnel Activity', '5d-powers-for-divi' ),
			),
			'url'         => admin_url( 'admin.php?page=divi-powers-plus-funnel' ),
			'link'        => __( 'Open Free funnels', '5d-powers-for-divi' ),
		);

		$highlights = apply_filters( 'divi_powers_edition_highlights', $highlights );
		return is_array( $highlights ) ? $highlights : array();
	}

	private function render_edition_highlights( $highlights ) {
		if ( empty( $highlights['title'] ) ) {
			return;
		}

		$tone  = ! empty( $highlights['tone'] ) ? sanitize_key( $highlights['tone'] ) : 'lite';
		$items = ! empty( $highlights['items'] ) && is_array( $highlights['items'] ) ? $highlights['items'] : array();
		?>
		<section class="dp-edition-highlight dp-edition-highlight--<?php echo esc_attr( $tone ); ?>">
			<div class="dp-edition-highlight__copy">
				<?php if ( ! empty( $highlights['eyebrow'] ) ) : ?><span><?php echo esc_html( $highlights['eyebrow'] ); ?></span><?php endif; ?>
				<h2><?php echo esc_html( $highlights['title'] ); ?></h2>
				<?php if ( ! empty( $highlights['description'] ) ) : ?><p><?php echo esc_html( $highlights['description'] ); ?></p><?php endif; ?>
			</div>
			<?php if ( $items ) : ?>
				<div class="dp-edition-highlight__features">
					<?php foreach ( $items as $item ) : ?><strong><?php echo esc_html( $item ); ?></strong><?php endforeach; ?>
				</div>
			<?php endif; ?>
			<?php if ( ! empty( $highlights['url'] ) && ! empty( $highlights['link'] ) ) : ?>
				<a class="button<?php echo 'pro' === $tone ? ' button-primary' : ''; ?>" href="<?php echo esc_url( $highlights['url'] ); ?>"><?php echo esc_html( $highlights['link'] ); ?> →</a>
			<?php endif; ?>
		</section>
		<?php
	}

	private function dashboard_cards( $setup ) {
		$cards = array(
			array(
				'number'      => '1',
				'title'       => __( 'See the features on a working page', '5d-powers-for-divi' ),
				'description' => __( 'Install the sample page, try its interactive examples, and open it in Divi to see how each one is configured.', '5d-powers-for-divi' ),
				'url'         => admin_url( 'admin.php?page=divi-powers-getting-started' ),
				'link'        => ! empty( $setup['starter_ok'] ) ? __( 'Review starter page →', '5d-powers-for-divi' ) : __( 'Install starter page →', '5d-powers-for-divi' ),
			),
			array(
				'number'      => '2',
				'title'       => __( 'Add a ready-made Divi design', '5d-powers-for-divi' ),
				'description' => __( 'Choose a page, section, row, or module and add it directly to your Divi Library.', '5d-powers-for-divi' ),
				'url'         => admin_url( 'admin.php?page=divi-powers-design-library' ),
				'link'        => __( 'Open Design Library →', '5d-powers-for-divi' ),
			),
			array(
				'number'      => '3',
				'title'       => __( 'Build a sales funnel', '5d-powers-for-divi' ),
				'description' => __( 'Connect editable Divi pages to a WooCommerce product, checkout, thank-you page, and basic activity report.', '5d-powers-for-divi' ),
				'url'         => admin_url( 'admin.php?page=divi-powers-plus-funnel' ),
				'link'        => __( 'Open Free funnels →', '5d-powers-for-divi' ),
				'class'       => 'is-plus-card',
				'badge'       => __( 'INCLUDED FREE', '5d-powers-for-divi' ),
				'badge_tone'  => 'lite',
			),
		);

		$cards = apply_filters( 'divi_powers_dashboard_cards', $cards, $setup );

		return is_array( $cards ) ? $cards : array();
	}

	private function status_definitions( $features, $settings, $divi_available, $divi_5_enabled, $integration_ok ) {
		$statuses = array(
			array( 'label' => __( 'Divi detected', '5d-powers-for-divi' ), 'ready' => $divi_available ),
			array( 'label' => __( 'Divi 5 enabled', '5d-powers-for-divi' ), 'ready' => $divi_5_enabled ),
			array( 'label' => __( 'Divi Builder connection', '5d-powers-for-divi' ), 'ready' => $integration_ok ),
		);

		foreach ( $features as $slug => $feature ) {
			$statuses[] = array(
				'label'    => isset( $feature['status_label'] ) ? $feature['status_label'] : $feature['title'],
				'ready'    => ! empty( $settings[ $slug ] ),
				'negative' => __( 'Disabled', '5d-powers-for-divi' ),
			);
		}

		$statuses = apply_filters( 'divi_powers_status_definitions', $statuses, $settings );

		return is_array( $statuses ) ? $statuses : array();
	}

	private function next_step() {
		$next = array(
			'title'       => __( 'Try the features on a sample page', '5d-powers-for-divi' ),
			'description' => __( 'Install the starter page, try its working examples, and open it in Divi to see how they are configured.', '5d-powers-for-divi' ),
			'url'         => admin_url( 'admin.php?page=divi-powers-getting-started' ),
			'button'      => __( 'Open Getting Started', '5d-powers-for-divi' ),
		);

		$next = apply_filters( 'divi_powers_next_step', $next );

		return is_array( $next ) ? $next : array();
	}

	private function feature_card( $slug, $feature, $enabled ) {
		$edition = isset( $feature['edition'] ) ? sanitize_key( $feature['edition'] ) : 'lite';
		?>
		<label class="divi-powers-feature-card divi-powers-feature-card--<?php echo esc_attr( $edition ); ?>">
			<span class="divi-powers-feature-icon"><?php echo esc_html( isset( $feature['icon'] ) ? $feature['icon'] : '✦' ); ?></span>
			<span class="divi-powers-feature-copy">
				<strong>
					<?php echo esc_html( isset( $feature['title'] ) ? $feature['title'] : $slug ); ?>
					<?php if ( 'lite' !== $edition ) : ?>
						<em class="dp-feature-edition dp-feature-edition--<?php echo esc_attr( $edition ); ?>"><?php echo esc_html( ! empty( $feature['badge'] ) ? $feature['badge'] : sprintf( 
							/* translators: %s: product edition name. */
							__( '%s FEATURE', '5d-powers-for-divi' ), strtoupper( $edition ) ) ); ?></em>
					<?php endif; ?>
				</strong>
				<small><?php echo esc_html( isset( $feature['description'] ) ? $feature['description'] : '' ); ?></small>
			</span>
			<span class="divi-powers-switch">
				<input type="checkbox" name="<?php echo esc_attr( Divi_Powers_Plugin::OPTION_KEY ); ?>[<?php echo esc_attr( $slug ); ?>]" value="1" <?php checked( $enabled ); ?> />
				<span aria-hidden="true"></span>
			</span>
		</label>
		<?php
	}

	private function status_row( $label, $ready, $negative ) {
		?>
		<div class="divi-powers-status-row">
			<span><?php echo esc_html( $label ); ?></span>
			<strong class="<?php echo $ready ? 'is-ready' : 'is-not-ready'; ?>"><?php echo esc_html( $ready ? __( 'Ready', '5d-powers-for-divi' ) : $negative ); ?></strong>
		</div>
		<?php
	}

	/** Customer-facing features used for the Free and Pro comparison. */
	private function upgrade_feature_groups() {
		return array(
			array(
				'title'    => __( 'Design and interactions', '5d-powers-for-divi' ),
				'features' => array(
					array( 'label' => __( 'Dismissible elements', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Triggers, popovers, modals, and drawers', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Content switchers and scroll navigation', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( '3D motion effects', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Logo and image scrollers', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Divi Design Library', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Premium design templates', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'AI assistant connection and Divi 5 draft workflow', '5d-powers-for-divi' ), 'free' => true ),
				),
			),
			array(
				'title'    => __( 'Funnels', '5d-powers-for-divi' ),
				'features' => array(
					array( 'label' => __( 'Unlimited basic funnels', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Basic funnel activity reporting', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Visual funnel and journey builder', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'Custom funnel domains', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'Site and funnel auditor', '5d-powers-for-divi' ), 'free' => false ),
				),
			),
			array(
				'title'    => __( 'Commerce and checkout', '5d-powers-for-divi' ),
				'features' => array(
					array( 'label' => __( 'Three checkout layouts', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Commerce utilities and Buy Now links', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Product-specific checkout journeys', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'Custom checkout fields and rules', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'Cart drawer and mobile cart experiences', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'Order bumps and conditional offers', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'Donations and tips', '5d-powers-for-divi' ), 'free' => false ),
				),
			),
			array(
				'title'    => __( 'Testing and reporting', '5d-powers-for-divi' ),
				'features' => array(
					array( 'label' => __( 'Mailchimp tags', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Split testing', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'Advanced funnel and revenue insights', '5d-powers-for-divi' ), 'free' => false ),
				),
			),
			array(
				'title'    => __( 'Members and site tools', '5d-powers-for-divi' ),
				'features' => array(
					array( 'label' => __( 'Current-user shortcodes', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Admin-bar tools', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Duplicate content', '5d-powers-for-divi' ), 'free' => true ),
					array( 'label' => __( 'Custom login pages', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'Member account tools', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'Conditional menus', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'Advanced mobile menus', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'Preloader', '5d-powers-for-divi' ), 'free' => false ),
					array( 'label' => __( 'Progressive Web App', '5d-powers-for-divi' ), 'free' => false ),
				),
			),
		);
	}

	/** Render matching feature rows inside an upgrade plan card. */
	private function render_upgrade_feature_list( $groups, $is_pro ) {
		foreach ( $groups as $group ) {
			?>
			<section class="dp-tier-features">
				<h3><?php echo esc_html( $group['title'] ); ?></h3>
				<ul>
					<?php foreach ( $group['features'] as $feature ) : ?>
						<?php $included = $is_pro || ! empty( $feature['free'] ); ?>
						<li class="<?php echo esc_attr( $included ? 'is-included' : 'is-unavailable' ); ?>">
							<span class="dp-tier-feature__icon" aria-hidden="true"><?php echo esc_html( $included ? '✓' : '×' ); ?></span>
							<span class="screen-reader-text"><?php echo esc_html( $included ? __( 'Included:', '5d-powers-for-divi' ) : __( 'Not included:', '5d-powers-for-divi' ) ); ?></span>
							<span class="dp-tier-feature__label"><?php echo esc_html( $feature['label'] ); ?></span>
						</li>
					<?php endforeach; ?>
				</ul>
			</section>
			<?php
		}
	}

	public function render_upgrade_page() {
		if ( ! current_user_can( 'manage_options' ) ) {
			return;
		}

		$feature_groups = $this->upgrade_feature_groups();
		?>
		<div class="wrap dp-upgrade-page">
			<header class="dp-upgrade-page__hero">
				<div>
					<span><?php esc_html_e( 'FREE VS. PRO', '5d-powers-for-divi' ); ?></span>
					<h1><?php esc_html_e( 'Compare Free and Pro', '5d-powers-for-divi' ); ?></h1>
					<p><?php esc_html_e( 'See what is included in each version of 5D Powers for Divi. Free includes the core tools for designing pages, adding interactions, building basic funnels, and improving checkout. Pro adds advanced funnel management, commerce, testing, reporting, member, and site tools.', '5d-powers-for-divi' ); ?></p>
				</div>
			</header>

			<section class="dp-tier-grid" aria-label="<?php esc_attr_e( 'Free and Pro feature comparison', '5d-powers-for-divi' ); ?>">
				<article class="dp-tier-card">
					<span><?php esc_html_e( 'FREE', '5d-powers-for-divi' ); ?></span>
					<h2><?php esc_html_e( '5D Powers for Divi Free', '5d-powers-for-divi' ); ?></h2>
					<strong><?php esc_html_e( 'Included with this plugin', '5d-powers-for-divi' ); ?></strong>
					<p class="dp-tier-summary"><?php esc_html_e( 'Core Divi tools for building pages, adding interactive effects, creating basic funnels, and improving WooCommerce checkout.', '5d-powers-for-divi' ); ?></p>
					<?php $this->render_upgrade_feature_list( $feature_groups, false ); ?>
					<span class="button disabled" aria-disabled="true"><?php esc_html_e( 'You are using Free', '5d-powers-for-divi' ); ?></span>
				</article>

				<article class="dp-tier-card is-pro">
					<span><?php esc_html_e( 'PRO', '5d-powers-for-divi' ); ?></span>
					<h2><?php esc_html_e( '5D Powers for Divi Pro', '5d-powers-for-divi' ); ?></h2>
					<strong><?php esc_html_e( 'Annual plans for 1, 5, or unlimited sites', '5d-powers-for-divi' ); ?></strong>
					<p class="dp-tier-summary"><?php esc_html_e( 'Everything in Free, plus advanced funnel, checkout, optimization, membership, and site-management tools.', '5d-powers-for-divi' ); ?></p>
					<?php $this->render_upgrade_feature_list( $feature_groups, true ); ?>
					<a class="button button-primary" href="https://divipowers.com/pricing/" target="_blank" rel="noopener noreferrer"><?php esc_html_e( 'See Pro plans', '5d-powers-for-divi' ); ?></a>
				</article>
			</section>

			<section class="dp-upgrade-boundary">
				<h2><?php esc_html_e( 'Free includes unlimited basic funnels', '5d-powers-for-divi' ); ?></h2>
				<p><?php esc_html_e( 'Create, edit, publish, pause, and rebuild as many basic funnels as you need. Pro adds visual journey mapping, custom domains, advanced checkout tools, split testing, and detailed reporting.', '5d-powers-for-divi' ); ?></p>
			</section>
		</div>
		<?php
	}

}